@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/forms/forms-lib.js

@@ -0,0 +1,176 @@
+/**
+ * `forms` family shared helpers (annex §10) — 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).
+ */
+import { getFormatters } from '@adminium/i18n';
+/** Fall back to `en-US` when a widget's config carries no locale override (04 §2). */
+export function resolveLocale(locale) {
+    return locale !== undefined && locale.trim() !== '' ? locale : 'en-US';
+}
+/** The tone vocabulary shared with @adminium/ui's `IconTile`/`Badge`. */
+export const FORM_TONES = ['neutral', 'accent', 'pos', 'warn', 'danger', 'info'];
+/**
+ * Map the SHARED-CONFIG tone vocabulary onto @adminium/ui's — see the identical
+ * note in `system-lib.uiToneOf`: shared config says `muted` where the design
+ * system says `neutral`, and every widget forwarding `config.tone` must translate.
+ */
+export function uiToneOf(tone, fallback = 'neutral') {
+    if (tone === undefined)
+        return fallback;
+    if (tone === 'muted')
+        return 'neutral';
+    return FORM_TONES.includes(tone) ? tone : fallback;
+}
+/** `stepper` per-step states (annex §10; mirrors @adminium/ui `StepState`). */
+export const STEP_STATES = ['pending', 'active', 'loading', 'done', 'error'];
+/** `validation-issues-list` severities (annex §10 `severityMap`). */
+export const ISSUE_SEVERITIES = ['info', 'warn', 'error'];
+/** Severity → tone. The default map the annex's `severityMap` config overrides. */
+export const DEFAULT_SEVERITY_TONE = {
+    info: 'info',
+    warn: 'warn',
+    error: 'danger',
+};
+function rec(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
+}
+/**
+ * Read the rows out of a §3 `record-list` envelope (or a bare array). Non-object
+ * elements are DROPPED rather than cast — see the identical note in
+ * `system-lib.recordRowsOf`.
+ */
+export function recordRowsOf(data) {
+    const raw = pickRowArray(data);
+    const out = [];
+    for (const entry of raw) {
+        const row = rec(entry);
+        if (row !== null)
+            out.push(row);
+    }
+    return out;
+}
+function pickRowArray(data) {
+    if (Array.isArray(data))
+        return data;
+    const envelope = rec(data);
+    if (envelope === null)
+        return [];
+    for (const key of ['rows', 'snapshot', 'data']) {
+        const value = envelope[key];
+        if (Array.isArray(value))
+            return value;
+    }
+    return [];
+}
+/**
+ * Read the single row out of a §3 `record` envelope (`{ row: {...} }`), or
+ * `null`. A bare object is accepted so template/story composition can hand a row
+ * directly — the same latitude `formValuesOf` gives `form-state`.
+ */
+export function recordRowOf(data) {
+    const envelope = rec(data);
+    if (envelope === null)
+        return null;
+    if ('row' in envelope)
+        return rec(envelope['row']);
+    return envelope;
+}
+/**
+ * Read the `entries` map out of a §3 `boolean-map` envelope. Non-boolean values
+ * are dropped: a `boolean-map` whose values are strings is a server bug, and
+ * silently coercing `"false"` to `true` would flip a user's setting.
+ */
+export function booleanEntriesOf(data) {
+    const envelope = rec(data);
+    const entries = rec(envelope?.entries) ?? envelope;
+    if (entries === null)
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(entries)) {
+        if (typeof value === 'boolean')
+            out[key] = value;
+    }
+    return out;
+}
+/** Read a string-ish field off an untrusted row (finite numbers coerce; else undefined). */
+export function stringField(row, field) {
+    const value = row[field];
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+/** Read a finite-number field off an untrusted row (numeric strings coerce). */
+export function numberField(row, field) {
+    const value = row[field];
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+/** Read a boolean-ish field off an untrusted row (accepts 0/1 and 'true'/'false'). */
+export function booleanField(row, field) {
+    const value = row[field];
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value !== 0;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    return undefined;
+}
+/** Narrow an untrusted value to a member of a closed vocabulary, else `fallback`. */
+export function oneOf(value, allowed, fallback) {
+    return typeof value === 'string' && allowed.includes(value) ? value : fallback;
+}
+/** Clamp an arbitrary number into the 0–100 percent range; non-finite → 0. */
+export function clampPct(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return 0;
+    return Math.min(100, Math.max(0, value));
+}
+/**
+ * Facet counts over a `record-list`, keyed by one field — the live count pills
+ * in `filter-chip-bar` (annex §10: "live mono count pills computed from the
+ * sibling list"). Insertion order follows first appearance, so the bar's chip
+ * order is stable across renders of the same payload.
+ */
+export function facetCountsOf(rows, field) {
+    const counts = new Map();
+    for (const row of rows) {
+        const value = stringField(row, field);
+        if (value === undefined)
+            continue;
+        counts.set(value, (counts.get(value) ?? 0) + 1);
+    }
+    return counts;
+}
+/** Localized compact count for the chip/checklist count pills, via the @adminium/i18n Intl layer. */
+export function formatCount(count, locale) {
+    if (count === undefined || !Number.isFinite(count))
+        return undefined;
+    return getFormatters(resolveLocale(locale)).compact(count);
+}
+/** Localized byte size for the table-inclusion checklist's row estimates. */
+export function formatRows(count, locale) {
+    if (count === undefined || !Number.isFinite(count))
+        return undefined;
+    return getFormatters(resolveLocale(locale)).number(count);
+}
+/**
+ * The password-strength score (annex §10: "4-segment bar filled by score").
+ * Re-exported from the widget rather than reimplemented — @adminium/ui owns
+ * `defaultPasswordScore`, and a second scoring rule would drift from the one the
+ * auth screens already use.
+ */
+export const PASSWORD_SCORE_MAX = 4;
+//# sourceMappingURL=forms-lib.js.map

package/dist/families/forms/forms-lib.js.map

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

package/dist/families/forms/forms-state.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `form-state` payload readers + the write target (annex §10; 04 §3) — PURE
+ * module. Split from `forms-lib.ts` because these two concerns are what every
+ * INPUT widget in the family shares, and keeping them together makes the write
+ * model reviewable in one place.
+ *
+ * THE WRITE MODEL (04 §2.1): forms widgets are controlled by local state and
+ * report changes as `mutate` INTENTS — they never persist. The host runs the
+ * intent through the CRUD API (with undo + audit). An UNBOUND instance (demo
+ * data, a story, the widget palette) has no target, so `bindingTargetOf` returns
+ * `null` and callers skip the intent rather than emitting one into the void.
+ */
+import type { FormFieldConfig } from './forms-config.js';
+type Rec = Record<string, unknown>;
+/** The `connectionId` + qualified table a `mutate` event carries. */
+export interface BindingTarget {
+    connectionId: string;
+    table: string;
+}
+/**
+ * The write target for a bound widget, or `null` when the widget is running on
+ * `demoData`. An unbound widget must not offer a write affordance — there is
+ * nowhere to send the intent (04 §5).
+ */
+export declare function bindingTargetOf(binding: {
+    connectionId: string;
+    source: {
+        schema?: string | undefined;
+        name: string;
+    };
+} | undefined): BindingTarget | null;
+/**
+ * Read the `values` map out of a §3 `form-state` envelope
+ * (`{ fields: FieldDef[]; values: Record<string, unknown> }`). Also accepts a
+ * bare values object so template/story composition can hand values directly.
+ */
+export declare function formValuesOf(data: unknown): Rec;
+/**
+ * Read the `fields` defs out of a §3 `form-state` envelope. Entries without a
+ * `name` are dropped: a field with no name has nothing to write to, and
+ * rendering it would produce an input whose value goes nowhere.
+ */
+export declare function formFieldsOf(data: unknown): FormFieldConfig[];
+/**
+ * The field defs a form widget should render: config wins over the payload.
+ *
+ * Config is the GENERATED contract (the Engine derived it from column types at
+ * generation time, annex §10) and is what the manifest stores; a payload's
+ * `fields` is only the server echoing the same shape back. Preferring config
+ * keeps the rendered form stable even if a query returns an empty envelope.
+ */
+export declare function resolveFields(configFields: readonly FormFieldConfig[] | undefined, data: unknown): FormFieldConfig[];
+/** Seed the controlled value map from the payload, defaulting per field kind. */
+export declare function initialValues(fields: readonly FormFieldConfig[], data: unknown): Rec;
+/**
+ * Which required fields are still empty. `false` is a LEGITIMATE value for a
+ * switch, so emptiness is checked as "absent or empty string", never falsiness —
+ * treating `false` as missing would make a required opt-out toggle unsubmittable.
+ */
+export declare function missingRequired(fields: readonly FormFieldConfig[], values: Rec): string[];
+export {};
+//# sourceMappingURL=forms-state.d.ts.map

package/dist/families/forms/forms-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-state.d.ts","sourceRoot":"","sources":["../../../src/families/forms/forms-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMnC,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,GACnG,aAAa,GAAG,IAAI,CAItB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAW7D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAGpH;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,GAAG,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,CAQzF"}

package/dist/families/forms/forms-state.js

@@ -0,0 +1,103 @@
+/**
+ * `form-state` payload readers + the write target (annex §10; 04 §3) — PURE
+ * module. Split from `forms-lib.ts` because these two concerns are what every
+ * INPUT widget in the family shares, and keeping them together makes the write
+ * model reviewable in one place.
+ *
+ * THE WRITE MODEL (04 §2.1): forms widgets are controlled by local state and
+ * report changes as `mutate` INTENTS — they never persist. The host runs the
+ * intent through the CRUD API (with undo + audit). An UNBOUND instance (demo
+ * data, a story, the widget palette) has no target, so `bindingTargetOf` returns
+ * `null` and callers skip the intent rather than emitting one into the void.
+ */
+function rec(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
+}
+/**
+ * The write target for a bound widget, or `null` when the widget is running on
+ * `demoData`. An unbound widget must not offer a write affordance — there is
+ * nowhere to send the intent (04 §5).
+ */
+export function bindingTargetOf(binding) {
+    if (binding === undefined)
+        return null;
+    const { schema, name } = binding.source;
+    return { connectionId: binding.connectionId, table: schema === undefined ? name : `${schema}.${name}` };
+}
+/**
+ * Read the `values` map out of a §3 `form-state` envelope
+ * (`{ fields: FieldDef[]; values: Record<string, unknown> }`). Also accepts a
+ * bare values object so template/story composition can hand values directly.
+ */
+export function formValuesOf(data) {
+    const envelope = rec(data);
+    if (envelope === null)
+        return {};
+    const values = rec(envelope['values']);
+    if (values !== null)
+        return values;
+    // Bare object that is not an envelope — treat it as the values map itself.
+    return 'values' in envelope || 'fields' in envelope ? {} : envelope;
+}
+/**
+ * Read the `fields` defs out of a §3 `form-state` envelope. Entries without a
+ * `name` are dropped: a field with no name has nothing to write to, and
+ * rendering it would produce an input whose value goes nowhere.
+ */
+export function formFieldsOf(data) {
+    const envelope = rec(data);
+    const fields = envelope?.['fields'];
+    if (!Array.isArray(fields))
+        return [];
+    const out = [];
+    for (const entry of fields) {
+        const field = rec(entry);
+        if (field === null || typeof field['name'] !== 'string')
+            continue;
+        out.push(field);
+    }
+    return out;
+}
+/**
+ * The field defs a form widget should render: config wins over the payload.
+ *
+ * Config is the GENERATED contract (the Engine derived it from column types at
+ * generation time, annex §10) and is what the manifest stores; a payload's
+ * `fields` is only the server echoing the same shape back. Preferring config
+ * keeps the rendered form stable even if a query returns an empty envelope.
+ */
+export function resolveFields(configFields, data) {
+    if (configFields !== undefined && configFields.length > 0)
+        return [...configFields];
+    return formFieldsOf(data);
+}
+/** Seed the controlled value map from the payload, defaulting per field kind. */
+export function initialValues(fields, data) {
+    const bound = formValuesOf(data);
+    const out = {};
+    for (const field of fields) {
+        if (field.name in bound) {
+            out[field.name] = bound[field.name];
+            continue;
+        }
+        out[field.name] = field.kind === 'switch' ? false : '';
+    }
+    return out;
+}
+/**
+ * Which required fields are still empty. `false` is a LEGITIMATE value for a
+ * switch, so emptiness is checked as "absent or empty string", never falsiness —
+ * treating `false` as missing would make a required opt-out toggle unsubmittable.
+ */
+export function missingRequired(fields, values) {
+    const out = [];
+    for (const field of fields) {
+        if (!field.required)
+            continue;
+        const value = values[field.name];
+        if (value === undefined || value === null || value === '')
+            out.push(field.name);
+    }
+    return out;
+}
+//# sourceMappingURL=forms-state.js.map

package/dist/families/forms/forms-state.js.map

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

package/dist/families/forms/forms-tables.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The table-inclusion RULES behind `table-inclusion-checklist` (annex §10) —
+ * PURE module (React-free, JSX-free, copy-free).
+ *
+ * LIFTED FROM THE STUDIO WIZARD, same reasoning as `forms-dsn.ts`: these rules
+ * were born in `apps/dashboard/src/studio/connect/wizardState.ts` (M5-T02), and
+ * the wizard now consumes them instead of keeping a rival copy. The rule that
+ * matters is the DEFAULT: a >100k-row table starts unchecked. If the widget and
+ * the wizard disagreed about that threshold, the same database would generate
+ * different dashboards depending on which screen the user came through.
+ *
+ * WHAT STAYED IN THE WIZARD: the mapping from `@adminium/engine`'s introspected
+ * `SchemaTable` onto `InclusionTable` below. That shape is the wizard's own
+ * dependency, and the widget binds a §3 `record-list` instead — so the two meet
+ * at `InclusionTable`, which is all the RULES ever needed to see.
+ */
+/** 05: a row estimate above this ⇒ an ops-volume table ⇒ starts unchecked. */
+export declare const HIGH_VOLUME_ROWS = 100000;
+/** One includable table, reduced to what the inclusion rules read. */
+export interface InclusionTable {
+    /** Qualified table name — the mono label AND the inclusion key. */
+    id: string;
+    /** `null` when the source cannot supply counts (a schema file has none). */
+    rowEstimate: number | null;
+    /** How many of its columns the classifier flagged as PII (annex §10). */
+    piiColumns: number;
+    highVolume: boolean;
+    /** Join/system tables are pre-hidden — never listed as includable. */
+    preHidden: boolean;
+    /** Suggested-dashboard tag chip (annex §10), when the enricher named one. */
+    tag?: string | undefined;
+}
+/**
+ * Whether a row estimate makes a table high-volume. `null` is NOT high-volume:
+ * an unknown count is not evidence of a big table, and defaulting the unknown to
+ * "exclude" would silently drop every table of a schema-file import.
+ */
+export declare function isHighVolume(rowEstimate: number | null): boolean;
+/**
+ * The default inclusion set: everything visible except high-volume ops tables
+ * (05; M5-T02). Order follows the input so the derived list is deterministic.
+ */
+export declare function defaultIncludedIds(tables: readonly InclusionTable[]): string[];
+/** `included`/`total` for the checklist header count (annex §10). */
+export declare function inclusionCounts(tables: readonly InclusionTable[], selected: ReadonlySet<string>): {
+    included: number;
+    total: number;
+};
+//# sourceMappingURL=forms-tables.d.ts.map

package/dist/families/forms/forms-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-tables.d.ts","sourceRoot":"","sources":["../../../src/families/forms/forms-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAExC,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAE9E;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMrC"}

package/dist/families/forms/forms-tables.js

@@ -0,0 +1,42 @@
+/**
+ * The table-inclusion RULES behind `table-inclusion-checklist` (annex §10) —
+ * PURE module (React-free, JSX-free, copy-free).
+ *
+ * LIFTED FROM THE STUDIO WIZARD, same reasoning as `forms-dsn.ts`: these rules
+ * were born in `apps/dashboard/src/studio/connect/wizardState.ts` (M5-T02), and
+ * the wizard now consumes them instead of keeping a rival copy. The rule that
+ * matters is the DEFAULT: a >100k-row table starts unchecked. If the widget and
+ * the wizard disagreed about that threshold, the same database would generate
+ * different dashboards depending on which screen the user came through.
+ *
+ * WHAT STAYED IN THE WIZARD: the mapping from `@adminium/engine`'s introspected
+ * `SchemaTable` onto `InclusionTable` below. That shape is the wizard's own
+ * dependency, and the widget binds a §3 `record-list` instead — so the two meet
+ * at `InclusionTable`, which is all the RULES ever needed to see.
+ */
+/** 05: a row estimate above this ⇒ an ops-volume table ⇒ starts unchecked. */
+export const HIGH_VOLUME_ROWS = 100_000;
+/**
+ * Whether a row estimate makes a table high-volume. `null` is NOT high-volume:
+ * an unknown count is not evidence of a big table, and defaulting the unknown to
+ * "exclude" would silently drop every table of a schema-file import.
+ */
+export function isHighVolume(rowEstimate) {
+    return rowEstimate !== null && rowEstimate > HIGH_VOLUME_ROWS;
+}
+/**
+ * The default inclusion set: everything visible except high-volume ops tables
+ * (05; M5-T02). Order follows the input so the derived list is deterministic.
+ */
+export function defaultIncludedIds(tables) {
+    return tables.filter((table) => !table.preHidden && !table.highVolume).map((table) => table.id);
+}
+/** `included`/`total` for the checklist header count (annex §10). */
+export function inclusionCounts(tables, selected) {
+    const visible = tables.filter((table) => !table.preHidden);
+    return {
+        included: visible.filter((table) => selected.has(table.id)).length,
+        total: visible.length,
+    };
+}
+//# sourceMappingURL=forms-tables.js.map

package/dist/families/forms/forms-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-tables.js","sourceRoot":"","sources":["../../../src/families/forms/forms-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAiBxC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,WAA0B;IACrD,OAAO,WAAW,KAAK,IAAI,IAAI,WAAW,GAAG,gBAAgB,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAC7B,MAAiC,EACjC,QAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM;QAClE,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/families/forms/forms-track-components.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `forms` family component barrel — the single lazy-import target for this
+ * family's definitions, so the registry metadata graph reaches the
+ * @adminium/ui-heavy form components (and Radix's dialog/radio/switch) only
+ * through a dynamic `import()` boundary (one lazy chunk for the family,
+ * 04 §2.3). Mirrors the kpi/charts/feeds/boards/media/system/chrome convention.
+ */
+export { ColumnMappingTableWidget } from './ColumnMappingTable.js';
+export { ConnectionStringFieldWidget } from './ConnectionStringField.js';
+export { DrawerFormWidget } from './DrawerForm.js';
+export { ExportBuilderWidget } from './ExportBuilder.js';
+export { FilterChipBarWidget } from './FilterChipBar.js';
+export { FlowBuilderWidget } from './FlowBuilder.js';
+export { InlineEditableFieldWidget } from './InlineEditableField.js';
+export { ChipInputWidget, OtpInputWidget, PasswordStrengthMeterWidget, SegmentedControlWidget } from './InputWidgets.js';
+export { ModalWizardWidget } from './ModalWizard.js';
+export { OptionCardsWidget } from './OptionCards.js';
+export { ProgressBarWidget } from './ProgressBarWidget.js';
+export { QuestionBuilderWidget } from './QuestionBuilder.js';
+export { RuleBuilderWidget } from './RuleBuilder.js';
+export { StepperWidget } from './StepperWidget.js';
+export { TableInclusionChecklistWidget } from './TableInclusionChecklist.js';
+export { ToggleSwitchListWidget } from './ToggleSwitchList.js';
+export { ValidationIssuesListWidget } from './ValidationIssuesList.js';
+//# sourceMappingURL=forms-track-components.d.ts.map

package/dist/families/forms/forms-track-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-track-components.d.ts","sourceRoot":"","sources":["../../../src/families/forms/forms-track-components.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/families/forms/forms-track-components.js

@@ -0,0 +1,25 @@
+/**
+ * `forms` family component barrel — the single lazy-import target for this
+ * family's definitions, so the registry metadata graph reaches the
+ * @adminium/ui-heavy form components (and Radix's dialog/radio/switch) only
+ * through a dynamic `import()` boundary (one lazy chunk for the family,
+ * 04 §2.3). Mirrors the kpi/charts/feeds/boards/media/system/chrome convention.
+ */
+export { ColumnMappingTableWidget } from './ColumnMappingTable.js';
+export { ConnectionStringFieldWidget } from './ConnectionStringField.js';
+export { DrawerFormWidget } from './DrawerForm.js';
+export { ExportBuilderWidget } from './ExportBuilder.js';
+export { FilterChipBarWidget } from './FilterChipBar.js';
+export { FlowBuilderWidget } from './FlowBuilder.js';
+export { InlineEditableFieldWidget } from './InlineEditableField.js';
+export { ChipInputWidget, OtpInputWidget, PasswordStrengthMeterWidget, SegmentedControlWidget } from './InputWidgets.js';
+export { ModalWizardWidget } from './ModalWizard.js';
+export { OptionCardsWidget } from './OptionCards.js';
+export { ProgressBarWidget } from './ProgressBarWidget.js';
+export { QuestionBuilderWidget } from './QuestionBuilder.js';
+export { RuleBuilderWidget } from './RuleBuilder.js';
+export { StepperWidget } from './StepperWidget.js';
+export { TableInclusionChecklistWidget } from './TableInclusionChecklist.js';
+export { ToggleSwitchListWidget } from './ToggleSwitchList.js';
+export { ValidationIssuesListWidget } from './ValidationIssuesList.js';
+//# sourceMappingURL=forms-track-components.js.map

package/dist/families/forms/forms-track-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-track-components.js","sourceRoot":"","sources":["../../../src/families/forms/forms-track-components.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/families/forms/forms-track.definitions.d.ts

@@ -0,0 +1,64 @@
+import type { WidgetDefinition } from '../../registry/types.js';
+/**
+ * TRACK FCS — `forms` family registry metadata (annex §10; 04-T10). Metadata
+ * only: components load through the `forms-track-components` barrel via
+ * `lazy(() => import(...))`, so the family stays in ONE lazy chunk and the
+ * registry metadata never eagerly pulls component code — or Radix's
+ * dialog/radio/switch — into a sibling family's bundle (04 §2.3; the
+ * chunk-budget gate). Schemas + `demoData` come from the PURE `forms-config.ts`
+ * for the same reason. The GREEN LOOP spreads `formsTrackDefinitions` into the
+ * registry map. Widget ids match the annex catalog exactly (acceptance #1).
+ *
+ * Sizing is the annex's grid note converted to 40px half-units
+ * (04 §6.1: `h = round(annexRows × 2)`); widths map 1:1.
+ *
+ * SHAPE CHOICES (04 §3): the input widgets take `form-state` — the §3 envelope
+ * for "field defs + values", which is exactly what a generated create/edit form
+ * is. `stepper`, `option-cards`, `filter-chip-bar` and `validation-issues-list`
+ * take `record-list` (step defs, option defs, the sibling list they count, the
+ * issue list). `toggle-switch-list` takes `boolean-map` — the shape the annex
+ * names for it. `progress-bar` takes `single-metric` (one 0–100 value).
+ *
+ * `capabilities.editsData` marks every widget that emits a `mutate` intent —
+ * the host runs them through the CRUD API with undo + audit; widgets never write.
+ * `password-strength-meter` is the one input that does NOT: the password never
+ * leaves it.
+ */
+export declare const modalWizardDefinition: WidgetDefinition;
+export declare const drawerFormDefinition: WidgetDefinition;
+export declare const stepperDefinition: WidgetDefinition;
+export declare const progressBarDefinition: WidgetDefinition;
+export declare const otpInputDefinition: WidgetDefinition;
+export declare const chipInputDefinition: WidgetDefinition;
+export declare const segmentedControlDefinition: WidgetDefinition;
+export declare const filterChipBarDefinition: WidgetDefinition;
+export declare const toggleSwitchListDefinition: WidgetDefinition;
+export declare const optionCardsDefinition: WidgetDefinition;
+/**
+ * THE BUILDERS (`rule-builder`, `flow-builder`, `question-builder`) all take
+ * `form-state`, not `record-list` — even though each carries a list. §3's
+ * `record-list` is EMPTY when `total === 0`, which would hand a brand-new
+ * builder the frame's "no data" state; a builder with no rows yet is not empty,
+ * it is waiting for its first one and must show its add affordance.
+ * `form-state` is never empty by §3, which is exactly right for a canvas.
+ */
+export declare const ruleBuilderDefinition: WidgetDefinition;
+export declare const flowBuilderDefinition: WidgetDefinition;
+export declare const connectionStringFieldDefinition: WidgetDefinition;
+export declare const tableInclusionChecklistDefinition: WidgetDefinition;
+export declare const columnMappingTableDefinition: WidgetDefinition;
+export declare const passwordStrengthMeterDefinition: WidgetDefinition;
+export declare const validationIssuesListDefinition: WidgetDefinition;
+export declare const exportBuilderDefinition: WidgetDefinition;
+export declare const questionBuilderDefinition: WidgetDefinition;
+export declare const inlineEditableFieldDefinition: WidgetDefinition;
+/**
+ * Every `forms` widget, in annex §10 order — the TRACK FCS slice (M7 Wave 3)
+ * plus the M7 Wave-4 TAIL that completes the family (TRACK FORMS): the two
+ * builder canvases, the two Studio-wizard widgets lifted out of
+ * `apps/dashboard` (see `ConnectionStringField.tsx` / `TableInclusionChecklist.tsx`),
+ * the import wizard's column mapper, the export builder, the survey editor and
+ * the document-canvas inline field.
+ */
+export declare const formsTrackDefinitions: readonly WidgetDefinition[];
+//# sourceMappingURL=forms-track.definitions.d.ts.map

package/dist/families/forms/forms-track.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-track.definitions.d.ts","sourceRoot":"","sources":["../../../src/families/forms/forms-track.definitions.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,qBAAqB,EAAE,gBAYlC,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,gBAYjC,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,gBAY9B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,gBAWlC,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,gBAY/B,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,gBAYhC,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,gBAYvC,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,gBAapC,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,gBAYvC,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,gBAYlC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAYlC,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,gBAYlC,CAAC;AAEH,eAAO,MAAM,+BAA+B,EAAE,gBAY5C,CAAC;AAEH,eAAO,MAAM,iCAAiC,EAAE,gBAc9C,CAAC;AAEH,eAAO,MAAM,4BAA4B,EAAE,gBAYzC,CAAC;AAEH,eAAO,MAAM,+BAA+B,EAAE,gBAa5C,CAAC;AAEH,eAAO,MAAM,8BAA8B,EAAE,gBAW3C,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,gBAcpC,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,gBAetC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,gBAa1C,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAqB5D,CAAC"}