@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/system/system-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-config.d.ts","sourceRoot":"","sources":["../../../src/families/system/system-config.ts"],"names":[],"mappings":"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"}

package/dist/families/system/system-config.js

@@ -0,0 +1,339 @@
+/**
+ * `system` family config schemas + deterministic demo generators (annex §12) —
+ * PURE module (zod + system-lib only; no React, no @adminium/ui, no lucide).
+ *
+ * WHY THIS EXISTS: the registry metadata graph reaches this family through
+ * `system-track.definitions.ts`, which imports these schemas and `demoData`
+ * generators. Those must NOT drag the @adminium/ui-heavy components into the
+ * eager registry chunk — components load only through
+ * `lazy(() => import('./system-track-components.js'))` (one lazy chunk per
+ * family, 04 §2.3; the media/boards/kpi `*-config` convention). Component files
+ * re-export these symbols so barrel/story/test import points stay stable.
+ *
+ * FIELD-NAMING CONFIG (04 §5): system widgets bind to rows from real tables
+ * whose columns are named whatever the source schema calls them, so each widget
+ * takes `*Field` config naming which column carries what. Defaults match the
+ * annex's canonical contract; the auto-instantiation hook (annex §12) fills them
+ * from the classifier's enum/health semantics.
+ *
+ * LABELS: widgets are locale-agnostic (04 §2) — user-visible copy arrives as
+ * already-translated strings through config, with English developer fallbacks.
+ * The dashboard fills them from `t('…')`; en-US entries live at `widgets.system.*`.
+ *
+ * DETERMINISM (04 §7.7): every `demoData(seed)` is a pure function of `seed` —
+ * no `Date.now()`, no `Math.random()`. Timestamps derive from `SYSTEM_DEMO_EPOCH`.
+ */
+import { z } from 'zod';
+import { mulberry32 } from '@adminium/charts';
+import { AUTOSAVE_STATUSES, CONNECTION_STATES, LOG_LINE_KINDS, SERVICE_STATES, STATE_HERO_VIEWS, SYSTEM_TONES, } from './system-lib.js';
+import { widgetSharedConfigSchema } from '../../registry/shared-config.js';
+/**
+ * Fixed reference clock for every `system` demo payload — 2026-03-17T09:15:00Z.
+ * Demo data must be byte-identical across runs (04 §7.7 / the determinism gate),
+ * so relative stamps are offsets from this constant, never the wall clock.
+ */
+export const SYSTEM_DEMO_EPOCH = Date.UTC(2026, 2, 17, 9, 15, 0);
+const toneSchema = z.enum(SYSTEM_TONES);
+// ── state-hero (annex §12) ──────────────────────────────────────────────────
+/** One entry of the `stateMap` — the hero copy for a single view id. */
+export const stateHeroEntrySchema = z.object({
+    /** Tone-tinted glyph chip (lucide icon name). */
+    icon: z.string().optional(),
+    tone: toneSchema.default('neutral'),
+    /** Giant mono HTTP code behind the glyph; omitted for non-HTTP states. */
+    code: z.string().optional(),
+    title: z.string().optional(),
+    body: z.string().optional(),
+    primaryLabel: z.string().optional(),
+    primaryHref: z.string().optional(),
+    secondaryLabel: z.string().optional(),
+    secondaryHref: z.string().optional(),
+});
+export const stateHeroConfigSchema = widgetSharedConfigSchema.extend({
+    /** Which view of the map to render; the payload may override it (annex §12). */
+    view: z.enum(STATE_HERO_VIEWS).default('404'),
+    /** Per-view copy overrides, keyed by view id. Missing entries fall back to the built-in map. */
+    stateMap: z.record(z.enum(STATE_HERO_VIEWS), stateHeroEntrySchema).optional(),
+    /** 404 variant's floating decorative ornament (annex §12). */
+    ornament: z.boolean().default(false),
+    /** Quick-link chips under the CTA row (the 404 variant). */
+    quickLinks: z.array(z.object({ label: z.string(), href: z.string() })).optional(),
+    /** `req_…` support-handshake line, when the failure carried one. */
+    requestId: z.string().optional(),
+    /** Which field of the bound `record` carries the view id. */
+    viewField: z.string().default('view'),
+});
+export function stateHeroDemoData(seed) {
+    const random = mulberry32(seed);
+    const view = STATE_HERO_VIEWS[Math.floor(random() * STATE_HERO_VIEWS.length)] ?? '404';
+    return { row: { view } };
+}
+// ── empty-state (annex §12) ─────────────────────────────────────────────────
+export const emptyStateConfigSchema = widgetSharedConfigSchema.extend({
+    /** Annex §12 variants: plain, CTA, upload drop-zone. */
+    variant: z.enum(['plain', 'cta', 'dropzone']).default('plain'),
+    /** @adminium/ui copy preset used when `heading`/`body` are absent. */
+    preset: z.enum(['no-data', 'all-caught-up', 'no-matches', 'nothing-scheduled']).default('no-data'),
+    /** 56px tone-soft icon tile (lucide icon name). */
+    glyph: z.string().optional(),
+    /**
+     * The heading. NOTE: not `title` — `title` is the WidgetFrame header on every
+     * widget (shared config), and `empty-state` renders its own centred heading.
+     */
+    heading: z.string().optional(),
+    /** Muted body copy; the annex caps the measure at 36ch. */
+    body: z.string().optional(),
+    primaryLabel: z.string().optional(),
+    primaryHref: z.string().optional(),
+    secondaryLabel: z.string().optional(),
+    secondaryHref: z.string().optional(),
+    /** Dense variant for small hosts. */
+    compact: z.boolean().default(false),
+});
+/**
+ * `empty-state` is a `static` widget — its payload is its config (annex §12:
+ * "static per context, or derived boolean isEmpty from a filtered list"), so the
+ * demo payload is an empty envelope rather than fabricated rows.
+ */
+export function emptyStateDemoData() {
+    return {};
+}
+// ── status-pill (annex §12) ─────────────────────────────────────────────────
+export const statusPillConfigSchema = widgetSharedConfigSchema.extend({
+    /** Which field of the bound record carries the enum value. */
+    statusField: z.string().default('status'),
+    /** Annex §12 `map` {value: {label, tone}} — the LLM/heuristic-assigned tone map. */
+    map: z.record(z.string(), z.object({ label: z.string().optional(), tone: toneSchema.optional() })).optional(),
+    /** Tone used for a value absent from `map` and from the @adminium/ui default vocabulary. */
+    fallbackTone: toneSchema.default('neutral'),
+    /** Show the leading colored dot (annex §12 `dot`). */
+    dot: z.boolean().default(true),
+});
+const DEMO_STATUSES = ['active', 'pending', 'failed', 'paid', 'refunded', 'draft'];
+export function statusPillDemoData(seed) {
+    const random = mulberry32(seed);
+    return { row: { status: DEMO_STATUSES[Math.floor(random() * DEMO_STATUSES.length)] ?? 'active' } };
+}
+// ── alert-banner (annex §12) ────────────────────────────────────────────────
+export const alertBannerConfigSchema = widgetSharedConfigSchema.extend({
+    severityField: z.string().default('severity'),
+    messageField: z.string().default('message'),
+    /** Bold stat lead rendered before the copy (annex §12 "bold stat lead or icon"). */
+    leadField: z.string().default('lead'),
+    ctaLabelField: z.string().default('ctaLabel'),
+    ctaHrefField: z.string().default('ctaHref'),
+    /** Severity → @adminium/ui Alert tone. Values outside the map fall back to `info`. */
+    severityMap: z.record(z.string(), z.enum(['info', 'pos', 'warn', 'danger'])).optional(),
+    dismissible: z.boolean().default(false),
+    dismissLabel: z.string().optional(),
+});
+const DEMO_ALERTS = [
+    { severity: 'warn', lead: '92% disk used', message: 'The meta-store volume is approaching capacity.', ctaLabel: 'Free up space', ctaHref: '/settings/storage' },
+    { severity: 'info', lead: 'Recurring', message: 'This schedule repeats monthly on the 1st.', ctaLabel: 'Edit schedule', ctaHref: '/settings/schedules' },
+    { severity: 'danger', lead: 'Deploy freeze', message: 'Releases are paused until the incident is resolved.', ctaLabel: 'View incident', ctaHref: '/status' },
+    { severity: 'pos', lead: 'Rebalanced', message: 'Workload was redistributed across 4 teammates.', ctaLabel: 'Review', ctaHref: '/team/workload' },
+];
+export function alertBannerDemoData(seed) {
+    const random = mulberry32(seed);
+    const pick = DEMO_ALERTS[Math.floor(random() * DEMO_ALERTS.length)] ?? DEMO_ALERTS[0];
+    return { row: { ...pick } };
+}
+// ── status-banner-hero (annex §12) ──────────────────────────────────────────
+export const statusBannerHeroConfigSchema = widgetSharedConfigSchema.extend({
+    /** Which field of each service row carries its `up|degraded|down` state. */
+    stateField: z.string().default('state'),
+    nameField: z.string().default('name'),
+    /**
+     * The inline right-aligned mono KPI trio (annex §12 "+ inline right-aligned
+     * mono KPI trio"). Each entry names a field on the FIRST row of the payload.
+     */
+    stats: z
+        .array(z.object({ key: z.string(), label: z.string().optional(), unit: z.string().optional() }))
+        .max(3)
+        .optional(),
+    /** Per-state hero copy (annex §12 `stateStyles`). */
+    titles: z.record(z.enum(SERVICE_STATES), z.string()).optional(),
+    bodies: z.record(z.enum(SERVICE_STATES), z.string()).optional(),
+});
+const DEMO_SERVICES = ['API', 'Dashboard', 'Webhooks', 'Exports', 'Search'];
+export function statusBannerHeroDemoData(seed) {
+    const random = mulberry32(seed);
+    const rows = DEMO_SERVICES.map((name, index) => {
+        const roll = random();
+        // Weighted so the demo hero is usually "up" but not always — the worst-wins
+        // aggregate needs a degraded/down case to be visible across seeds.
+        const state = roll > 0.88 ? 'down' : roll > 0.68 ? 'degraded' : 'up';
+        return {
+            name,
+            state,
+            uptime: Number((99.2 + random() * 0.79).toFixed(2)),
+            p95: Math.round(80 + random() * 240),
+            incidents: index === 0 ? Math.round(random() * 3) : 0,
+        };
+    });
+    return {
+        rows,
+        columns: [
+            { name: 'name', label: 'Service' },
+            { name: 'state', label: 'State' },
+            { name: 'uptime', label: 'Uptime' },
+            { name: 'p95', label: 'p95' },
+            { name: 'incidents', label: 'Incidents' },
+        ],
+        total: rows.length,
+    };
+}
+// ── connection-status (annex §12) ───────────────────────────────────────────
+export const connectionStatusConfigSchema = widgetSharedConfigSchema.extend({
+    stateField: z.string().default('state'),
+    hostField: z.string().default('host'),
+    /** Detail line under the headline (error text on `failed`, table count on `connected`). */
+    detailField: z.string().default('detail'),
+    /** Per-state headline copy (annex §12 `messages`). */
+    messages: z.record(z.enum(CONNECTION_STATES), z.string()).optional(),
+    /** Render the inline Test action that re-issues the check. */
+    testable: z.boolean().default(false),
+    testLabel: z.string().optional(),
+});
+const DEMO_HOSTS = ['db.prod.internal:5432', 'analytics.eu-west.rds:5432', 'localhost:3306', 'shop.cluster.local:5432'];
+export function connectionStatusDemoData(seed) {
+    const random = mulberry32(seed);
+    const host = DEMO_HOSTS[Math.floor(random() * DEMO_HOSTS.length)] ?? DEMO_HOSTS[0];
+    const roll = random();
+    const state = roll > 0.82 ? 'failed' : roll > 0.62 ? 'connecting' : 'connected';
+    const detail = state === 'connected'
+        ? `${Math.round(6 + random() * 40)} tables detected`
+        : state === 'failed'
+            ? 'Connection refused — check the host and port.'
+            : undefined;
+    return { row: detail === undefined ? { state, host } : { state, host, detail } };
+}
+// ── autosave-indicator (annex §12) ──────────────────────────────────────────
+export const autosaveIndicatorConfigSchema = widgetSharedConfigSchema.extend({
+    dirtyField: z.string().default('dirty'),
+    savingField: z.string().default('saving'),
+    /** Epoch-ms of the last successful save; stamps the "saved at" time. */
+    savedAtField: z.string().default('savedAt'),
+    errorField: z.string().default('error'),
+    /** Annex §12 `debounceMs` — the host's dirty→save debounce; surfaced for the info popover. */
+    debounceMs: z.number().int().min(0).max(10_000).default(900),
+    /** Show the "· HH:MM" stamp after "All changes saved". */
+    showStamp: z.boolean().default(true),
+    idleLabel: z.string().optional(),
+    dirtyLabel: z.string().optional(),
+    savingLabel: z.string().optional(),
+    savedLabel: z.string().optional(),
+    errorLabel: z.string().optional(),
+});
+export function autosaveIndicatorDemoData(seed) {
+    const random = mulberry32(seed);
+    const roll = random();
+    const status = roll > 0.8 ? 'saving' : roll > 0.55 ? 'dirty' : 'saved';
+    return {
+        row: {
+            dirty: status === 'dirty',
+            saving: status === 'saving',
+            error: false,
+            // Offset from the fixed demo epoch — never Date.now() (04 §7.7).
+            savedAt: SYSTEM_DEMO_EPOCH - Math.round(random() * 9) * 60_000,
+        },
+    };
+}
+// ── progress-log-console (annex §12) ────────────────────────────────────────
+export const progressLogConsoleConfigSchema = widgetSharedConfigSchema.extend({
+    /** Annex §12 `variant`: the live streaming console vs the static terminal sim. */
+    variant: z.enum(['live', 'static-terminal']).default('live'),
+    textField: z.string().default('text'),
+    kindField: z.string().default('kind'),
+    /** Optional per-line 0–100 used to drive the paired determinate bar. */
+    pctField: z.string().default('pct'),
+    /** Render the paired determinate progress bar + mono % (annex §12). */
+    showProgress: z.boolean().default(true),
+    /** Cap on rendered lines; the console keeps the most RECENT `maxLines`. */
+    maxLines: z.number().int().min(3).max(500).default(200),
+    /** Auto-scroll to the newest line as the stream appends. */
+    follow: z.boolean().default(true),
+    a11yLabel: z.string().optional(),
+    progressLabel: z.string().optional(),
+    emptyTitle: z.string().optional(),
+    emptyBody: z.string().optional(),
+});
+/** The introspection script the annex's evidence comps narrate (Connect Database). */
+const DEMO_LOG_SCRIPT = [
+    { kind: 'info', text: '$ adminium introspect --connection prod' },
+    { kind: 'ok', text: 'Connected to db.prod.internal:5432 (PostgreSQL 16.2)' },
+    { kind: 'ok', text: 'Read 14 tables, 3 views, 118 columns' },
+    { kind: 'ok', text: 'Resolved 9 foreign keys, 2 self-references' },
+    { kind: 'warn', text: 'orders.notes: 41% NULL — excluded from the list view' },
+    { kind: 'ok', text: 'Classified 6 enum columns, 4 money columns' },
+    { kind: 'warn', text: 'customers.ssn: looks like PII — masked by default' },
+    { kind: 'ok', text: 'Generated 14 CRUD pages, 3 dashboards' },
+    { kind: 'running', text: 'Building widget bindings…' },
+];
+export function progressLogConsoleDemoData(seed) {
+    const random = mulberry32(seed);
+    // Seed decides how far the run has progressed — always at least the first
+    // three lines so the demo never renders an ambiguous 1-line console.
+    const count = 3 + Math.floor(random() * (DEMO_LOG_SCRIPT.length - 2));
+    const rows = DEMO_LOG_SCRIPT.slice(0, count).map((line, index) => ({
+        id: `log-${index}`,
+        kind: line.kind,
+        text: line.text,
+        pct: Math.round(((index + 1) / DEMO_LOG_SCRIPT.length) * 100),
+    }));
+    return {
+        rows,
+        columns: [
+            { name: 'kind', label: 'Kind' },
+            { name: 'text', label: 'Line' },
+            { name: 'pct', label: 'Progress' },
+        ],
+        total: rows.length,
+    };
+}
+// ── diagnostics-readout (annex §12) ─────────────────────────────────────────
+export const diagnosticsReadoutConfigSchema = widgetSharedConfigSchema.extend({
+    /**
+     * The checks to read off the bound record, in render order (annex §12
+     * `checks`). Each names a field; `tones` maps that field's VALUE to a tone so
+     * "Reachable"/"Refused" colour themselves.
+     */
+    checks: z
+        .array(z.object({
+        key: z.string(),
+        label: z.string().optional(),
+        tones: z.record(z.string(), toneSchema).optional(),
+        mono: z.boolean().default(true),
+    }))
+        .optional(),
+    /** Epoch-ms freshness stamp field (annex §12 "+ last-checked timestamp"). */
+    checkedAtField: z.string().default('checkedAt'),
+    checkedAtLabel: z.string().optional(),
+});
+export function diagnosticsReadoutDemoData(seed) {
+    const random = mulberry32(seed);
+    const reachable = random() > 0.35;
+    return {
+        row: {
+            host: 'db.prod.internal:5432',
+            dns: reachable ? 'Resolved' : 'Resolved',
+            tcp: reachable ? 'Reachable' : 'Refused',
+            tls: reachable ? 'Verified' : 'Not attempted',
+            auth: reachable ? 'Accepted' : 'Not attempted',
+            latency: `${Math.round(4 + random() * 60)} ms`,
+            checkedAt: SYSTEM_DEMO_EPOCH - Math.round(random() * 5) * 60_000,
+        },
+    };
+}
+/** The default check list rendered when config supplies none. */
+export const DEFAULT_DIAGNOSTIC_CHECKS = [
+    { key: 'host', label: 'Host' },
+    { key: 'dns', label: 'DNS', tones: { Resolved: 'pos', Failed: 'danger' } },
+    { key: 'tcp', label: 'TCP', tones: { Reachable: 'pos', Refused: 'danger', Timeout: 'danger' } },
+    { key: 'tls', label: 'TLS', tones: { Verified: 'pos', 'Not attempted': 'neutral', Invalid: 'danger' } },
+    { key: 'auth', label: 'Auth', tones: { Accepted: 'pos', 'Not attempted': 'neutral', Rejected: 'danger' } },
+    { key: 'latency', label: 'Latency' },
+];
+/** Re-exported vocabularies so the component files import one module. */
+export { AUTOSAVE_STATUSES, CONNECTION_STATES, LOG_LINE_KINDS, SERVICE_STATES, STATE_HERO_VIEWS };
+//# sourceMappingURL=system-config.js.map

package/dist/families/system/system-config.js.map

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

package/dist/families/system/system-icons.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+import { STATE_HERO_VIEWS } from './system-lib.js';
+import type { StateHeroViewId } from './system-lib.js';
+/** Resolve a config icon name to a glyph; unknown/absent names render nothing. */
+export declare function systemIcon(name: string | undefined): ReactNode | undefined;
+export declare function stateHeroIcon(view: StateHeroViewId): ReactNode;
+/** Every id the closed vocabulary accepts — used by the family's tests. */
+export declare const SYSTEM_ICON_NAMES: readonly string[];
+export { STATE_HERO_VIEWS };
+//# sourceMappingURL=system-icons.d.ts.map

package/dist/families/system/system-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-icons.d.ts","sourceRoot":"","sources":["../../../src/families/system/system-icons.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAqCvD,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAG1E;AAYD,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,CAE9D;AAED,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAA8B,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/families/system/system-icons.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AlertTriangle, Ban, CheckCircle2, CircleAlert, Clock, Compass, Database, FileQuestion, Inbox, Loader2, Lock, Plug, Search, ServerCrash, Settings, ShieldAlert, Wifi, WifiOff, Wrench, } from 'lucide-react';
+import { STATE_HERO_VIEWS } from './system-lib.js';
+/**
+ * The `system` family's CLOSED glyph vocabulary (annex §12). Separated from
+ * `system-lib.ts` so that module stays JSX-free and the registry-metadata graph
+ * (`system-config.ts`) never pulls `lucide-react` into the eager chunk
+ * (04 §2.3; the `media/media-icons` + `feeds/feed-icons` convention).
+ *
+ * WHY A CLOSED MAP: config carries an icon NAME (a string that survives JSON
+ * round-trips into the page manifest), never a component. Resolving it through a
+ * fixed map means a stored config — or a payload — can never make a widget
+ * render an arbitrary icon, and the family's lucide imports stay statically
+ * analysable for tree-shaking.
+ */
+const SYSTEM_ICONS = {
+    alert: _jsx(CircleAlert, {}),
+    ban: _jsx(Ban, {}),
+    check: _jsx(CheckCircle2, {}),
+    clock: _jsx(Clock, {}),
+    compass: _jsx(Compass, {}),
+    database: _jsx(Database, {}),
+    inbox: _jsx(Inbox, {}),
+    lock: _jsx(Lock, {}),
+    plug: _jsx(Plug, {}),
+    search: _jsx(Search, {}),
+    settings: _jsx(Settings, {}),
+    shield: _jsx(ShieldAlert, {}),
+    spinner: _jsx(Loader2, {}),
+    'server-crash': _jsx(ServerCrash, {}),
+    warning: _jsx(AlertTriangle, {}),
+    wifi: _jsx(Wifi, {}),
+    'wifi-off': _jsx(WifiOff, {}),
+    wrench: _jsx(Wrench, {}),
+    question: _jsx(FileQuestion, {}),
+};
+/** Resolve a config icon name to a glyph; unknown/absent names render nothing. */
+export function systemIcon(name) {
+    if (name === undefined)
+        return undefined;
+    return SYSTEM_ICONS[name];
+}
+/** The built-in `state-hero` glyph per view id (annex §12 `stateMap` defaults). */
+const STATE_HERO_ICON = {
+    '404': _jsx(Compass, {}),
+    '500': _jsx(ServerCrash, {}),
+    offline: _jsx(WifiOff, {}),
+    forbidden: _jsx(Lock, {}),
+    maintenance: _jsx(Wrench, {}),
+    'conn-error': _jsx(Database, {}),
+};
+export function stateHeroIcon(view) {
+    return STATE_HERO_ICON[view];
+}
+/** Every id the closed vocabulary accepts — used by the family's tests. */
+export const SYSTEM_ICON_NAMES = Object.keys(SYSTEM_ICONS);
+export { STATE_HERO_VIEWS };
+//# sourceMappingURL=system-icons.js.map

package/dist/families/system/system-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-icons.js","sourceRoot":"","sources":["../../../src/families/system/system-icons.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,GAAG,EACH,YAAY,EACZ,WAAW,EACX,KAAK,EACL,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,OAAO,EACP,MAAM,GACP,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD;;;;;;;;;;;GAWG;AAEH,MAAM,YAAY,GAA8B;IAC9C,KAAK,EAAE,KAAC,WAAW,KAAG;IACtB,GAAG,EAAE,KAAC,GAAG,KAAG;IACZ,KAAK,EAAE,KAAC,YAAY,KAAG;IACvB,KAAK,EAAE,KAAC,KAAK,KAAG;IAChB,OAAO,EAAE,KAAC,OAAO,KAAG;IACpB,QAAQ,EAAE,KAAC,QAAQ,KAAG;IACtB,KAAK,EAAE,KAAC,KAAK,KAAG;IAChB,IAAI,EAAE,KAAC,IAAI,KAAG;IACd,IAAI,EAAE,KAAC,IAAI,KAAG;IACd,MAAM,EAAE,KAAC,MAAM,KAAG;IAClB,QAAQ,EAAE,KAAC,QAAQ,KAAG;IACtB,MAAM,EAAE,KAAC,WAAW,KAAG;IACvB,OAAO,EAAE,KAAC,OAAO,KAAG;IACpB,cAAc,EAAE,KAAC,WAAW,KAAG;IAC/B,OAAO,EAAE,KAAC,aAAa,KAAG;IAC1B,IAAI,EAAE,KAAC,IAAI,KAAG;IACd,UAAU,EAAE,KAAC,OAAO,KAAG;IACvB,MAAM,EAAE,KAAC,MAAM,KAAG;IAClB,QAAQ,EAAE,KAAC,YAAY,KAAG;CAC3B,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,IAAwB;IACjD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,mFAAmF;AACnF,MAAM,eAAe,GAAuC;IAC1D,KAAK,EAAE,KAAC,OAAO,KAAG;IAClB,KAAK,EAAE,KAAC,WAAW,KAAG;IACtB,OAAO,EAAE,KAAC,OAAO,KAAG;IACpB,SAAS,EAAE,KAAC,IAAI,KAAG;IACnB,WAAW,EAAE,KAAC,MAAM,KAAG;IACvB,YAAY,EAAE,KAAC,QAAQ,KAAG;CAC3B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAqB;IACjD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/families/system/system-lib.d.ts

@@ -0,0 +1,108 @@
+/**
+ * `system` family shared helpers (annex §12) — PURE module (no React, no
+ * @adminium/ui, no lucide). Imported by both the family's config module and its
+ * components, so the registry metadata graph can reach the schemas + demo
+ * generators without dragging component code into the eager chunk (04 §2.3).
+ *
+ * The readers here are deliberately LENIENT: system widgets bind to whatever a
+ * real table/health-check returns, and a malformed payload must degrade to a
+ * fallback render rather than throw into the WidgetErrorBoundary (04 §3).
+ */
+/** The tone vocabulary shared with @adminium/ui's `IconTile`/`Badge`. */
+export declare const SYSTEM_TONES: readonly ["neutral", "accent", "pos", "warn", "danger", "info"];
+export type SystemTone = (typeof SYSTEM_TONES)[number];
+/**
+ * Map the SHARED-CONFIG tone vocabulary onto @adminium/ui's.
+ *
+ * The two differ by exactly one member and it is not an oversight: shared config
+ * (04 §2.1) offers `muted` — an authoring word for "de-emphasised" — while the
+ * design system's `Tone` calls that same slot `neutral`. Every widget that
+ * forwards `config.tone` to a UI primitive must translate, so the mapping lives
+ * here once rather than being re-derived (and re-mistaken) per widget.
+ */
+export declare function uiToneOf(tone: string | undefined, fallback?: SystemTone): SystemTone;
+/**
+ * The `state-hero` view vocabulary (annex §12: "stateMap keyed by view id
+ * (404/500/offline/forbidden/maintenance/conn-error)"). Closed vocabulary — a
+ * stored config can never smuggle an unknown view past the schema.
+ */
+export declare const STATE_HERO_VIEWS: readonly ["404", "500", "offline", "forbidden", "maintenance", "conn-error"];
+export type StateHeroViewId = (typeof STATE_HERO_VIEWS)[number];
+/** Per-line kind in `progress-log-console` (mirrors the Studio LogConsole vocabulary). */
+export declare const LOG_LINE_KINDS: readonly ["info", "ok", "warn", "error", "running"];
+export type LogLineKind = (typeof LOG_LINE_KINDS)[number];
+/** `connection-status` state machine (annex §12: connecting → connected | failed). */
+export declare const CONNECTION_STATES: readonly ["idle", "connecting", "connected", "failed"];
+export type ConnectionState = (typeof CONNECTION_STATES)[number];
+/**
+ * `autosave-indicator` phases (annex §12: warn-dot "Unsaved changes" → spinner
+ * "Saving…" → green check "All changes saved"). Mirrors @adminium/ui's
+ * `AutosaveStatus` exactly — `dirty` was added there for this annex requirement.
+ */
+export declare const AUTOSAVE_STATUSES: readonly ["idle", "dirty", "saving", "saved", "error"];
+export type AutosaveStatus = (typeof AUTOSAVE_STATUSES)[number];
+/** Aggregate service health, worst-wins (annex §12 `status-banner-hero`). */
+export declare const SERVICE_STATES: readonly ["up", "degraded", "down"];
+export type ServiceState = (typeof SERVICE_STATES)[number];
+/** The `connectionId` + qualified table a `mutate`/`record-open` event carries. */
+export interface BindingSource {
+    connectionId: string;
+    table: string;
+}
+/**
+ * The event target for a bound widget: `connectionId` + the schema-qualified
+ * table name, or `null` when the widget is running on `demoData` (no binding).
+ * An unbound widget must not offer write affordances — there is nowhere to send
+ * the intent — so callers use `null` to disable them (04 §5).
+ */
+export declare function bindingSourceOf(binding: {
+    connectionId: string;
+    source: {
+        schema?: string | undefined;
+        name: string;
+    };
+} | undefined): BindingSource | null;
+type Rec = Record<string, unknown>;
+/**
+ * Read the single row out of a §3 `record` envelope. Also accepts a bare object
+ * so template/story composition can hand a widget its row directly.
+ */
+export declare function recordRowOf(data: unknown): Rec | null;
+/**
+ * Read the rows out of a §3 `record-list` envelope (or a bare array / `stream`
+ * snapshot).
+ *
+ * Every element is checked to be a real object and non-objects are DROPPED, not
+ * cast: a payload like `{ rows: [null, 'x', 3] }` is not hypothetical — a driver
+ * returning a sparse result, or a `stream` snapshot carrying a tombstone, both
+ * produce it, and blind-casting turns the next `row[field]` access into a
+ * TypeError inside render (an error-boundary trip, i.e. a dead widget). Callers
+ * are guaranteed indexable rows.
+ */
+export declare function recordRowsOf(data: unknown): Rec[];
+/** Read a string-ish field off an untrusted row (finite numbers coerce; else undefined). */
+export declare function stringField(row: Rec, field: string): string | undefined;
+/** Read a finite-number field off an untrusted row (numeric strings coerce). */
+export declare function numberField(row: Rec, field: string): number | undefined;
+/** Read a boolean-ish field off an untrusted row (accepts 0/1 and 'true'/'false'). */
+export declare function booleanField(row: Rec, field: string): boolean | undefined;
+/** Clamp an arbitrary number into the 0–100 percent range; non-finite → 0. */
+export declare function clampPct(value: number | undefined): number;
+/** Narrow an untrusted value to a member of a closed vocabulary, else `fallback`. */
+export declare function oneOf<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T;
+/**
+ * Worst-wins aggregate of a service list (annex §12 `status-banner-hero`:
+ * "bg/border/icon/title derive from worst child state").
+ */
+export declare function worstServiceState(states: readonly ServiceState[]): ServiceState;
+/** Fall back to `en-US` when a widget's config carries no locale override (04 §2). */
+export declare function resolveLocale(locale: string | undefined): string;
+/**
+ * Format an epoch-ms timestamp as a locale-aware short time ("14:32"), used for
+ * the "last checked" / "saved at" stamps. Goes through the @adminium/i18n Intl
+ * layer (10-i18n-theming.md §4) rather than raw `Intl` so numbering systems and
+ * the data/prose context rules stay consistent with the rest of the product.
+ */
+export declare function formatStamp(epochMs: number | undefined, locale: string | undefined): string | undefined;
+export {};
+//# sourceMappingURL=system-lib.d.ts.map

package/dist/families/system/system-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-lib.d.ts","sourceRoot":"","sources":["../../../src/families/system/system-lib.ts"],"names":[],"mappings":"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"}