fai/chain-studio
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

refactor: rename internal Fai* design system + fai_ helpers to chain
Some checks failed
Security / Security check (push) Failing after 2s
Details

Browse source 
The Studio design system, widgets and helpers carried a Fai* / fai_
prefix (FaiSpace, FaiColors, FaiTheme, FaiLog, 17 fai_*.dart files, the
faiBinary* l10n keys). Studio is the Ch∆In product, so rename them to
Chain* / chain_ — carefully preserving English fail/failure/failed.
Also fix stale references: the 'fai' binary in l10n strings -> 'chain',
FAI_* env vars (FAI_BIN/DATA_DIR/MODULES_DIR/TODAY/BOOTSTRAP_TOKEN) ->
CHAIN_*, fai_platform -> fai_chain, fai_hub -> chain_hub. Vendor
security-hook tooling (FAI_BANNED_TERMS_FILE) + the .fai bundle ext left.
flutter analyze + test: clean (20 passed).

Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
This commit is contained in:
flemming-it 2026-06-16 17:53:17 +02:00
parent 68d23ab7dd
commit 891acd2ba2
52 changed files with 1225 additions and 1225 deletions
Download patch file Download diff file Expand all files Collapse all files

436
lib/widgets/chain_module_sheet.dart Normal file
View file

@ -0,0 +1,436 @@
// ChainModuleSheet — modal bottom-sheet showing detailed module
// info: full capability list, declared permissions, on-disk
// directory. Opened by tapping a module card on the Modules
// page.
import 'package:flutter/material.dart';
import '../data/error_presentation.dart';
import '../data/hub.dart';
import '../l10n/app_localizations.dart';
import '../pages/welcome.dart' show showFaiDoc;
import '../theme/theme.dart';
import '../theme/tokens.dart';
import 'chain_pill.dart';
class ChainModuleSheet extends StatefulWidget {
final String moduleName;
const ChainModuleSheet({super.key, required this.moduleName});
/// Convenience launcher used from the Modules list. Resolves
/// to `true` when the operator uninstalled the module — the
/// caller (Modules page) refreshes its list on that signal.
static Future<bool> show(BuildContext context, String name) async {
final r = await showModalBottomSheet<bool>(
context: context,
backgroundColor: Theme.of(context).colorScheme.surfaceContainer,
isScrollControlled: true,
elevation: 8,
shape: const RoundedRectangleBorder(
borderRadius: BorderRadius.vertical(top: Radius.circular(ChainRadius.md)),
),
builder: (_) => ChainModuleSheet(moduleName: name),
);
return r ?? false;
}
@override
State<ChainModuleSheet> createState() => _FaiModuleSheetState();
}
class _FaiModuleSheetState extends State<ChainModuleSheet> {
late final Future<ModuleDetail> _future;
bool _uninstalling = false;
@override
void initState() {
super.initState();
_future = HubService.instance.moduleInfo(widget.moduleName);
}
Future<void> _confirmAndUninstall(ModuleDetail detail) async {
final l = AppLocalizations.of(context)!;
// When more than one version of the same module is
// installed side-by-side, ask the operator which one to
// remove. The hub's uninstall RPC otherwise falls back to
// "remove the highest version", which is rarely what an
// operator means when they've explicitly kept multiple
// versions around.
final versions = await HubService.instance.installedVersions(detail.name);
if (!mounted) return;
String? targetVersion;
if (versions.length > 1) {
targetVersion = await showDialog<String>(
context: context,
builder: (ctx) => _UninstallVersionPickerDialog(
moduleName: detail.name,
versions: versions,
),
);
if (targetVersion == null || !mounted) return;
}
final displayVersion = targetVersion ?? detail.version;
final ok = await showDialog<bool>(
context: context,
builder: (ctx) => AlertDialog(
title: Text(l.modulesUninstallTitle),
content: Text(l.modulesUninstallBody(detail.name, displayVersion)),
actions: [
TextButton(
onPressed: () => Navigator.pop(ctx, false),
child: Text(l.buttonCancel),
),
FilledButton(
onPressed: () => Navigator.pop(ctx, true),
style: FilledButton.styleFrom(
backgroundColor: Theme.of(ctx).colorScheme.error,
foregroundColor: Theme.of(ctx).colorScheme.onError,
),
child: Text(l.buttonUninstall),
),
],
),
);
if (ok != true || !mounted) return;
setState(() => _uninstalling = true);
try {
final r = await HubService.instance.uninstallModule(
detail.name,
version: targetVersion ?? '',
);
if (!mounted) return;
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(content: Text(l.modulesUninstalledToast(r.name, r.version))),
);
Navigator.pop(context, true);
} catch (e) {
if (!mounted) return;
setState(() => _uninstalling = false);
showFaiErrorSnack(context, 'modules.uninstall', e);
}
}
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
final maxHeight = MediaQuery.of(context).size.height * 0.7;
return ConstrainedBox(
constraints: BoxConstraints(maxHeight: maxHeight),
child: FutureBuilder<ModuleDetail>(
future: _future,
builder: (context, snapshot) {
return Column(
mainAxisSize: MainAxisSize.min,
children: [
_Handle(),
if (snapshot.connectionState == ConnectionState.waiting)
const Padding(
padding: EdgeInsets.all(ChainSpace.xxxl),
child: CircularProgressIndicator(),
)
else if (snapshot.hasError)
Padding(
padding: const EdgeInsets.all(ChainSpace.xl),
child: Text(
AppLocalizations.of(
context,
)!.moduleSheetFailedToLoad(snapshot.error.toString()),
style: theme.textTheme.bodyMedium?.copyWith(
color: theme.colorScheme.error,
),
),
)
else
Flexible(
child: _Body(
detail: snapshot.data!,
uninstalling: _uninstalling,
onUninstall: () => _confirmAndUninstall(snapshot.data!),
),
),
],
);
},
),
);
}
}
class _Handle extends StatelessWidget {
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
return Padding(
padding: const EdgeInsets.symmetric(vertical: ChainSpace.sm),
child: Container(
width: 40,
height: 4,
decoration: BoxDecoration(
color: theme.colorScheme.outlineVariant,
borderRadius: BorderRadius.circular(2),
),
),
);
}
}
class _Body extends StatelessWidget {
final ModuleDetail detail;
final bool uninstalling;
final VoidCallback onUninstall;
const _Body({
required this.detail,
required this.uninstalling,
required this.onUninstall,
});
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
final l = AppLocalizations.of(context)!;
return ListView(
padding: const EdgeInsets.fromLTRB(
ChainSpace.xxl,
ChainSpace.md,
ChainSpace.xxl,
ChainSpace.xxl,
),
shrinkWrap: true,
children: [
Row(
children: [
Text(
detail.name,
style: theme.textTheme.headlineSmall?.copyWith(
fontWeight: FontWeight.w600,
),
),
const SizedBox(width: ChainSpace.md),
ChainPill(
label: 'v${detail.version}',
tone: ChainPillTone.accent,
monospace: true,
),
],
),
const SizedBox(height: ChainSpace.xs),
SelectableText(
detail.directory,
style: ChainTheme.mono(
size: 11,
color: theme.colorScheme.onSurfaceVariant,
),
),
const SizedBox(height: ChainSpace.xl),
_SectionHeader(l.moduleSheetCapabilities),
const SizedBox(height: ChainSpace.sm),
Wrap(
spacing: ChainSpace.xs,
runSpacing: ChainSpace.xs,
children: detail.capabilities
.map(
(c) => ChainPill(
label: c,
tone: ChainPillTone.accent,
monospace: true,
),
)
.toList(),
),
const SizedBox(height: ChainSpace.xl),
Row(
children: [
_SectionHeader(l.moduleSheetPermissions),
const SizedBox(width: 4),
InkWell(
onTap: () => showFaiDoc(context, 'security'),
borderRadius: BorderRadius.circular(8),
child: Padding(
padding: const EdgeInsets.all(4),
child: Icon(
Icons.help_outline,
size: 14,
color: theme.colorScheme.onSurfaceVariant,
),
),
),
],
),
const SizedBox(height: ChainSpace.sm),
if (detail.permissions.isEmpty)
Text(
l.moduleSheetNoPermissions,
style: theme.textTheme.bodySmall?.copyWith(
color: theme.colorScheme.onSurfaceVariant,
fontStyle: FontStyle.italic,
),
)
else
Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: detail.permissions
.map(
(p) => Padding(
padding: const EdgeInsets.symmetric(vertical: 2),
child: Row(
children: [
Icon(
_iconFor(p),
size: 14,
color: theme.colorScheme.onSurfaceVariant,
),
const SizedBox(width: ChainSpace.sm),
SelectableText(
p,
style: ChainTheme.mono(
size: 12,
color: theme.colorScheme.onSurface,
),
),
],
),
),
)
.toList(),
),
const SizedBox(height: ChainSpace.xxl),
Row(
children: [
const Spacer(),
OutlinedButton.icon(
onPressed: uninstalling ? null : onUninstall,
icon: uninstalling
? const SizedBox(
width: 14,
height: 14,
child: CircularProgressIndicator(strokeWidth: 2),
)
: const Icon(Icons.delete_outline, size: 16),
label: Text(
uninstalling
? AppLocalizations.of(context)!.modulesUninstalling
: AppLocalizations.of(context)!.buttonUninstall,
),
style: OutlinedButton.styleFrom(
foregroundColor: theme.colorScheme.error,
side: BorderSide(
color: theme.colorScheme.error.withValues(alpha: 0.5),
),
),
),
],
),
],
);
}
IconData _iconFor(String permission) {
if (permission.startsWith('net:')) return Icons.public;
if (permission.startsWith('fs.read:')) return Icons.folder_open;
if (permission.startsWith('fs.write:')) return Icons.edit_note;
if (permission.startsWith('env:')) return Icons.terminal;
if (permission.startsWith('hub:')) return Icons.shield_outlined;
return Icons.lock_outline;
}
}
/// Modal that asks the operator to pick which installed
/// version to uninstall when more than one version of the same
/// `(provider, name)` is on disk side-by-side. Pops the picked
/// version string, or `null` on cancel.
class _UninstallVersionPickerDialog extends StatefulWidget {
final String moduleName;
final List<String> versions;
const _UninstallVersionPickerDialog({
required this.moduleName,
required this.versions,
});
@override
State<_UninstallVersionPickerDialog> createState() =>
_UninstallVersionPickerDialogState();
}
class _UninstallVersionPickerDialogState
extends State<_UninstallVersionPickerDialog> {
late String _picked;
@override
void initState() {
super.initState();
// Default to the highest version — same fallback the hub
// would pick without an explicit version, so the operator
// can confirm with one click in the common case.
_picked = widget.versions.last;
}
@override
Widget build(BuildContext context) {
final l = AppLocalizations.of(context)!;
return AlertDialog(
title: Text(l.uninstallVersionPickerTitle),
content: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Text(l.uninstallVersionPickerBody(widget.moduleName)),
const SizedBox(height: ChainSpace.md),
RadioGroup<String>(
groupValue: _picked,
onChanged: (val) {
if (val != null) setState(() => _picked = val);
},
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
for (final v in widget.versions)
RadioListTile<String>(
value: v,
title: Text(
'v$v',
style: const TextStyle(fontFamily: 'monospace'),
),
dense: true,
contentPadding: EdgeInsets.zero,
),
],
),
),
],
),
actions: [
TextButton(
onPressed: () => Navigator.pop(context),
child: Text(l.buttonCancel),
),
FilledButton(
onPressed: () => Navigator.pop(context, _picked),
child: Text(l.uninstallVersionPickerContinue),
),
],
);
}
}
class _SectionHeader extends StatelessWidget {
final String text;
const _SectionHeader(this.text);
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
return Text(
text.toUpperCase(),
style: theme.textTheme.labelSmall?.copyWith(
color: theme.colorScheme.onSurfaceVariant,
letterSpacing: 0.6,
fontSize: 10,
),
);
}
}