@jini-ai/ui 0.1.2 → 0.3.0

package/dist/features/about/rules.js

@@ -0,0 +1,240 @@
+/**
+ * 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 const ABOUT_UPDATE_KEYS = {
+    development: 'settings.updateStatusDevelopment',
+    unsupported: 'settings.updateStatusUnsupported',
+    checking: 'settings.updateStatusChecking',
+    checkingLabel: 'updater.checking',
+    upToDate: 'settings.updateStatusUpToDate',
+    recheck: 'settings.updateRecheck',
+    available: 'settings.updateStatusAvailable',
+    availableUnknown: 'settings.updateStatusAvailableUnknown',
+    download: 'updater.download',
+    downloading: 'settings.updateStatusDownloading',
+    downloadingPercent: 'settings.updateStatusDownloadingPercent',
+    downloadingLabel: 'updater.downloading',
+    ready: 'settings.updateStatusReady',
+    readyUnknown: 'settings.updateStatusReadyUnknown',
+    installNow: 'settings.updateNow',
+    installRestart: 'updater.installRestart',
+    installingRestart: 'updater.installingRestart',
+    installing: 'settings.updateStatusInstalling',
+    opening: 'updater.opening',
+    quit: 'updater.quitButton',
+    failed: 'updater.failed',
+    retry: 'settings.updateRetry',
+    notChecked: 'settings.updateStatusNotChecked',
+    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 function deriveAboutUpdateControl(model, appVersionInfo) {
+    const K = ABOUT_UPDATE_KEYS;
+    if (appVersionInfo?.packaged === false) {
+        return {
+            primaryAction: null,
+            primaryLabelKey: null,
+            showReleaseLink: true,
+            statusKey: K.development,
+            statusTone: 'neutral',
+        };
+    }
+    if (model.environment !== 'desktop' || !model.enabled || !model.supported) {
+        return {
+            primaryAction: null,
+            primaryLabelKey: null,
+            showReleaseLink: true,
+            statusKey: K.unsupported,
+            statusTone: 'warning',
+        };
+    }
+    switch (model.status?.state) {
+        case 'checking':
+            return {
+                primaryAction: null,
+                primaryLabelKey: K.checkingLabel,
+                showReleaseLink: true,
+                statusKey: K.checking,
+                statusTone: 'neutral',
+            };
+        case 'not-available':
+            return {
+                primaryAction: 'check',
+                primaryLabelKey: K.recheck,
+                showReleaseLink: true,
+                statusKey: K.upToDate,
+                statusTone: 'success',
+            };
+        case 'available':
+            return {
+                primaryAction: model.canDownload ? 'download' : null,
+                primaryLabelKey: model.canDownload ? K.download : null,
+                showReleaseLink: true,
+                statusKey: model.availableVersion ? K.available : K.availableUnknown,
+                statusTone: 'warning',
+                ...(model.availableVersion ? { statusVars: { version: model.availableVersion } } : {}),
+            };
+        case 'downloading': {
+            const percent = model.downloadProgress?.percent;
+            const known = typeof percent === 'number';
+            return {
+                primaryAction: null,
+                primaryLabelKey: K.downloadingLabel,
+                showReleaseLink: true,
+                statusKey: known ? K.downloadingPercent : K.downloading,
+                statusTone: 'neutral',
+                ...(known ? { statusVars: { percent } } : {}),
+            };
+        }
+        case 'downloaded': {
+            // The installer is already running; the only useful act left is to get
+            // out of its way.
+            if (model.installerOpened && model.canQuitAfterInstallerOpen) {
+                return {
+                    primaryAction: 'quit',
+                    primaryLabelKey: K.quit,
+                    showReleaseLink: false,
+                    statusKey: model.updateKind === 'payload' ? K.installingRestart : K.opening,
+                    statusTone: 'neutral',
+                };
+            }
+            const canInstall = Boolean(model.canOpenInstaller || model.canApplyInPlace);
+            return {
+                primaryAction: canInstall ? 'install' : null,
+                primaryLabelKey: canInstall ? (model.updateKind === 'payload' ? K.installRestart : K.installNow) : null,
+                showReleaseLink: true,
+                statusKey: model.availableVersion ? K.ready : K.readyUnknown,
+                statusTone: 'success',
+                ...(model.availableVersion ? { statusVars: { version: model.availableVersion } } : {}),
+            };
+        }
+        case 'installing':
+            return {
+                primaryAction: null,
+                primaryLabelKey: K.installingRestart,
+                showReleaseLink: false,
+                statusKey: K.installing,
+                statusTone: 'neutral',
+            };
+        case 'error': {
+            // Retry the furthest-along step that is still possible: re-install a
+            // download we already have, else re-download a version we know about,
+            // else start over. Sending the operator back to "check" when a finished
+            // download is sitting on disk would throw away the expensive part.
+            const canRetryInstall = model.status?.downloadPath != null && Boolean(model.canOpenInstaller || model.canApplyInPlace);
+            const primaryAction = canRetryInstall
+                ? 'install'
+                : model.availableVersion != null && model.canDownload
+                    ? 'download'
+                    : 'check';
+            return {
+                primaryAction,
+                primaryLabelKey: K.retry,
+                showReleaseLink: true,
+                statusKey: K.failed,
+                statusTone: 'error',
+            };
+        }
+        case 'unsupported':
+            return {
+                primaryAction: null,
+                primaryLabelKey: null,
+                showReleaseLink: true,
+                statusKey: K.unsupported,
+                statusTone: 'warning',
+            };
+        // `idle`, and any state a newer backend reports that this build predates.
+        // Falling through to "you can check" is the safe default: it offers the
+        // one action that is valid from any unknown state.
+        case 'idle':
+        default:
+            return {
+                primaryAction: 'check',
+                primaryLabelKey: K.check,
+                showReleaseLink: true,
+                statusKey: K.notChecked,
+                statusTone: 'neutral',
+            };
+    }
+}
+/**
+ * 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 function isAboutUpdateActionDisabled(control, model, actionBusy = false) {
+    return control.primaryAction === null || Boolean(model.busy) || actionBusy;
+}
+/**
+ * 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 function beginSilentUpdatesWrite(next) {
+    return { allowSilentUpdates: next, busy: true };
+}
+/**
+ * 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 function resolveSilentUpdatesWriteSuccess(value) {
+    return { allowSilentUpdates: value, busy: false };
+}
+/**
+ * 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 function resolveSilentUpdatesWriteFailure(previous) {
+    return { allowSilentUpdates: previous, busy: false };
+}
+//# sourceMappingURL=rules.js.map

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

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

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

@@ -0,0 +1,110 @@
+/**
+ * Origin: the `about` section of `SettingsDialog.tsx` (~5509-5669) and its
+ * already-pure `deriveAboutUpdateControl` (line 249).
+ *
+ * GENERIC despite looking desktop-specific. Jini is a reusable engine, not
+ * any single product's private dependency — any desktop app built on it needs a version
+ * panel and an auto-update state machine, and this is that state machine with
+ * nothing product-bound left in it. A server host simply reports
+ * `environment: 'web'` and gets the single "updates not supported here"
+ * outcome, which is a legitimate answer rather than a missing feature.
+ *
+ * What is deliberately NOT ported: the origin's `keyof Dict` typing on label
+ * and status keys, and its hardcoded `OPEN_DESIGN_RELEASES_URL`. Keys are
+ * plain strings a host resolves against its own dictionary (same convention as
+ * `LocaleOption` and `ProviderPreset`), and the releases URL is host-supplied.
+ * Neither is a behaviour change — they are the two places the origin's own
+ * product leaked into an otherwise generic rule.
+ */
+/** Where the host is running. Only `'desktop'` can self-update. */
+export type UpdaterEnvironment = 'desktop' | 'web' | (string & {});
+/** The updater's current phase, as reported by the host's update backend. */
+export type UpdaterState = 'idle' | 'checking' | 'not-available' | 'available' | 'downloading' | 'downloaded' | 'installing' | 'error' | 'unsupported';
+/**
+ * How an update gets applied.
+ *
+ * `'payload'` swaps files in place and restarts; anything else hands off to a
+ * platform installer. The distinction only changes wording, but it changes it
+ * in three separate places, which is why it is modelled rather than inferred.
+ */
+export type UpdateKind = 'payload' | 'installer' | (string & {});
+export interface UpdaterStatus {
+    state: UpdaterState;
+    /** Where a downloaded update landed. Its presence is what makes an
+     *  install retryable after an error. */
+    downloadPath?: string | null;
+}
+export interface UpdaterDownloadProgress {
+    /** 0-100. Absent when the backend reports no measurable progress — which is
+     *  a real case (an unknown content length), not an error. */
+    percent?: number;
+}
+/** Everything the update state machine reads. Hosts map their own updater onto
+ *  this shape rather than this shape onto theirs. */
+export interface UpdaterModel {
+    environment: UpdaterEnvironment;
+    /** Operator-level switch — updates turned off in settings. */
+    enabled: boolean;
+    /** Build-level capability — this build can update at all. */
+    supported: boolean;
+    status?: UpdaterStatus;
+    /** Version on offer, when known. */
+    availableVersion?: string | null;
+    downloadProgress?: UpdaterDownloadProgress;
+    canDownload?: boolean;
+    canOpenInstaller?: boolean;
+    canApplyInPlace?: boolean;
+    /** The installer has been handed off to the OS. */
+    installerOpened?: boolean;
+    /** Quitting now is what lets the handed-off installer proceed. */
+    canQuitAfterInstallerOpen?: boolean;
+    updateKind?: UpdateKind;
+    /** An action is in flight; the host disables its button. */
+    busy?: boolean;
+}
+export interface AppVersionInfo {
+    version: string;
+    /**
+     * `false` means running from source rather than a packaged build.
+     *
+     * Checked FIRST and separately from `supported`, because a developer running
+     * unpackaged should be told exactly that rather than "updates unsupported" —
+     * the two look identical to the state machine but mean opposite things to
+     * the person reading the panel.
+     */
+    packaged?: boolean;
+}
+export type AboutUpdatePrimaryAction = 'check' | 'download' | 'install' | 'quit';
+export type AboutUpdateTone = 'neutral' | 'success' | 'warning' | 'error';
+/** What the About panel should render for the current updater state. */
+export interface AboutUpdateControl {
+    /** `null` means no actionable button — the state is transient or terminal. */
+    primaryAction: AboutUpdatePrimaryAction | null;
+    /** Dictionary key for the button label. `null` hides the button entirely.
+     *  Note a label can be present while the action is `null`: that renders a
+     *  disabled progress button ("Downloading…"). */
+    primaryLabelKey: string | null;
+    showReleaseLink: boolean;
+    statusKey: string;
+    statusTone: AboutUpdateTone;
+    /** Interpolation values for `statusKey`, when it takes any. */
+    statusVars?: Record<string, string | number>;
+}
+/**
+ * Visible state of the "allow silent updates" preference: the value the
+ * toggle should currently display (the optimistic value while a write is in
+ * flight, the confirmed value otherwise) and whether a write for it is
+ * in-flight. Origin: `SettingsDialog.tsx`'s inline `cfg.allowSilentUpdates`
+ * toggle handler (~5583-5644) — carries a write-token ref, an optimistic
+ * set, and a rollback-to-`previous` on failure. Ported as the value/busy
+ * transition only; the token/staleness half of that mechanism is NOT
+ * duplicated here because `createAsyncCommitGuard`
+ * (`features/memory/async-commit-guard.ts`) already is that primitive —
+ * callers pair it with the functions below
+ * rather than this tab growing a second copy.
+ */
+export interface SilentUpdatesState {
+    allowSilentUpdates: boolean;
+    busy: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/about/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEnE,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,UAAU,GACV,eAAe,GACf,WAAW,GACX,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,OAAO,GACP,aAAa,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB;4CACwC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC;iEAC6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;qDACqD;AACrD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,kBAAkB,CAAC;IAChC,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kEAAkE;IAClE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1E,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC/C;;qDAEiD;IACjD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,CAAC;IAC5B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/features/about/types.js

@@ -0,0 +1,20 @@
+/**
+ * Origin: the `about` section of `SettingsDialog.tsx` (~5509-5669) and its
+ * already-pure `deriveAboutUpdateControl` (line 249).
+ *
+ * GENERIC despite looking desktop-specific. Jini is a reusable engine, not
+ * any single product's private dependency — any desktop app built on it needs a version
+ * panel and an auto-update state machine, and this is that state machine with
+ * nothing product-bound left in it. A server host simply reports
+ * `environment: 'web'` and gets the single "updates not supported here"
+ * outcome, which is a legitimate answer rather than a missing feature.
+ *
+ * What is deliberately NOT ported: the origin's `keyof Dict` typing on label
+ * and status keys, and its hardcoded `OPEN_DESIGN_RELEASES_URL`. Keys are
+ * plain strings a host resolves against its own dictionary (same convention as
+ * `LocaleOption` and `ProviderPreset`), and the releases URL is host-supplied.
+ * Neither is a behaviour change — they are the two places the origin's own
+ * product leaked into an otherwise generic rule.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/about/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/features/appearance/constants.d.ts

@@ -0,0 +1,16 @@
+import type { SettingsThemeChoice } from './types.js';
+export interface ThemeOption {
+    value: SettingsThemeChoice;
+    label: string;
+    icon?: 'sun' | 'moon';
+}
+/** Plain-English defaults for the three segmented-control options — a host
+ *  wanting localized copy overrides via `AppearanceTabProps.themeLabels` (the
+ *  component wraps each through `useT()` regardless, so this is only the
+ *  fallback text, same convention as every other tab in this feature). */
+export declare const THEME_OPTIONS: ThemeOption[];
+/** Neutral default accent — hosts are expected to override via their own
+ *  config/branding; this only guarantees the CSS vars are always set. */
+export declare const DEFAULT_ACCENT_COLOR = "#2563eb";
+export declare const ACCENT_SWATCHES: readonly ["#2563eb", "#c96442", "#7c3aed", "#059669", "#dc2626", "#d97706", "#0891b2", "#db2777"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/appearance/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/appearance/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACvB;AAED;;;0EAG0E;AAC1E,eAAO,MAAM,aAAa,EAAE,WAAW,EAItC,CAAC;AAEF;yEACyE;AACzE,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,eAAO,MAAM,eAAe,mGASlB,CAAC"}

package/dist/features/appearance/constants.js

@@ -0,0 +1,23 @@
+/** Plain-English defaults for the three segmented-control options — a host
+ *  wanting localized copy overrides via `AppearanceTabProps.themeLabels` (the
+ *  component wraps each through `useT()` regardless, so this is only the
+ *  fallback text, same convention as every other tab in this feature). */
+export const THEME_OPTIONS = [
+    { value: 'system', label: 'System' },
+    { value: 'light', label: 'Light', icon: 'sun' },
+    { value: 'dark', label: 'Dark', icon: 'moon' },
+];
+/** Neutral default accent — hosts are expected to override via their own
+ *  config/branding; this only guarantees the CSS vars are always set. */
+export const DEFAULT_ACCENT_COLOR = '#2563eb';
+export const ACCENT_SWATCHES = [
+    DEFAULT_ACCENT_COLOR,
+    '#c96442',
+    '#7c3aed',
+    '#059669',
+    '#dc2626',
+    '#d97706',
+    '#0891b2',
+    '#db2777',
+];
+//# sourceMappingURL=constants.js.map

package/dist/features/appearance/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/appearance/constants.ts"],"names":[],"mappings":"AAQA;;;0EAG0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACpC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE;IAC/C,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;CAC/C,CAAC;AAEF;yEACyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oBAAoB;IACpB,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACD,CAAC"}

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

@@ -0,0 +1,5 @@
+export { THEME_OPTIONS, type ThemeOption } from './constants.js';
+export type { SettingsThemeChoice } from './types.js';
+export { AppearanceTab } from './react/components/AppearanceTab.js';
+export type { AppearanceTabProps } from './react/components/AppearanceTab.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/appearance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/appearance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/features/appearance/react/components/AppearanceTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppearanceTab.d.ts","sourceRoot":"","sources":["../../../../../src/features/appearance/react/components/AppearanceTab.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,aAAa,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD;6EACyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,sEAAsE;IACtE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;6DAIyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,cAAgC,EAChC,WAAkB,EAClB,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,qBAAqB,GACtB,EAAE,kBAAkB,+BAiEpB"}

package/dist/features/appearance/react/components/AppearanceTab.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useLayoutEffect } from 'react';
+import { useT } from '../../../i18n/index.js';
+import { Icon } from '../../../../react/components/Icon.js';
+import { ACCENT_SWATCHES, DEFAULT_ACCENT_COLOR, applyAppearanceToDocument, normalizeAccentColor, resolveAccentColor, } from '../../../../utils/appearance.js';
+import { THEME_OPTIONS } from '../../constants.js';
+/**
+ * Theme (system/light/dark) segmented control + accent-color swatch grid
+ * with a custom color picker. Origin: `AppearanceSection` in
+ * `SettingsDialog.tsx` — GENERIC, no product coupling beyond the (already
+ * dropped) analytics tracking calls.
+ */
+export function AppearanceTab({ theme, onThemeChange, accentColor, onAccentColorChange, accentSwatches = ACCENT_SWATCHES, livePreview = true, ariaLabel, accentLabel, defaultAccentAriaLabel, customAccentAriaLabel, }) {
+    const t = useT();
+    const resolvedAccent = resolveAccentColor(accentColor);
+    const resolvedAriaLabel = ariaLabel ?? t('Appearance');
+    const resolvedAccentLabel = accentLabel ?? t('Accent color');
+    const resolvedDefaultAccentAriaLabel = defaultAccentAriaLabel ?? t('Default accent color');
+    const resolvedCustomAccentAriaLabel = customAccentAriaLabel ?? t('Custom accent color');
+    const appliedTheme = theme === 'system' ? undefined : theme;
+    useLayoutEffect(() => {
+        if (!livePreview)
+            return;
+        applyAppearanceToDocument({ ...(appliedTheme ? { theme: appliedTheme } : {}), accentColor: resolvedAccent });
+    }, [livePreview, appliedTheme, resolvedAccent]);
+    return (_jsxs("section", { className: "jini-settings-section jini-settings-appearance", children: [_jsx("div", { className: "jini-seg-control", role: "group", "aria-label": resolvedAriaLabel, style: { '--seg-cols': THEME_OPTIONS.length }, children: THEME_OPTIONS.map((option) => (_jsxs("button", { type: "button", className: 'jini-seg-btn' + (theme === option.value ? ' active' : ''), "aria-pressed": theme === option.value, onClick: () => onThemeChange(option.value), children: [option.icon ? _jsx(Icon, { name: option.icon, size: 14, "aria-hidden": "true" }) : null, _jsx("span", { className: "jini-seg-title", children: t(option.label) })] }, option.value))) }), _jsxs("div", { className: "jini-field", children: [_jsx("span", { className: "jini-field-label", children: resolvedAccentLabel }), _jsxs("div", { className: "jini-accent-swatches", role: "radiogroup", "aria-label": resolvedAccentLabel, children: [accentSwatches.map((color) => {
+                                const active = resolvedAccent === color;
+                                return (_jsx("button", { type: "button", className: `jini-accent-swatch${active ? ' active' : ''}`, style: { background: color }, "aria-label": color === DEFAULT_ACCENT_COLOR ? resolvedDefaultAccentAriaLabel : color, "aria-checked": active, role: "radio", onClick: () => onAccentColorChange(normalizeAccentColor(color) ?? color) }, color));
+                            }), _jsx("input", { type: "color", "aria-label": resolvedCustomAccentAriaLabel, className: "jini-accent-swatch-picker", value: resolvedAccent, onChange: (event) => onAccentColorChange(event.target.value) })] })] })] }));
+}
+//# sourceMappingURL=AppearanceTab.js.map

package/dist/features/appearance/react/components/AppearanceTab.js.map

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

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

@@ -0,0 +1,31 @@
+/**
+ * The five `--accent*` CSS custom property names this feature writes.
+ * Module-private: callers get values back from `accentVars`, keyed by these
+ * names, rather than needing the list itself.
+ */
+declare const ACCENT_VARS: readonly ["--accent", "--accent-strong", "--accent-soft", "--accent-tint", "--accent-hover"];
+export type AccentCssVars = Record<(typeof ACCENT_VARS)[number], string>;
+/**
+ * Validate and lowercase a `#rrggbb` accent color string.
+ *
+ * @param value - Candidate accent color, typically from persisted config.
+ * @returns The lowercased 6-digit hex string, or `null` if `value` is not a
+ *   string or does not match `#rrggbb`.
+ * @complexity O(1).
+ */
+export declare function normalizeAccentColor(value: unknown): string | null;
+/** `normalizeAccentColor(value) ?? DEFAULT_ACCENT_COLOR` — always returns a
+ *  usable color. */
+export declare function resolveAccentColor(value: unknown): string;
+/**
+ * Pure computation of the five `--accent*` CSS custom property values for a
+ * given (already-resolved) accent color, via `color-mix()` formulas. The DOM
+ * write itself (`applyAppearanceToDocument`) lives in `packages/ui` — it
+ * needs `document`, which is the one thing this package can't have — and
+ * calls this for the values it writes.
+ *
+ * @complexity O(1) — five template-string formulas, no DOM access.
+ */
+export declare function accentVars(accentColor: string): AccentCssVars;
+export {};
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/appearance/rules.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,QAAA,MAAM,WAAW,8FAA+F,CAAC;AAEjH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED;oBACoB;AACpB,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAQ7D"}

package/dist/features/appearance/rules.js

@@ -0,0 +1,45 @@
+import { DEFAULT_ACCENT_COLOR } from './constants.js';
+/**
+ * The five `--accent*` CSS custom property names this feature writes.
+ * Module-private: callers get values back from `accentVars`, keyed by these
+ * names, rather than needing the list itself.
+ */
+const ACCENT_VARS = ['--accent', '--accent-strong', '--accent-soft', '--accent-tint', '--accent-hover'];
+/**
+ * Validate and lowercase a `#rrggbb` accent color string.
+ *
+ * @param value - Candidate accent color, typically from persisted config.
+ * @returns The lowercased 6-digit hex string, or `null` if `value` is not a
+ *   string or does not match `#rrggbb`.
+ * @complexity O(1).
+ */
+export function normalizeAccentColor(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return /^#[0-9a-fA-F]{6}$/.test(trimmed) ? trimmed.toLowerCase() : null;
+}
+/** `normalizeAccentColor(value) ?? DEFAULT_ACCENT_COLOR` — always returns a
+ *  usable color. */
+export function resolveAccentColor(value) {
+    return normalizeAccentColor(value) ?? DEFAULT_ACCENT_COLOR;
+}
+/**
+ * Pure computation of the five `--accent*` CSS custom property values for a
+ * given (already-resolved) accent color, via `color-mix()` formulas. The DOM
+ * write itself (`applyAppearanceToDocument`) lives in `packages/ui` — it
+ * needs `document`, which is the one thing this package can't have — and
+ * calls this for the values it writes.
+ *
+ * @complexity O(1) — five template-string formulas, no DOM access.
+ */
+export function accentVars(accentColor) {
+    return {
+        '--accent': accentColor,
+        '--accent-strong': `color-mix(in srgb, ${accentColor} 86%, var(--text-strong))`,
+        '--accent-soft': `color-mix(in srgb, ${accentColor} 22%, var(--bg-panel))`,
+        '--accent-tint': `color-mix(in srgb, ${accentColor} 12%, var(--bg-panel))`,
+        '--accent-hover': `color-mix(in srgb, ${accentColor} 90%, var(--text-strong))`,
+    };
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/appearance/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/features/appearance/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAU,CAAC;AAIjH;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED;oBACoB;AACpB,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,oBAAoB,CAAC,KAAK,CAAC,IAAI,oBAAoB,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,iBAAiB,EAAE,sBAAsB,WAAW,2BAA2B;QAC/E,eAAe,EAAE,sBAAsB,WAAW,wBAAwB;QAC1E,eAAe,EAAE,sBAAsB,WAAW,wBAAwB;QAC1E,gBAAgB,EAAE,sBAAsB,WAAW,2BAA2B;KAC/E,CAAC;AACJ,CAAC"}

package/dist/features/appearance/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Origin: `AppearanceSection` in `SettingsDialog.tsx` (theme segmented
+ * control + accent-color swatch grid + custom color picker), GENERIC per
+ * `ADS-memory/reports/jini-port/recon/r6-god-component-internals.md` §1.3. See
+ * `packages/ui/source-map.md` for the full provenance note.
+ */
+/** `'system'` in addition to this package's `AppearanceTheme` ('light' |
+ *  'dark') — the origin's segmented control has a third "follow the OS"
+ *  option that `applyAppearanceToDocument` already models as "theme
+ *  omitted." */
+export type SettingsThemeChoice = 'system' | 'light' | 'dark';
+//# sourceMappingURL=types.d.ts.map

package/dist/features/appearance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/appearance/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;gBAGgB;AAChB,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC"}

package/dist/features/appearance/types.js

@@ -0,0 +1,8 @@
+/**
+ * Origin: `AppearanceSection` in `SettingsDialog.tsx` (theme segmented
+ * control + accent-color swatch grid + custom color picker), GENERIC per
+ * `ADS-memory/reports/jini-port/recon/r6-god-component-internals.md` §1.3. See
+ * `packages/ui/source-map.md` for the full provenance note.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/appearance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/appearance/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/features/asset-grid/react/components/AssetGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/AssetGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAU1E,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,aAAa;IAC1D,gKAAgK;IAChK,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACtC,gHAAgH;IAChH,YAAY,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,0GAA0G;IAC1G,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC9C,0BAA0B,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC1D,oHAAoH;IACpH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC/C,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAS,CAAC;IACzD,0FAA0F;IAC1F,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,qJAAqJ;IACrJ,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4GAA4G;IAC5G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;IACrD,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,aAAa,EAAE,EACtD,MAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAe,EACf,YAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAqB,EACrB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,gBAA6C,EAC7C,oBAAoB,EACpB,eAAwB,EACxB,qBAAqB,EAAE,yBAAiD,EACxE,qBAAqB,EAAE,yBAAiD,GACzE,EAAE,cAAc,CAAC,MAAM,CAAC,+BAuLxB"}
+{"version":3,"file":"AssetGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/asset-grid/react/components/AssetGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAU1E,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,aAAa;IAC1D,gKAAgK;IAChK,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACtC,gHAAgH;IAChH,YAAY,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,0GAA0G;IAC1G,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC9C,0BAA0B,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC1D,oHAAoH;IACpH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC/C,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAS,CAAC;IACzD,0FAA0F;IAC1F,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,qJAAqJ;IACrJ,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4GAA4G;IAC5G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;IACrD,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,aAAa,EAAE,EACtD,MAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAe,EACf,YAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAqB,EACrB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,gBAA6C,EAC7C,oBAAoB,EACpB,eAAwB,EACxB,qBAAqB,EAAE,yBAAiD,EACxE,qBAAqB,EAAE,yBAAiD,GACzE,EAAE,cAAc,CAAC,MAAM,CAAC,+BAkOxB"}