@jini-ai/ui 0.1.1 → 0.3.0

package/dist/features/a2ui/renderer.js

@@ -0,0 +1,80 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useA2uiSurfaceRoot } from './use-a2ui-surface.js';
+/**
+ * Recursively walks a surface's component map from `componentId` — same shape as
+ * `@jini-ai/chat/react`'s `A2uiSurfaceCard`'s `RenderComponent` (cycle guard via `ancestors`,
+ * degrade-sanely placeholders, never a crash), extended with one more fallback: a catalog type
+ * this switch has no basic-primitive case for is resolved against `registry` before falling back
+ * to the "no renderer" placeholder — that's what lets a `native.data-table`/`shadcn.data-table`
+ * sit inside a `Column` alongside `Text`/`Button`, which the basic-only renderer can't do.
+ *
+ * Basic-type coverage mirrors `A2uiSurfaceCard`'s own (Text/Column/Row/Button) plus `Card`, since
+ * a single-child wrapper is needed to usefully contain one registry component. The remaining
+ * basic types (List/Tabs/Modal/Divider/inputs) are not implemented here either — same honest
+ * "not done yet" as the component this one is modeled on, not a silent gap.
+ */
+function RenderNode({ interpreter, surfaceId, registry, componentId, ancestors, onAction }) {
+    if (ancestors.has(componentId)) {
+        return (_jsxs("span", { className: "a2ui-placeholder a2ui-placeholder-cycle", "data-a2ui-status": "cycle", "data-a2ui-component-id": componentId, children: ["\u27F2 circular reference at \"", componentId, "\""] }));
+    }
+    const surface = interpreter.getSurface(surfaceId);
+    const component = surface?.components.get(componentId);
+    if (!component) {
+        return (_jsxs("span", { className: "a2ui-placeholder a2ui-placeholder-missing", "data-a2ui-status": "missing", "data-a2ui-component-id": componentId, children: ["\u26A0 missing component \"", componentId, "\""] }));
+    }
+    const nextAncestors = new Set(ancestors);
+    nextAncestors.add(componentId);
+    const childProps = { interpreter, surfaceId, registry, ancestors: nextAncestors, onAction };
+    function resolveText(value) {
+        const result = interpreter.resolve(surfaceId, value);
+        if (!result.ok)
+            return `⚠ unresolved (${result.reason})`;
+        return typeof result.value === 'string' ? result.value : JSON.stringify(result.value);
+    }
+    function renderChildList(children) {
+        if (Array.isArray(children)) {
+            return children.map((childId) => _jsx(RenderNode, { componentId: String(childId), ...childProps }, String(childId)));
+        }
+        return (_jsx("span", { className: "a2ui-placeholder", "data-a2ui-status": "unimplemented-template-list", children: "\u26A0 dynamic (template) child lists are not implemented by this port" }));
+    }
+    switch (component.component) {
+        case 'Text':
+            return (_jsx("span", { className: `a2ui-text a2ui-text-${String(component.props.variant)}`, "data-a2ui-component-id": componentId, children: resolveText(component.props.text) }));
+        case 'Column':
+            return (_jsx("div", { className: "a2ui-column", "data-a2ui-component-id": componentId, children: renderChildList(component.props.children) }));
+        case 'Row':
+            return (_jsx("div", { className: "a2ui-row", "data-a2ui-component-id": componentId, children: renderChildList(component.props.children) }));
+        case 'Card':
+            return (_jsx("div", { className: "a2ui-card", "data-a2ui-component-id": componentId, children: _jsx(RenderNode, { ...childProps, componentId: String(component.props.child) }) }));
+        case 'Button':
+            return (_jsx("button", { type: "button", className: `a2ui-button a2ui-button-${String(component.props.variant)}`, "data-a2ui-component-id": componentId, onClick: () => onAction(componentId), children: _jsx(RenderNode, { ...childProps, componentId: String(component.props.child) }) }));
+        default: {
+            const entry = registry.resolveById(component.component);
+            if (!entry) {
+                return (_jsxs("span", { className: "a2ui-placeholder", "data-a2ui-status": "unrenderable-type", "data-a2ui-component-id": componentId, children: ["\u26A0 no renderer yet for component type \"", component.component, "\""] }));
+            }
+            const RegistryComponent = entry.Component;
+            // See module doc: `onRowClick` is the one registry component that exists today
+            // (`native.data-table`/`shadcn.data-table`), not a generic per-component-type feedback
+            // convention — a future non-table provider needs its own decision here, not a guess.
+            return _jsx(RegistryComponent, { ...component.props, onRowClick: () => onAction(componentId) });
+        }
+    }
+}
+/**
+ * Resolves an A2UI surface's full component tree — root and its recursive children — mixing
+ * basic layout/text primitives with `registry`-sourced components. See `RenderNode`'s own doc
+ * for coverage and the fallback resolution order.
+ */
+export function A2uiSurfaceRenderer({ interpreter, surfaceId, registry, fallback }) {
+    const root = useA2uiSurfaceRoot(interpreter, surfaceId);
+    if (!root)
+        return fallback ?? null;
+    const onAction = (componentId) => {
+        const component = interpreter.getSurface(surfaceId)?.components.get(componentId);
+        if (component?.props.action !== undefined)
+            interpreter.buildAction(surfaceId, componentId);
+    };
+    return (_jsx(RenderNode, { interpreter: interpreter, surfaceId: surfaceId, registry: registry, componentId: root.id, ancestors: new Set(), onAction: onAction }));
+}
+//# sourceMappingURL=renderer.js.map

package/dist/features/a2ui/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/features/a2ui/renderer.tsx"],"names":[],"mappings":"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"}

package/dist/features/a2ui/use-a2ui-surface.d.ts

@@ -0,0 +1,13 @@
+import type { A2uiInterpreter, ComponentInstance } from './protocol.js';
+/**
+ * Subscribes a component to one A2UI surface's root, re-rendering whenever the interpreter
+ * notifies (a message applied via `interpreter.applyAgentMessage` touched any surface — the
+ * interpreter has no per-surface subscription granularity, so this hook re-reads `getRoot` on
+ * every notification and lets `useSyncExternalStore`'s reference-equality check skip the render
+ * if this particular surface's root object is unchanged).
+ *
+ * Returns `undefined` when the surface doesn't exist yet, or exists but has no `'root'`
+ * component yet (a legal, "still streaming in" state per the interpreter's own `getRoot` doc).
+ */
+export declare function useA2uiSurfaceRoot(interpreter: A2uiInterpreter, surfaceId: string): ComponentInstance | undefined;
+//# sourceMappingURL=use-a2ui-surface.d.ts.map

package/dist/features/a2ui/use-a2ui-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-a2ui-surface.d.ts","sourceRoot":"","sources":["../../../src/features/a2ui/use-a2ui-surface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAExE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAIjH"}

package/dist/features/a2ui/use-a2ui-surface.js

@@ -0,0 +1,17 @@
+import { useCallback, useSyncExternalStore } from 'react';
+/**
+ * Subscribes a component to one A2UI surface's root, re-rendering whenever the interpreter
+ * notifies (a message applied via `interpreter.applyAgentMessage` touched any surface — the
+ * interpreter has no per-surface subscription granularity, so this hook re-reads `getRoot` on
+ * every notification and lets `useSyncExternalStore`'s reference-equality check skip the render
+ * if this particular surface's root object is unchanged).
+ *
+ * Returns `undefined` when the surface doesn't exist yet, or exists but has no `'root'`
+ * component yet (a legal, "still streaming in" state per the interpreter's own `getRoot` doc).
+ */
+export function useA2uiSurfaceRoot(interpreter, surfaceId) {
+    const subscribe = useCallback((onStoreChange) => interpreter.subscribe(onStoreChange), [interpreter]);
+    const getSnapshot = useCallback(() => interpreter.getRoot(surfaceId), [interpreter, surfaceId]);
+    return useSyncExternalStore(subscribe, getSnapshot);
+}
+//# sourceMappingURL=use-a2ui-surface.js.map

package/dist/features/a2ui/use-a2ui-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-a2ui-surface.js","sourceRoot":"","sources":["../../../src/features/a2ui/use-a2ui-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAG1D;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA4B,EAAE,SAAiB;IAChF,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,aAAyB,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAClH,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAChG,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACtD,CAAC"}

package/dist/features/about/index.d.ts

@@ -0,0 +1,7 @@
+export { ABOUT_UPDATE_KEYS, beginSilentUpdatesWrite, deriveAboutUpdateControl, isAboutUpdateActionDisabled, resolveSilentUpdatesWriteFailure, resolveSilentUpdatesWriteSuccess, } from './rules.js';
+export type { AboutUpdateControl, AboutUpdatePrimaryAction, AboutUpdateTone, AppVersionInfo, SilentUpdatesState, UpdateKind, UpdaterDownloadProgress, UpdaterEnvironment, UpdaterModel, UpdaterState, UpdaterStatus, } from './types.js';
+export { AboutTab } from './react/components/AboutTab.js';
+export type { AboutAppVersionInfo, AboutTabLabels, AboutTabProps } from './react/components/AboutTab.js';
+export { useSilentUpdatesToggle } from './react/hooks/useSilentUpdatesToggle.js';
+export type { UseSilentUpdatesToggleOptions, UseSilentUpdatesToggleResult } from './react/hooks/useSilentUpdatesToggle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/about/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/about/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,YAAY,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/features/about/index.js

@@ -0,0 +1,4 @@
+export { ABOUT_UPDATE_KEYS, beginSilentUpdatesWrite, deriveAboutUpdateControl, isAboutUpdateActionDisabled, resolveSilentUpdatesWriteFailure, resolveSilentUpdatesWriteSuccess, } from './rules.js';
+export { AboutTab } from './react/components/AboutTab.js';
+export { useSilentUpdatesToggle } from './react/hooks/useSilentUpdatesToggle.js';
+//# sourceMappingURL=index.js.map

package/dist/features/about/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/about/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,YAAY,CAAC;AAepB,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/features/about/react/components/AboutTab.d.ts

@@ -0,0 +1,82 @@
+import type { AboutUpdatePrimaryAction, AppVersionInfo, UpdaterModel } from '../../types.js';
+/**
+ * Superset of this feature's own `AppVersionInfo` (`../../types.js`) with
+ * plain desktop-build facts that carry no branching logic of their own —
+ * `channel`/`platform`/`arch` are rendered verbatim and never inspected, so
+ * they don't belong in that type's pure state machine (see
+ * `deriveAboutUpdateControl`, which only reads `version`/`packaged`). All
+ * three are optional: a host with nothing to report for one just omits that
+ * row.
+ */
+export interface AboutAppVersionInfo extends AppVersionInfo {
+    channel?: string;
+    platform?: string;
+    arch?: string;
+}
+export interface AboutTabLabels {
+    versionLabel?: string;
+    runtimeLabel?: string;
+    packagedLabel?: string;
+    developmentLabel?: string;
+    channelLabel?: string;
+    platformLabel?: string;
+    archLabel?: string;
+    releaseLinkLabel?: string;
+    actionFailedLabel?: string;
+    versionUnavailableLabel?: string;
+    silentUpdatesLabel?: string;
+    silentUpdatesHint?: string;
+}
+export interface AboutTabProps {
+    /** `null` while version info hasn't loaded (or isn't obtainable) — renders
+     *  an empty-state card with nothing else, same as the origin. */
+    appVersionInfo: AboutAppVersionInfo | null;
+    /** Kept host-side (e.g. behind the host's own subscription to platform
+     *  update events) and passed down as a controlled prop; this tab never
+     *  mutates it directly. */
+    updaterModel: UpdaterModel;
+    /**
+     * Performs whichever action `deriveAboutUpdateControl` currently offers
+     * (check/download/install/quit). The host owns the real platform bridge
+     * and is responsible for advancing `updaterModel` afterward (its own
+     * subscription is the natural place); this tab only tracks the in-flight
+     * promise to disable the button and surface a generic failure.
+     */
+    onPerformUpdateAction: (action: AboutUpdatePrimaryAction) => Promise<void>;
+    /** Opens the release notes / changelog link. Origin hardcoded this to
+     *  Open Design's own GitHub releases page — host-supplied here instead,
+     *  same convention as `ProviderPreset`/`LocaleOption`. */
+    onOpenReleaseLink: () => void;
+    /** Seed value for the "allow silent updates" toggle. Ignored (and the
+     *  toggle itself not rendered) when `onSilentUpdatePreferenceChange` is
+     *  omitted. Defaults to `false` if the handler is present but this isn't. */
+    allowSilentUpdates?: boolean;
+    /** Persists the "allow silent updates" preference. The toggle is absent
+     *  entirely — not merely disabled — when this is omitted, since there is
+     *  nothing for it to write through. See `useSilentUpdatesToggle` for the
+     *  optimistic-write/rollback/race-safety behaviour behind it. */
+    onSilentUpdatePreferenceChange?: (allow: boolean) => Promise<void>;
+    labels?: AboutTabLabels;
+}
+/**
+ * App version + auto-update panel, plus the "allow silent updates"
+ * preference. Origin: the `activeSection === 'about'` block in
+ * `SettingsDialog.tsx` (~5509-5644) — everything up through the silent-
+ * updates toggle (see this feature's `types.ts`/`rules.ts` for what "already
+ * ported" means here). Diagnostics export and the onboarding-reset button
+ * that OD's dialog stacks below this are separate, single-callback concerns
+ * with no state machine of their own — left for whoever mounts this tab to
+ * compose in (diagnostics export already exists generically as
+ * `ExportDiagnosticsButton`).
+ *
+ * Update-control derivation is this feature's own `deriveAboutUpdateControl`/
+ * `isAboutUpdateActionDisabled`; the silent-updates toggle's optimistic-
+ * write/rollback/race-safety is `useSilentUpdatesToggle`. This component
+ * only renders their results and owns the one thing that's genuinely
+ * render-local: whether an update action this tab itself kicked off is
+ * still in flight.
+ *
+ * @complexity O(1) — fixed-shape render, no iteration.
+ */
+export declare function AboutTab({ appVersionInfo, updaterModel, onPerformUpdateAction, onOpenReleaseLink, allowSilentUpdates, onSilentUpdatePreferenceChange, labels, }: AboutTabProps): import("react").JSX.Element;
+//# sourceMappingURL=AboutTab.d.ts.map

package/dist/features/about/react/components/AboutTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AboutTab.d.ts","sourceRoot":"","sources":["../../../../../src/features/about/react/components/AboutTab.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG7F;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B;qEACiE;IACjE,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C;;+BAE2B;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;;;OAMG;IACH,qBAAqB,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E;;8DAE0D;IAC1D,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B;;iFAE6E;IAC7E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;qEAGiE;IACjE,8BAA8B,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,kBAA0B,EAC1B,8BAA8B,EAC9B,MAAM,GACP,EAAE,aAAa,+BAkJf"}

package/dist/features/about/react/components/AboutTab.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from 'react';
+import { useT } from '../../../i18n/index.js';
+import { deriveAboutUpdateControl, isAboutUpdateActionDisabled } from '../../rules.js';
+import { useSilentUpdatesToggle } from '../hooks/useSilentUpdatesToggle.js';
+/**
+ * App version + auto-update panel, plus the "allow silent updates"
+ * preference. Origin: the `activeSection === 'about'` block in
+ * `SettingsDialog.tsx` (~5509-5644) — everything up through the silent-
+ * updates toggle (see this feature's `types.ts`/`rules.ts` for what "already
+ * ported" means here). Diagnostics export and the onboarding-reset button
+ * that OD's dialog stacks below this are separate, single-callback concerns
+ * with no state machine of their own — left for whoever mounts this tab to
+ * compose in (diagnostics export already exists generically as
+ * `ExportDiagnosticsButton`).
+ *
+ * Update-control derivation is this feature's own `deriveAboutUpdateControl`/
+ * `isAboutUpdateActionDisabled`; the silent-updates toggle's optimistic-
+ * write/rollback/race-safety is `useSilentUpdatesToggle`. This component
+ * only renders their results and owns the one thing that's genuinely
+ * render-local: whether an update action this tab itself kicked off is
+ * still in flight.
+ *
+ * @complexity O(1) — fixed-shape render, no iteration.
+ */
+export function AboutTab({ appVersionInfo, updaterModel, onPerformUpdateAction, onOpenReleaseLink, allowSilentUpdates = false, onSilentUpdatePreferenceChange, labels, }) {
+    const t = useT();
+    const [actionBusy, setActionBusy] = useState(false);
+    const [actionFailed, setActionFailed] = useState(false);
+    const silentUpdates = useSilentUpdatesToggle({ allowSilentUpdates, onSilentUpdatePreferenceChange });
+    const control = useMemo(() => deriveAboutUpdateControl(updaterModel, appVersionInfo ?? null), [updaterModel, appVersionInfo]);
+    const actionDisabled = isAboutUpdateActionDisabled(control, updaterModel, actionBusy);
+    const versionLabel = labels?.versionLabel ?? t('Version');
+    const runtimeLabel = labels?.runtimeLabel ?? t('Runtime');
+    const packagedLabel = labels?.packagedLabel ?? t('Packaged');
+    const developmentLabel = labels?.developmentLabel ?? t('Development build');
+    const channelLabel = labels?.channelLabel ?? t('Channel');
+    const platformLabel = labels?.platformLabel ?? t('Platform');
+    const archLabel = labels?.archLabel ?? t('Architecture');
+    const releaseLinkLabel = labels?.releaseLinkLabel ?? t('View releases');
+    const actionFailedLabel = labels?.actionFailedLabel ?? t('Something went wrong. Try again.');
+    const versionUnavailableLabel = labels?.versionUnavailableLabel ?? t('Version information is unavailable.');
+    const silentUpdatesLabel = labels?.silentUpdatesLabel ?? t('Install updates automatically');
+    const silentUpdatesHint = labels?.silentUpdatesHint ?? t('Apply updates in the background without asking first.');
+    const statusText = t(control.statusKey, control.statusVars);
+    const primaryLabel = control.primaryLabelKey ? t(control.primaryLabelKey) : null;
+    // Origin styled 'download'/'install'/'quit' as primary and left 'check'
+    // plain; simplified to "any actionable state reads as primary, any inert
+    // one reads as ghost" — same visual intent, one fewer hardcoded branch,
+    // and it falls straight out of a field `deriveAboutUpdateControl` already
+    // computes rather than re-deriving OD's three-way action match.
+    const primaryButtonClassName = `jini-button${control.primaryAction ? ' jini-button-primary' : ' jini-button-ghost'}`;
+    // `handlePrimaryAction` only exists when there is an action to run — it is
+    // `undefined` in every state that renders the button disabled-and-inert
+    // (e.g. "downloading"), so there is no dead "disabled but somehow clicked"
+    // branch to guard against inside the handler itself.
+    const { primaryAction } = control;
+    const handlePrimaryAction = primaryAction == null
+        ? undefined
+        : () => {
+            setActionBusy(true);
+            setActionFailed(false);
+            void onPerformUpdateAction(primaryAction).then(() => setActionBusy(false), () => {
+                setActionBusy(false);
+                setActionFailed(true);
+            });
+        };
+    return (_jsxs("section", { className: "jini-settings-section jini-settings-about", children: [appVersionInfo ? (_jsxs("dl", { className: "jini-settings-about-list", children: [_jsxs("div", { className: "jini-settings-about-version-row", children: [_jsxs("div", { className: "jini-settings-about-version-copy", children: [_jsx("dt", { children: versionLabel }), _jsx("span", { className: "jini-settings-about-version-num", children: appVersionInfo.version }), _jsx("dd", { "aria-live": "polite", className: `jini-settings-about-status jini-settings-about-status--${control.statusTone}`, children: statusText })] }), _jsxs("div", { className: "jini-settings-about-actions", children: [primaryLabel ? (_jsx("button", { type: "button", className: primaryButtonClassName, disabled: actionDisabled, onClick: handlePrimaryAction, "data-testid": "about-update-action", children: primaryLabel })) : null, control.showReleaseLink ? (_jsx("button", { type: "button", className: "jini-button jini-button-ghost", onClick: onOpenReleaseLink, "data-testid": "about-release-link", children: releaseLinkLabel })) : null] })] }), actionFailed ? (_jsx("p", { className: "jini-hint jini-settings-about-error", role: "status", children: actionFailedLabel })) : null, _jsxs("div", { children: [_jsx("dt", { children: runtimeLabel }), _jsx("dd", { children: appVersionInfo.packaged === false ? developmentLabel : packagedLabel })] }), appVersionInfo.channel ? (_jsxs("div", { children: [_jsx("dt", { children: channelLabel }), _jsx("dd", { children: appVersionInfo.channel })] })) : null, appVersionInfo.platform ? (_jsxs("div", { children: [_jsx("dt", { children: platformLabel }), _jsx("dd", { children: appVersionInfo.platform })] })) : null, appVersionInfo.arch ? (_jsxs("div", { children: [_jsx("dt", { children: archLabel }), _jsx("dd", { children: appVersionInfo.arch })] })) : null] })) : (_jsx("div", { className: "jini-empty-card", children: versionUnavailableLabel })), onSilentUpdatePreferenceChange ? (_jsx("div", { className: "jini-settings-subsection jini-settings-about-silent-updates", children: _jsxs("label", { className: "jini-settings-about-toggle", children: [_jsx("input", { type: "checkbox", checked: silentUpdates.allowSilentUpdates, disabled: silentUpdates.busy, onChange: (event) => silentUpdates.toggle(event.currentTarget.checked), "data-testid": "about-silent-updates-toggle" }), _jsxs("span", { className: "jini-settings-about-toggle-copy", children: [_jsx("span", { children: silentUpdatesLabel }), _jsx("span", { className: "jini-hint", children: silentUpdatesHint })] })] }) })) : null] }));
+}
+//# sourceMappingURL=AboutTab.js.map

package/dist/features/about/react/components/AboutTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AboutTab.js","sourceRoot":"","sources":["../../../../../src/features/about/react/components/AboutTab.tsx"],"names":[],"mappings":"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"}

package/dist/features/about/react/hooks/useSilentUpdatesToggle.d.ts

@@ -0,0 +1,44 @@
+export interface UseSilentUpdatesToggleOptions {
+    /** Seed value — the host's confirmed setting when this tab mounts. Only
+     *  read on first render; later prop changes do not re-seed local state,
+     *  same "host provides the starting truth, then the tab owns the optimistic
+     *  edit" split as `useMemoryConfig`'s toggles (this tab has no competing
+     *  reload/hydrate flow to reconcile against, so it doesn't need that half
+     *  of that hook's machinery). */
+    allowSilentUpdates: boolean;
+    /** Performs the write. Rejecting means the host could not persist it and
+     *  the toggle must roll back to what it displayed immediately before this
+     *  attempt. `undefined` makes `toggle` a no-op — the consuming component
+     *  typically hides its control entirely in that case (nothing to write
+     *  through), but the hook tolerates it directly rather than pushing a
+     *  "there's nothing to call" guard out to every caller. */
+    onSilentUpdatePreferenceChange: ((allow: boolean) => Promise<void>) | undefined;
+}
+export interface UseSilentUpdatesToggleResult {
+    allowSilentUpdates: boolean;
+    busy: boolean;
+    toggle: (next: boolean) => void;
+}
+/**
+ * Optimistic write for the "allow silent updates" preference, safe under
+ * overlapping toggles. Origin: `SettingsDialog.tsx`'s inline handler
+ * (~5583-5644), which pairs a write-token ref with an optimistic set and a
+ * rollback to the pre-write value.
+ *
+ * The token/staleness half of that mechanism is `createAsyncCommitGuard`
+ * (already in `features/memory/async-commit-guard.ts`, built for exactly
+ * this shape of problem — see its own doc comment) rather than a second
+ * token counter grown here. `begin()` is called once per toggle click;
+ * because it is monotonic, it both claims a revision for this attempt AND
+ * retroactively invalidates every earlier attempt's revision, so an earlier
+ * attempt's settle arriving after a later one started is dropped by the
+ * `isCurrent` check below — regardless of settle order. The value/busy
+ * transition itself is `beginSilentUpdatesWrite`/
+ * `resolveSilentUpdatesWriteSuccess`/`resolveSilentUpdatesWriteFailure`
+ * (this feature's own `rules.ts`, pure, no ordering opinion of their own —
+ * ordering is entirely this hook's job).
+ *
+ * @complexity O(1) per toggle call.
+ */
+export declare function useSilentUpdatesToggle({ allowSilentUpdates, onSilentUpdatePreferenceChange, }: UseSilentUpdatesToggleOptions): UseSilentUpdatesToggleResult;
+//# sourceMappingURL=useSilentUpdatesToggle.d.ts.map

package/dist/features/about/react/hooks/useSilentUpdatesToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSilentUpdatesToggle.d.ts","sourceRoot":"","sources":["../../../../../src/features/about/react/hooks/useSilentUpdatesToggle.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,6BAA6B;IAC5C;;;;;qCAKiC;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;;;+DAK2D;IAC3D,8BAA8B,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACjF;AAED,MAAM,WAAW,4BAA4B;IAC3C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,kBAAkB,EAClB,8BAA8B,GAC/B,EAAE,6BAA6B,GAAG,4BAA4B,CAuB9D"}

package/dist/features/about/react/hooks/useSilentUpdatesToggle.js

@@ -0,0 +1,44 @@
+import { useCallback, useRef, useState } from 'react';
+import { beginSilentUpdatesWrite, resolveSilentUpdatesWriteFailure, resolveSilentUpdatesWriteSuccess, } from '../../rules.js';
+import { createAsyncCommitGuard } from '../../../memory/async-commit-guard.js';
+/**
+ * Optimistic write for the "allow silent updates" preference, safe under
+ * overlapping toggles. Origin: `SettingsDialog.tsx`'s inline handler
+ * (~5583-5644), which pairs a write-token ref with an optimistic set and a
+ * rollback to the pre-write value.
+ *
+ * The token/staleness half of that mechanism is `createAsyncCommitGuard`
+ * (already in `features/memory/async-commit-guard.ts`, built for exactly
+ * this shape of problem — see its own doc comment) rather than a second
+ * token counter grown here. `begin()` is called once per toggle click;
+ * because it is monotonic, it both claims a revision for this attempt AND
+ * retroactively invalidates every earlier attempt's revision, so an earlier
+ * attempt's settle arriving after a later one started is dropped by the
+ * `isCurrent` check below — regardless of settle order. The value/busy
+ * transition itself is `beginSilentUpdatesWrite`/
+ * `resolveSilentUpdatesWriteSuccess`/`resolveSilentUpdatesWriteFailure`
+ * (this feature's own `rules.ts`, pure, no ordering opinion of their own —
+ * ordering is entirely this hook's job).
+ *
+ * @complexity O(1) per toggle call.
+ */
+export function useSilentUpdatesToggle({ allowSilentUpdates, onSilentUpdatePreferenceChange, }) {
+    const [state, setState] = useState(() => ({ allowSilentUpdates, busy: false }));
+    const guardRef = useRef(createAsyncCommitGuard());
+    const toggle = useCallback((next) => {
+        if (!onSilentUpdatePreferenceChange)
+            return;
+        const previous = state.allowSilentUpdates;
+        const revision = guardRef.current.begin();
+        setState(beginSilentUpdatesWrite(next));
+        void onSilentUpdatePreferenceChange(next).then(() => {
+            if (guardRef.current.isCurrent(revision))
+                setState(resolveSilentUpdatesWriteSuccess(next));
+        }, () => {
+            if (guardRef.current.isCurrent(revision))
+                setState(resolveSilentUpdatesWriteFailure(previous));
+        });
+    }, [state.allowSilentUpdates, onSilentUpdatePreferenceChange]);
+    return { allowSilentUpdates: state.allowSilentUpdates, busy: state.busy, toggle };
+}
+//# sourceMappingURL=useSilentUpdatesToggle.js.map

package/dist/features/about/react/hooks/useSilentUpdatesToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSilentUpdatesToggle.js","sourceRoot":"","sources":["../../../../../src/features/about/react/hooks/useSilentUpdatesToggle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAyB/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,kBAAkB,EAClB,8BAA8B,GACA;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,IAAa,EAAE,EAAE;QAChB,IAAI,CAAC,8BAA8B;YAAE,OAAO;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1C,QAAQ,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,KAAK,8BAA8B,CAAC,IAAI,CAAC,CAAC,IAAI,CAC5C,GAAG,EAAE;YACH,IAAI,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;gBAAE,QAAQ,CAAC,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7F,CAAC,EACD,GAAG,EAAE;YACH,IAAI,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;gBAAE,QAAQ,CAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjG,CAAC,CACF,CAAC;IACJ,CAAC,EACD,CAAC,KAAK,CAAC,kBAAkB,EAAE,8BAA8B,CAAC,CAC3D,CAAC;IAEF,OAAO,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AACpF,CAAC"}

package/dist/features/about/rules.d.ts

@@ -0,0 +1,105 @@
+import type { AboutUpdateControl, AppVersionInfo, SilentUpdatesState, UpdaterModel } from './types.js';
+/**
+ * Default dictionary keys the About panel resolves against the host's own
+ * i18n. Exported so a host can see the full set it needs to provide rather
+ * than discovering them one missing string at a time.
+ */
+export declare const ABOUT_UPDATE_KEYS: {
+    readonly development: "settings.updateStatusDevelopment";
+    readonly unsupported: "settings.updateStatusUnsupported";
+    readonly checking: "settings.updateStatusChecking";
+    readonly checkingLabel: "updater.checking";
+    readonly upToDate: "settings.updateStatusUpToDate";
+    readonly recheck: "settings.updateRecheck";
+    readonly available: "settings.updateStatusAvailable";
+    readonly availableUnknown: "settings.updateStatusAvailableUnknown";
+    readonly download: "updater.download";
+    readonly downloading: "settings.updateStatusDownloading";
+    readonly downloadingPercent: "settings.updateStatusDownloadingPercent";
+    readonly downloadingLabel: "updater.downloading";
+    readonly ready: "settings.updateStatusReady";
+    readonly readyUnknown: "settings.updateStatusReadyUnknown";
+    readonly installNow: "settings.updateNow";
+    readonly installRestart: "updater.installRestart";
+    readonly installingRestart: "updater.installingRestart";
+    readonly installing: "settings.updateStatusInstalling";
+    readonly opening: "updater.opening";
+    readonly quit: "updater.quitButton";
+    readonly failed: "updater.failed";
+    readonly retry: "settings.updateRetry";
+    readonly notChecked: "settings.updateStatusNotChecked";
+    readonly check: "settings.updateCheck";
+};
+/**
+ * Derives what the About panel's update row should show.
+ *
+ * A total function over the updater state — every branch returns a complete
+ * `AboutUpdateControl`, so the panel never has to decide anything itself.
+ *
+ * Order matters, and the first two checks are not interchangeable:
+ *
+ * 1. **Unpackaged build first.** Running from source is reported as its own
+ *    "development" state rather than "unsupported". Both disable updating, but
+ *    telling a developer their build is unsupported would be actively
+ *    misleading.
+ * 2. **Then capability.** Not desktop, or updates disabled, or an unsupported
+ *    build — one shared "unsupported" outcome, since the operator can do
+ *    nothing about any of them from this panel.
+ *
+ * After that it is a switch over the reported state. Two subtleties worth
+ * keeping when reading it:
+ *
+ * - `primaryLabelKey` can be set while `primaryAction` is `null`. That is the
+ *   in-progress case — a visible but inert button reading "Downloading…"
+ *   rather than the button vanishing and the row reflowing.
+ * - The release link is hidden in exactly the two states where the app is
+ *   about to disappear (installing, or quitting to let an installer run).
+ *   Offering a navigation there invites a click that cannot complete.
+ *
+ * @complexity O(1) — a fixed switch, no iteration.
+ */
+export declare function deriveAboutUpdateControl(model: UpdaterModel, appVersionInfo: AppVersionInfo | null): AboutUpdateControl;
+/**
+ * Whether the primary button should be disabled.
+ *
+ * Three independent reasons, any of which is sufficient: there is no action to
+ * take, the host says an action is already in flight, or the caller is
+ * awaiting its own async work.
+ */
+export declare function isAboutUpdateActionDisabled(control: AboutUpdateControl, model: UpdaterModel, actionBusy?: boolean): boolean;
+/**
+ * Optimistically applies a new "allow silent updates" value and marks a
+ * write in flight. Call the instant the operator flips the toggle, before
+ * the write is even issued — the control must never wait on the network to
+ * reflect the click.
+ *
+ * Pairs with a caller-owned staleness guard (e.g. `createAsyncCommitGuard`):
+ * this function has no notion of "which write is current" because it is not
+ * given one — ordering is entirely the caller's responsibility, same split
+ * as `useMemoryConfig`'s optimistic toggles pairing that guard with their
+ * own confirmed-value bookkeeping.
+ *
+ * @complexity O(1)
+ */
+export declare function beginSilentUpdatesWrite(next: boolean): SilentUpdatesState;
+/**
+ * A silent-updates write that landed: keeps the already-applied optimistic
+ * value and clears busy. Callers must have already checked their own
+ * staleness guard before calling this — a settle for a write that is no
+ * longer the latest attempt must never reach here at all, not be filtered
+ * out inside it.
+ *
+ * @complexity O(1)
+ */
+export declare function resolveSilentUpdatesWriteSuccess(value: boolean): SilentUpdatesState;
+/**
+ * A silent-updates write that failed: rolls back to `previous` — the value
+ * in effect immediately before THIS write's own optimistic set, not a
+ * hardcoded default and not necessarily the value before some earlier,
+ * already-superseded write. Clears busy. Same staleness precondition as
+ * {@link resolveSilentUpdatesWriteSuccess}.
+ *
+ * @complexity O(1)
+ */
+export declare function resolveSilentUpdatesWriteFailure(previous: boolean): SilentUpdatesState;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/about/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/about/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAA4B,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjI;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBpB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,cAAc,GAAG,IAAI,GACpC,kBAAkB,CA4IpB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,YAAY,EACnB,UAAU,UAAQ,GACjB,OAAO,CAET;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,OAAO,GAAG,kBAAkB,CAEtF"}