@jini-ai/ui 0.1.0

package/dist/features/schedule-picker/rules.d.ts

@@ -0,0 +1,40 @@
+import type { ScheduleEditorState, ScheduleKind, ScheduleSummaryParts, ScheduleValue, WeekdayOption } from './types.js';
+/** Clamp a candidate "minute of the hour" to a valid integer 0-59. Non-finite
+ *  input (e.g. `NaN` from an emptied number input) clamps to 0. */
+export declare function clampMinute(value: number): number;
+/** Format a `'HH:MM'` 24h time string as 12h with an AM/PM suffix
+ *  (`'09:00'` -> `'9:00 AM'`). Returns the input unchanged if it doesn't
+ *  match the expected shape. */
+export declare function formatTime12h(time: string): string;
+/**
+ * Decompose a {@link ScheduleValue} into display-ready, still-untranslated
+ * parts — single source of truth shared by {@link describeScheduleSummary}
+ * (a plain string) and the React layer's structured pill-segment renderer,
+ * so a change to time/weekday formatting only needs to happen here.
+ */
+export declare function decomposeSchedule(schedule: ScheduleValue, weekdays?: WeekdayOption[]): ScheduleSummaryParts;
+/** Plain-English one-line summary, e.g. `'Hourly at :05'` or
+ *  `'Daily at 9:00 AM · America/Los_Angeles'`. Useful as a default
+ *  `aria-label`/title when a host hasn't wired translated copy. Callers
+ *  wanting translated output should decompose+translate the parts
+ *  themselves instead (see `useRecurringSchedulePicker`). */
+export declare function describeScheduleSummary(schedule: ScheduleValue, weekdays?: WeekdayOption[]): string;
+/** A fresh editor state defaulting to a daily 09:00 schedule in the given
+ *  timezone (typically the caller's `detectLocalTimezone()`). */
+export declare function defaultScheduleEditorState(timezone: string): ScheduleEditorState;
+/**
+ * Merge a {@link ScheduleValue} onto a base editor state: only the fields
+ * the value's kind actually carries are overwritten, so switching kinds in
+ * the UI afterward still has sensible values for the untouched fields
+ * (mirrors the vendored `formFromRoutine`'s partial-application behavior).
+ */
+export declare function scheduleEditorStateFromValue(value: ScheduleValue, base: ScheduleEditorState): ScheduleEditorState;
+/** Project an editor state down to the tagged-union `ScheduleValue` its
+ *  active `kind` actually needs. */
+export declare function buildScheduleValue(state: ScheduleEditorState): ScheduleValue;
+/** Is `kind` one that shows the weekday grid? Only `'weekly'` does. */
+export declare function showsWeekdayGrid(kind: ScheduleKind): boolean;
+/** Is `kind` one that shows the time+timezone fields (as opposed to the
+ *  hourly minute field)? Every kind except `'hourly'`. */
+export declare function showsTimeFields(kind: ScheduleKind): boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/schedule-picker/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/schedule-picker/rules.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAW,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjI;mEACmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;gCAEgC;AAChC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,QAAQ,GAAE,aAAa,EAAqB,GAC3C,oBAAoB,CAWtB;AAED;;;;6DAI6D;AAC7D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,GAAE,aAAa,EAAqB,GAAG,MAAM,CAIrH;AAED;iEACiE;AACjE,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAQhF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,mBAAmB,GACxB,mBAAmB,CAQrB;AAED;oCACoC;AACpC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa,CAM5E;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED;0DAC0D;AAC1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE3D"}

package/dist/features/schedule-picker/rules.js

@@ -0,0 +1,105 @@
+/**
+ * Pure schedule-editor logic — no React, no i18n hook. Every English label
+ * this module returns (e.g. `'Hourly'`, `'Daily'`, weekday long names) is
+ * meant to be passed through the caller's `useT()` as a key, per this
+ * package's i18n convention (`rules.ts` stays hook-free by design; the
+ * React layer wraps the return value).
+ */
+import { DEFAULT_WEEKDAYS } from './constants.js';
+/** Clamp a candidate "minute of the hour" to a valid integer 0-59. Non-finite
+ *  input (e.g. `NaN` from an emptied number input) clamps to 0. */
+export function clampMinute(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(59, Math.round(value)));
+}
+/** Format a `'HH:MM'` 24h time string as 12h with an AM/PM suffix
+ *  (`'09:00'` -> `'9:00 AM'`). Returns the input unchanged if it doesn't
+ *  match the expected shape. */
+export function formatTime12h(time) {
+    const m = /^(\d{2}):(\d{2})$/.exec(time);
+    if (!m)
+        return time;
+    const h = Number(m[1]);
+    const mm = m[2];
+    const suffix = h >= 12 ? 'PM' : 'AM';
+    const h12 = h === 0 ? 12 : h > 12 ? h - 12 : h;
+    return `${h12}:${mm} ${suffix}`;
+}
+function weekdayLongName(weekday, weekdays) {
+    return weekdays.find((w) => w.value === weekday)?.long ?? weekdays[0]?.long ?? 'Sunday';
+}
+/**
+ * Decompose a {@link ScheduleValue} into display-ready, still-untranslated
+ * parts — single source of truth shared by {@link describeScheduleSummary}
+ * (a plain string) and the React layer's structured pill-segment renderer,
+ * so a change to time/weekday formatting only needs to happen here.
+ */
+export function decomposeSchedule(schedule, weekdays = DEFAULT_WEEKDAYS) {
+    if (schedule.kind === 'hourly') {
+        return { kind: 'hourly', minute: String(schedule.minute).padStart(2, '0') };
+    }
+    const freq = schedule.kind === 'daily'
+        ? 'Daily'
+        : schedule.kind === 'weekdays'
+            ? 'Weekdays'
+            : weekdayLongName(schedule.weekday, weekdays);
+    return { kind: 'timed', freq, time: formatTime12h(schedule.time), tz: schedule.timezone };
+}
+/** Plain-English one-line summary, e.g. `'Hourly at :05'` or
+ *  `'Daily at 9:00 AM · America/Los_Angeles'`. Useful as a default
+ *  `aria-label`/title when a host hasn't wired translated copy. Callers
+ *  wanting translated output should decompose+translate the parts
+ *  themselves instead (see `useRecurringSchedulePicker`). */
+export function describeScheduleSummary(schedule, weekdays = DEFAULT_WEEKDAYS) {
+    const parts = decomposeSchedule(schedule, weekdays);
+    if (parts.kind === 'hourly')
+        return `Hourly at :${parts.minute}`;
+    return `${parts.freq} at ${parts.time} · ${parts.tz}`;
+}
+/** A fresh editor state defaulting to a daily 09:00 schedule in the given
+ *  timezone (typically the caller's `detectLocalTimezone()`). */
+export function defaultScheduleEditorState(timezone) {
+    return {
+        kind: 'daily',
+        minute: 0,
+        time: '09:00',
+        weekday: 1,
+        timezone,
+    };
+}
+/**
+ * Merge a {@link ScheduleValue} onto a base editor state: only the fields
+ * the value's kind actually carries are overwritten, so switching kinds in
+ * the UI afterward still has sensible values for the untouched fields
+ * (mirrors the vendored `formFromRoutine`'s partial-application behavior).
+ */
+export function scheduleEditorStateFromValue(value, base) {
+    if (value.kind === 'hourly') {
+        return { ...base, kind: 'hourly', minute: value.minute };
+    }
+    if (value.kind === 'weekly') {
+        return { ...base, kind: 'weekly', weekday: value.weekday, time: value.time, timezone: value.timezone };
+    }
+    return { ...base, kind: value.kind, time: value.time, timezone: value.timezone };
+}
+/** Project an editor state down to the tagged-union `ScheduleValue` its
+ *  active `kind` actually needs. */
+export function buildScheduleValue(state) {
+    if (state.kind === 'hourly')
+        return { kind: 'hourly', minute: state.minute };
+    if (state.kind === 'weekly') {
+        return { kind: 'weekly', weekday: state.weekday, time: state.time, timezone: state.timezone };
+    }
+    return { kind: state.kind, time: state.time, timezone: state.timezone };
+}
+/** Is `kind` one that shows the weekday grid? Only `'weekly'` does. */
+export function showsWeekdayGrid(kind) {
+    return kind === 'weekly';
+}
+/** Is `kind` one that shows the time+timezone fields (as opposed to the
+ *  hourly minute field)? Every kind except `'hourly'`. */
+export function showsTimeFields(kind) {
+    return kind !== 'hourly';
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/schedule-picker/rules.js.map

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

package/dist/features/schedule-picker/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Generic types for a "cron-lite" recurring-schedule value: hourly / daily /
+ * weekdays / weekly, each carrying only the fields that kind actually needs.
+ * Deliberately NOT the vendored `RoutineSchedule` contract type (r6 §1.19
+ * flags that as the one OD-specific piece of the schedule editor) — this is
+ * a standalone generic shape a host maps its own domain schedule onto.
+ */
+export type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export type ScheduleKind = 'hourly' | 'daily' | 'weekdays' | 'weekly';
+export type ScheduleValue = {
+    kind: 'hourly';
+    minute: number;
+} | {
+    kind: 'daily';
+    time: string;
+    timezone: string;
+} | {
+    kind: 'weekdays';
+    time: string;
+    timezone: string;
+} | {
+    kind: 'weekly';
+    weekday: Weekday;
+    time: string;
+    timezone: string;
+};
+/** A schedule-kind tab: `label` is plain English, used directly as an
+ *  `useT()` key by the caller (per this package's i18n convention). */
+export interface ScheduleKindOption {
+    kind: ScheduleKind;
+    label: string;
+}
+/** A weekday option for the weekday grid: `short`/`long` are plain English,
+ *  used directly as `useT()` keys by the caller. */
+export interface WeekdayOption {
+    value: Weekday;
+    short: string;
+    long: string;
+}
+/**
+ * Editable working state for the schedule popover: unlike {@link ScheduleValue}
+ * (a tagged union carrying only the active kind's fields), this carries every
+ * field simultaneously so switching kind tabs doesn't lose whatever the user
+ * already entered for another kind (matches the vendored `FormState`
+ * schedule fields' behavior, minus everything else `FormState` carried).
+ */
+export interface ScheduleEditorState {
+    kind: ScheduleKind;
+    minute: number;
+    time: string;
+    weekday: Weekday;
+    timezone: string;
+}
+/**
+ * The decomposed, translation-ready pieces of a schedule summary. Produced
+ * by the pure `decomposeSchedule` (no i18n) so both a plain-string
+ * formatter and a structured-JSX renderer can share one source of truth;
+ * every string field here is plain English, meant to be passed through
+ * `useT()` at the call site (`rules.ts` stays hook-free by design).
+ */
+export type ScheduleSummaryParts = {
+    kind: 'hourly';
+    minute: string;
+} | {
+    kind: 'timed';
+    freq: string;
+    time: string;
+    tz: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/features/schedule-picker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/schedule-picker/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;uEACuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;oDACoD;AACpD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/features/schedule-picker/types.js

@@ -0,0 +1,9 @@
+/**
+ * Generic types for a "cron-lite" recurring-schedule value: hourly / daily /
+ * weekdays / weekly, each carrying only the fields that kind actually needs.
+ * Deliberately NOT the vendored `RoutineSchedule` contract type (r6 §1.19
+ * flags that as the one OD-specific piece of the schedule editor) — this is
+ * a standalone generic shape a host maps its own domain schedule onto.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/schedule-picker/types.js.map

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

package/dist/features/settings-dialog/index.d.ts

@@ -0,0 +1,7 @@
+export type { SettingsDialogChromeLabels, SettingsDialogTabMeta } from './types.js';
+export { findActiveTab, resolveInitialActiveTabId } from './rules.js';
+export { useSettingsDialogShell } from './react/hooks/useSettingsDialogShell.js';
+export type { SettingsDialogShellController, UseSettingsDialogShellParams, } from './react/hooks/useSettingsDialogShell.js';
+export { SettingsDialogShell } from './react/components/SettingsDialogShell.js';
+export type { SettingsDialogShellProps, SettingsDialogTab } from './react/components/SettingsDialogShell.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/settings-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/settings-dialog/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/features/settings-dialog/index.js

@@ -0,0 +1,4 @@
+export { findActiveTab, resolveInitialActiveTabId } from './rules.js';
+export { useSettingsDialogShell } from './react/hooks/useSettingsDialogShell.js';
+export { SettingsDialogShell } from './react/components/SettingsDialogShell.js';
+//# sourceMappingURL=index.js.map

package/dist/features/settings-dialog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/settings-dialog/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAMjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/features/settings-dialog/react/components/SettingsDialogShell.d.ts

@@ -0,0 +1,49 @@
+import type { ReactNode } from 'react';
+import type { SettingsDialogChromeLabels, SettingsDialogTabMeta } from '../../types.js';
+/** One sidebar-nav entry + its rendered panel. Extends the pure
+ *  `SettingsDialogTabMeta` shape with the render-specific fields
+ *  (`icon`/`panel`) that only make sense in the React layer. */
+export interface SettingsDialogTab<TId extends string = string> extends SettingsDialogTabMeta<TId> {
+    icon?: ReactNode;
+    panel: ReactNode;
+}
+export interface SettingsDialogShellProps<T extends SettingsDialogTab = SettingsDialogTab> {
+    tabs: readonly T[];
+    initialActiveTabId?: string;
+    activeTabId?: string;
+    onActiveTabIdChange?: (tabId: string) => void;
+    /** Closes the dialog (backdrop click, close button, Escape). Omit to
+     *  render the shell without a close affordance — e.g. embedded inline
+     *  rather than as a modal overlay. */
+    onClose?: () => void;
+    /** Renders the tall centered hero (kicker/title/subtitle) instead of the
+     *  normal per-tab header — e.g. a first-run "Welcome" variant. */
+    welcome?: boolean;
+    defaultSidebarCollapsed?: boolean;
+    /** Shows the fullscreen toggle button and applies its expanded state as a
+     *  modifier class. Defaults to `true`; a host with no use for fullscreen
+     *  can turn it off. */
+    fullscreenEnabled?: boolean;
+    defaultFullscreen?: boolean;
+    labels?: SettingsDialogChromeLabels;
+    /** Extra chrome rendered in the top-right strip, alongside the fullscreen
+     *  toggle and close button — e.g. a host's own autosave-status indicator.
+     *  Fully host-owned; the shell renders it as-is. */
+    chromeExtra?: ReactNode;
+    dialogAriaLabelledBy?: string;
+    className?: string;
+}
+/**
+ * Generic tabbed-settings-dialog chrome: modal backdrop + sidebar nav +
+ * active-panel switching + fullscreen/collapse/close affordances. Carries no
+ * opinion about what any tab contains — a host supplies `tabs`, each with
+ * its own `panel` (any `ReactNode`, including one of this package's own
+ * `tabs/*` components or a fully product-specific one).
+ *
+ * Proof this is separable from any one tab's content: in the origin
+ * `SettingsDialog.tsx`, 8 of its 17 real tabs were already separate files
+ * the original component merely mounted — the shell itself never reached
+ * into a tab's internals.
+ */
+export declare function SettingsDialogShell<T extends SettingsDialogTab>({ tabs, initialActiveTabId, activeTabId: controlledActiveTabId, onActiveTabIdChange, onClose, welcome, defaultSidebarCollapsed, fullscreenEnabled, defaultFullscreen, labels, chromeExtra, dialogAriaLabelledBy, className, }: SettingsDialogShellProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=SettingsDialogShell.d.ts.map

package/dist/features/settings-dialog/react/components/SettingsDialogShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsDialogShell.d.ts","sourceRoot":"","sources":["../../../../../src/features/settings-dialog/react/components/SettingsDialogShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAIxF;;gEAEgE;AAChE,MAAM,WAAW,iBAAiB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,qBAAqB,CAAC,GAAG,CAAC;IAChG,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IACvF,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;0CAEsC;IACtC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;sEACkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;2BAEuB;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;;wDAEoD;IACpD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,EAAE,EAC/D,IAAI,EACJ,kBAAkB,EAClB,WAAW,EAAE,qBAAqB,EAClC,mBAAmB,EACnB,OAAO,EACP,OAAe,EACf,uBAA+B,EAC/B,iBAAwB,EACxB,iBAAyB,EACzB,MAAM,EACN,WAAW,EACX,oBAA8C,EAC9C,SAAS,GACV,EAAE,wBAAwB,CAAC,CAAC,CAAC,+BAgJ7B"}

package/dist/features/settings-dialog/react/components/SettingsDialogShell.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useT } from '../../../i18n/index.js';
+import { Icon } from '../../../../react/components/Icon.js';
+import { findActiveTab } from '../../rules.js';
+import { useSettingsDialogShell } from '../hooks/useSettingsDialogShell.js';
+/**
+ * Generic tabbed-settings-dialog chrome: modal backdrop + sidebar nav +
+ * active-panel switching + fullscreen/collapse/close affordances. Carries no
+ * opinion about what any tab contains — a host supplies `tabs`, each with
+ * its own `panel` (any `ReactNode`, including one of this package's own
+ * `tabs/*` components or a fully product-specific one).
+ *
+ * Proof this is separable from any one tab's content: in the origin
+ * `SettingsDialog.tsx`, 8 of its 17 real tabs were already separate files
+ * the original component merely mounted — the shell itself never reached
+ * into a tab's internals.
+ */
+export function SettingsDialogShell({ tabs, initialActiveTabId, activeTabId: controlledActiveTabId, onActiveTabIdChange, onClose, welcome = false, defaultSidebarCollapsed = false, fullscreenEnabled = true, defaultFullscreen = false, labels, chromeExtra, dialogAriaLabelledBy = 'settings-dialog-title', className, }) {
+    const t = useT();
+    const shell = useSettingsDialogShell({
+        tabs,
+        initialActiveTabId,
+        activeTabId: controlledActiveTabId,
+        onActiveTabIdChange,
+        onClose,
+        defaultSidebarCollapsed,
+        defaultFullscreen,
+    });
+    const activeTab = findActiveTab(tabs, shell.activeTabId);
+    const kicker = labels?.kicker ?? t('Settings');
+    const welcomeKicker = labels?.welcomeKicker ?? t('Welcome');
+    const welcomeTitle = labels?.welcomeTitle ?? t('Get started');
+    const welcomeSubtitle = labels?.welcomeSubtitle ?? t('Set up your preferences before you begin.');
+    const closeLabel = labels?.closeLabel ?? t('Close');
+    const fullscreenLabel = labels?.fullscreenLabel ?? t('Fullscreen');
+    const exitFullscreenLabel = labels?.exitFullscreenLabel ?? t('Exit fullscreen');
+    const collapseSidebarLabel = labels?.collapseSidebarLabel ?? t('Collapse settings sidebar');
+    const expandSidebarLabel = labels?.expandSidebarLabel ?? t('Expand settings sidebar');
+    const sidebarAriaLabel = labels?.sidebarAriaLabel ?? t('Settings sections');
+    const sidebarToggleLabel = shell.sidebarCollapsed ? expandSidebarLabel : collapseSidebarLabel;
+    const fullscreenToggleLabel = shell.fullscreen ? exitFullscreenLabel : fullscreenLabel;
+    const dialogClassName = [
+        'jini-settings-dialog',
+        shell.sidebarCollapsed ? 'jini-settings-dialog-sidebar-collapsed' : '',
+        shell.fullscreen ? 'jini-settings-dialog-fullscreen' : '',
+        className ?? '',
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return (_jsx("div", { className: "jini-settings-dialog-backdrop", onClick: onClose, "data-testid": "settings-dialog-backdrop", children: _jsxs("div", { className: dialogClassName, role: "dialog", "aria-modal": "true", "aria-labelledby": dialogAriaLabelledBy, onClick: (event) => event.stopPropagation(), children: [_jsxs("div", { className: "jini-settings-dialog-chrome", children: [chromeExtra, fullscreenEnabled ? (_jsx("button", { type: "button", className: "jini-settings-dialog-chrome-btn jini-settings-dialog-fullscreen-toggle", onClick: shell.toggleFullscreen, "aria-label": fullscreenToggleLabel, "aria-pressed": shell.fullscreen, title: fullscreenToggleLabel, children: _jsx(Icon, { name: shell.fullscreen ? 'minimize' : 'maximize', size: 15, strokeWidth: 2 }) })) : null, onClose ? (_jsx("button", { type: "button", className: "jini-settings-dialog-chrome-btn jini-settings-dialog-close", onClick: onClose, "aria-label": closeLabel, title: closeLabel, children: _jsx(Icon, { name: "close", size: 16, strokeWidth: 2 }) })) : null] }), _jsx("header", { className: "jini-settings-dialog-head", id: dialogAriaLabelledBy, children: welcome ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "jini-settings-dialog-kicker", children: welcomeKicker }), _jsx("h2", { children: welcomeTitle }), _jsx("p", { className: "jini-settings-dialog-subtitle", children: welcomeSubtitle })] })) : (_jsxs(_Fragment, { children: [_jsx("span", { className: "jini-settings-dialog-kicker", children: kicker }), _jsxs("div", { className: "jini-settings-dialog-head-line", children: [_jsx("h2", { children: activeTab?.title ?? activeTab?.label ?? '' }), activeTab?.subtitle ? (_jsx("p", { className: "jini-settings-dialog-subtitle", children: activeTab.subtitle })) : null] })] })) }), _jsxs("div", { className: "jini-settings-dialog-body", children: [_jsx("button", { type: "button", className: "jini-settings-dialog-sidebar-toggle", onClick: shell.toggleSidebarCollapsed, "aria-label": sidebarToggleLabel, "aria-pressed": shell.sidebarCollapsed, "aria-controls": "jini-settings-dialog-sidebar", title: sidebarToggleLabel, children: _jsx(Icon, { name: shell.sidebarCollapsed ? 'chevron-right' : 'chevron-left', size: 15, strokeWidth: 2 }) }), _jsx("aside", { id: "jini-settings-dialog-sidebar", className: "jini-settings-dialog-sidebar", "aria-label": sidebarAriaLabel, "aria-hidden": shell.sidebarCollapsed ? true : undefined, children: tabs.map((tab) => {
+                                const active = tab.id === shell.activeTabId;
+                                return (_jsxs("button", { type: "button", className: `jini-settings-dialog-nav-item${active ? ' active' : ''}`, "aria-pressed": active, onClick: () => shell.setActiveTabId(tab.id), "data-testid": `settings-dialog-nav-${tab.id}`, children: [tab.icon, _jsxs("span", { children: [_jsx("strong", { children: tab.label }), tab.navHint ? _jsx("small", { children: tab.navHint }) : null] })] }, tab.id));
+                            }) }), _jsx("div", { className: "jini-settings-dialog-content", ref: shell.contentRef, children: activeTab?.panel })] })] }) }));
+}
+//# sourceMappingURL=SettingsDialogShell.js.map

package/dist/features/settings-dialog/react/components/SettingsDialogShell.js.map

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

package/dist/features/settings-dialog/react/hooks/useSettingsDialogShell.d.ts

@@ -0,0 +1,39 @@
+import type { RefObject } from 'react';
+import type { SettingsDialogTabMeta } from '../../types.js';
+export interface UseSettingsDialogShellParams<T extends SettingsDialogTabMeta> {
+    tabs: readonly T[];
+    /** Uncontrolled initial active tab id. Ignored once `activeTabId` (the
+     *  controlled prop) is supplied. */
+    initialActiveTabId?: string | undefined;
+    /** Controlled active tab id. Supply together with `onActiveTabIdChange` to
+     *  drive the active tab from host state (e.g. a route param); omit both
+     *  for uncontrolled internal state. */
+    activeTabId?: string | undefined;
+    onActiveTabIdChange?: ((tabId: string) => void) | undefined;
+    /** Closes the dialog. Wired to the backdrop click, the close button, and
+     *  the global Escape key — all three are standard modal affordances, not
+     *  settings-specific behavior. Omit to disable Escape-to-close and render
+     *  the shell without a close button (a host embedding the shell inline,
+     *  not as a modal). */
+    onClose?: (() => void) | undefined;
+    defaultSidebarCollapsed?: boolean | undefined;
+    defaultFullscreen?: boolean | undefined;
+}
+export interface SettingsDialogShellController {
+    activeTabId: string | null;
+    setActiveTabId: (tabId: string) => void;
+    sidebarCollapsed: boolean;
+    toggleSidebarCollapsed: () => void;
+    fullscreen: boolean;
+    toggleFullscreen: () => void;
+    contentRef: RefObject<HTMLDivElement | null>;
+}
+/**
+ * Owns the shell's own UI state: which tab is active, whether the sidebar is
+ * collapsed, whether the dialog is fullscreen, and the "scroll the content
+ * pane back to the top when the active tab changes" + "Escape closes the
+ * dialog" behaviors. None of this reads or writes any tab's own data — a
+ * tab's internal state (e.g. a draft config) stays owned by that tab.
+ */
+export declare function useSettingsDialogShell<T extends SettingsDialogTabMeta>({ tabs, initialActiveTabId, activeTabId: controlledActiveTabId, onActiveTabIdChange, onClose, defaultSidebarCollapsed, defaultFullscreen, }: UseSettingsDialogShellParams<T>): SettingsDialogShellController;
+//# sourceMappingURL=useSettingsDialogShell.d.ts.map

package/dist/features/settings-dialog/react/hooks/useSettingsDialogShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettingsDialogShell.d.ts","sourceRoot":"","sources":["../../../../../src/features/settings-dialog/react/hooks/useSettingsDialogShell.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI5D,MAAM,WAAW,4BAA4B,CAAC,CAAC,SAAS,qBAAqB;IAC3E,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB;wCACoC;IACpC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC;;2CAEuC;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,mBAAmB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5D;;;;2BAIuB;IACvB,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,qBAAqB,EAAE,EACtE,IAAI,EACJ,kBAAkB,EAClB,WAAW,EAAE,qBAAqB,EAClC,mBAAmB,EACnB,OAAO,EACP,uBAA+B,EAC/B,iBAAyB,GAC1B,EAAE,4BAA4B,CAAC,CAAC,CAAC,GAAG,6BAA6B,CA6CjE"}

package/dist/features/settings-dialog/react/hooks/useSettingsDialogShell.js

@@ -0,0 +1,50 @@
+import { useEffect, useRef, useState } from 'react';
+import { resolveInitialActiveTabId } from '../../rules.js';
+import { useDismissOnOutsideOrEscape } from '../../../../browser/useDismissOnOutsideOrEscape.js';
+/**
+ * Owns the shell's own UI state: which tab is active, whether the sidebar is
+ * collapsed, whether the dialog is fullscreen, and the "scroll the content
+ * pane back to the top when the active tab changes" + "Escape closes the
+ * dialog" behaviors. None of this reads or writes any tab's own data — a
+ * tab's internal state (e.g. a draft config) stays owned by that tab.
+ */
+export function useSettingsDialogShell({ tabs, initialActiveTabId, activeTabId: controlledActiveTabId, onActiveTabIdChange, onClose, defaultSidebarCollapsed = false, defaultFullscreen = false, }) {
+    const [uncontrolledActiveTabId, setUncontrolledActiveTabId] = useState(() => resolveInitialActiveTabId(tabs, initialActiveTabId));
+    const isControlled = controlledActiveTabId !== undefined;
+    const activeTabId = isControlled ? controlledActiveTabId : uncontrolledActiveTabId;
+    const setActiveTabId = (tabId) => {
+        if (!isControlled)
+            setUncontrolledActiveTabId(tabId);
+        onActiveTabIdChange?.(tabId);
+    };
+    const [sidebarCollapsed, setSidebarCollapsed] = useState(defaultSidebarCollapsed);
+    const toggleSidebarCollapsed = () => setSidebarCollapsed((current) => !current);
+    const [fullscreen, setFullscreen] = useState(defaultFullscreen);
+    const toggleFullscreen = () => setFullscreen((current) => !current);
+    const contentRef = useRef(null);
+    // Scroll the content pane back to the top whenever the active tab
+    // changes — without this, switching from a long tab the user had
+    // scrolled into a short one leaves the new tab's header out of view.
+    useEffect(() => {
+        const el = contentRef.current;
+        if (el)
+            el.scrollTop = 0;
+    }, [activeTabId]);
+    // Global Escape closes the dialog — standard modal affordance alongside
+    // the backdrop click and the close button. Routed through the shared
+    // `useDismissOnOutsideOrEscape` toolbox hook (packages/ui/src/browser/)
+    // in its Escape-only shape (no `containerRef` — the backdrop click is
+    // already handled separately by the host), matching the call site that
+    // hook's own doc comment names for this exact hook.
+    useDismissOnOutsideOrEscape(() => onClose?.(), { enabled: Boolean(onClose) });
+    return {
+        activeTabId,
+        setActiveTabId,
+        sidebarCollapsed,
+        toggleSidebarCollapsed,
+        fullscreen,
+        toggleFullscreen,
+        contentRef,
+    };
+}
+//# sourceMappingURL=useSettingsDialogShell.js.map

package/dist/features/settings-dialog/react/hooks/useSettingsDialogShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettingsDialogShell.js","sourceRoot":"","sources":["../../../../../src/features/settings-dialog/react/hooks/useSettingsDialogShell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAgCjG;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAkC,EACtE,IAAI,EACJ,kBAAkB,EAClB,WAAW,EAAE,qBAAqB,EAClC,mBAAmB,EACnB,OAAO,EACP,uBAAuB,GAAG,KAAK,EAC/B,iBAAiB,GAAG,KAAK,GACO;IAChC,MAAM,CAAC,uBAAuB,EAAE,0BAA0B,CAAC,GAAG,QAAQ,CAAgB,GAAG,EAAE,CACzF,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CACpD,CAAC;IACF,MAAM,YAAY,GAAG,qBAAqB,KAAK,SAAS,CAAC;IACzD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,uBAAuB,CAAC;IAEnF,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE;QACvC,IAAI,CAAC,YAAY;YAAE,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACrD,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAClF,MAAM,sBAAsB,GAAG,GAAG,EAAE,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAEhF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAChE,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAEvD,kEAAkE;IAClE,iEAAiE;IACjE,qEAAqE;IACrE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;QAC9B,IAAI,EAAE;YAAE,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,wEAAwE;IACxE,qEAAqE;IACrE,wEAAwE;IACxE,sEAAsE;IACtE,uEAAuE;IACvE,oDAAoD;IACpD,2BAA2B,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9E,OAAO;QACL,WAAW;QACX,cAAc;QACd,gBAAgB;QAChB,sBAAsB;QACtB,UAAU;QACV,gBAAgB;QAChB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/features/settings-dialog/rules.d.ts

@@ -0,0 +1,13 @@
+import type { SettingsDialogTabMeta } from './types.js';
+/**
+ * Resolves which tab id should be active: the requested id if it exists in
+ * `tabs`, otherwise the first tab's id, otherwise `null` (an empty tab
+ * list). Pulled out of the shell's `useState` initializer so it's testable
+ * without mounting React — a host that passes an `initialTabId` no longer
+ * present in `tabs` (e.g. a deep link to a since-removed tab) still lands on
+ * a valid tab instead of a blank content pane.
+ */
+export declare function resolveInitialActiveTabId<T extends SettingsDialogTabMeta>(tabs: readonly T[], initialTabId?: string | null): string | null;
+/** Finds a tab by id, or `undefined` if `activeTabId` is `null`/not present. */
+export declare function findActiveTab<T extends SettingsDialogTabMeta>(tabs: readonly T[], activeTabId: string | null): T | undefined;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/settings-dialog/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/settings-dialog/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,qBAAqB,EACvE,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,GAAG,IAAI,CAKf;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,CAAC,SAAS,qBAAqB,EAC3D,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,CAAC,GAAG,SAAS,CAGf"}

package/dist/features/settings-dialog/rules.js

@@ -0,0 +1,21 @@
+/**
+ * Resolves which tab id should be active: the requested id if it exists in
+ * `tabs`, otherwise the first tab's id, otherwise `null` (an empty tab
+ * list). Pulled out of the shell's `useState` initializer so it's testable
+ * without mounting React — a host that passes an `initialTabId` no longer
+ * present in `tabs` (e.g. a deep link to a since-removed tab) still lands on
+ * a valid tab instead of a blank content pane.
+ */
+export function resolveInitialActiveTabId(tabs, initialTabId) {
+    if (initialTabId != null && tabs.some((tab) => tab.id === initialTabId)) {
+        return initialTabId;
+    }
+    return tabs[0]?.id ?? null;
+}
+/** Finds a tab by id, or `undefined` if `activeTabId` is `null`/not present. */
+export function findActiveTab(tabs, activeTabId) {
+    if (activeTabId == null)
+        return undefined;
+    return tabs.find((tab) => tab.id === activeTabId);
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/settings-dialog/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/features/settings-dialog/rules.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAkB,EAClB,YAA4B;IAE5B,IAAI,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,YAAY,CAAC,EAAE,CAAC;QACxE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAC3B,IAAkB,EAClB,WAA0B;IAE1B,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;AACpD,CAAC"}

package/dist/features/settings-dialog/tabs/appearance/constants.d.ts

@@ -0,0 +1,12 @@
+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[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/settings-dialog/tabs/appearance/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/features/settings-dialog/tabs/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"}

package/dist/features/settings-dialog/tabs/appearance/constants.js

@@ -0,0 +1,10 @@
+/** 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' },
+];
+//# sourceMappingURL=constants.js.map

package/dist/features/settings-dialog/tabs/appearance/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/features/settings-dialog/tabs/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"}

package/dist/features/settings-dialog/tabs/appearance/index.d.ts

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

package/dist/features/settings-dialog/tabs/appearance/index.d.ts.map

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

package/dist/features/settings-dialog/tabs/appearance/index.js

@@ -0,0 +1,3 @@
+export { THEME_OPTIONS } from './constants.js';
+export { AppearanceTab } from './react/components/AppearanceTab.js';
+//# sourceMappingURL=index.js.map

package/dist/features/settings-dialog/tabs/appearance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/features/settings-dialog/tabs/appearance/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC"}