@pilotiq/pilotiq 0.1.0

package/dist/schema/Wizard.d.ts

@@ -0,0 +1,67 @@
+import { Element } from './Element.js';
+/**
+ * Single step inside a `Wizard`. Holds a label, optional icon/description,
+ * and a list of child Elements. Children resolve unconditionally on every
+ * Wizard render so cross-step `$get` (Plan #5) sees values from every step,
+ * but the renderer only paints the *active* step's children.
+ */
+export declare class Step extends Element {
+    private _label;
+    private _icon?;
+    private _description?;
+    private constructor();
+    static make(label: string): Step;
+    /** Icon shown next to the step label (registry key). */
+    icon(name: string): this;
+    /** Optional helper text rendered under the step label inside the indicator. */
+    description(d: string): this;
+    /** Set the step's children. Any Element type is accepted. */
+    schema(elements: Element[]): this;
+    getType(): string;
+    toMeta(): Record<string, unknown>;
+}
+/**
+ * Multi-step form layout. Wraps a list of `Step` containers with an
+ * indicator strip + Back / Next chrome. Submit semantics are unchanged
+ * — the surrounding `Form`'s Save fires only when the user is on the
+ * final step (the Next button mutates to "Save" or the page-level
+ * action becomes visible — see SchemaRenderer's WizardRenderer).
+ *
+ * Validation: on Next click, the client POSTs `{ step, values }` to the
+ * Form's `wizardUrl` (when set — Plan #8 step 7 wires the endpoint).
+ * 200 → advance; 422 → stamp inline errors. When `wizardUrl` is absent
+ * (e.g. forms without per-step validation), Next advances immediately.
+ *
+ * Cross-step `$get`: every Step's children are resolved on each
+ * RenderContext, so a step-2 `Section.visible(({ $get }) => $get('emailFromStep0'))`
+ * works. Inactive steps are hidden client-side via `display: none`,
+ * which keeps controlled inputs in the DOM and preserves their values.
+ */
+export declare class Wizard extends Element {
+    private _skippable;
+    private _startOnStep;
+    private _persist;
+    private constructor();
+    static make(): Wizard;
+    /** Set the step list. Each entry is a `Step` instance with its own schema. */
+    steps(steps: Step[]): this;
+    /**
+     * Allow the user to click any step indicator to jump there. When `true`,
+     * jumping forward still validates intermediate steps in order. When
+     * `false` (default), step indicators ahead of the current step are
+     * disabled.
+     */
+    skippable(v?: boolean): this;
+    /** Initial step index. Default 0. */
+    startOnStep(n: number): this;
+    /**
+     * Persist the active step to localStorage so refresh / SPA-nav keeps
+     * the user on the same step. Default `true`. Disable for ephemeral
+     * Wizards (e.g. inline modal flows) where you'd rather always start
+     * fresh.
+     */
+    persist(v: boolean): this;
+    getType(): string;
+    toMeta(): Record<string, unknown>;
+}
+//# sourceMappingURL=Wizard.d.ts.map

package/dist/schema/Wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wizard.d.ts","sourceRoot":"","sources":["../../src/schema/Wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;GAKG;AACH,qBAAa,IAAK,SAAQ,OAAO;IAIX,OAAO,CAAC,MAAM;IAHlC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAC,CAAQ;IAE7B,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAExB,+EAA+E;IAC/E,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE5B,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjC,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,QAAQ,CAAO;IAEvB,OAAO;IAEP,MAAM,CAAC,IAAI,IAAI,MAAM;IAIrB,8EAA8E;IAC9E,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAK1B;;;;;OAKG;IACH,SAAS,CAAC,CAAC,UAAO,GAAG,IAAI;IAEzB,qCAAqC;IACrC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAEzB,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}

package/dist/schema/Wizard.js

@@ -0,0 +1,94 @@
+import { Element } from './Element.js';
+/**
+ * Single step inside a `Wizard`. Holds a label, optional icon/description,
+ * and a list of child Elements. Children resolve unconditionally on every
+ * Wizard render so cross-step `$get` (Plan #5) sees values from every step,
+ * but the renderer only paints the *active* step's children.
+ */
+export class Step extends Element {
+    _label;
+    _icon;
+    _description;
+    constructor(_label) {
+        super();
+        this._label = _label;
+    }
+    static make(label) {
+        return new Step(label);
+    }
+    /** Icon shown next to the step label (registry key). */
+    icon(name) { this._icon = name; return this; }
+    /** Optional helper text rendered under the step label inside the indicator. */
+    description(d) { this._description = d; return this; }
+    /** Set the step's children. Any Element type is accepted. */
+    schema(elements) {
+        this._children = elements;
+        return this;
+    }
+    getType() { return 'step'; }
+    toMeta() {
+        return {
+            type: 'step',
+            label: this._label,
+            ...(this._icon ? { icon: this._icon } : {}),
+            ...(this._description ? { description: this._description } : {}),
+        };
+    }
+}
+/**
+ * Multi-step form layout. Wraps a list of `Step` containers with an
+ * indicator strip + Back / Next chrome. Submit semantics are unchanged
+ * — the surrounding `Form`'s Save fires only when the user is on the
+ * final step (the Next button mutates to "Save" or the page-level
+ * action becomes visible — see SchemaRenderer's WizardRenderer).
+ *
+ * Validation: on Next click, the client POSTs `{ step, values }` to the
+ * Form's `wizardUrl` (when set — Plan #8 step 7 wires the endpoint).
+ * 200 → advance; 422 → stamp inline errors. When `wizardUrl` is absent
+ * (e.g. forms without per-step validation), Next advances immediately.
+ *
+ * Cross-step `$get`: every Step's children are resolved on each
+ * RenderContext, so a step-2 `Section.visible(({ $get }) => $get('emailFromStep0'))`
+ * works. Inactive steps are hidden client-side via `display: none`,
+ * which keeps controlled inputs in the DOM and preserves their values.
+ */
+export class Wizard extends Element {
+    _skippable = false;
+    _startOnStep = 0;
+    _persist = true;
+    constructor() { super(); }
+    static make() {
+        return new Wizard();
+    }
+    /** Set the step list. Each entry is a `Step` instance with its own schema. */
+    steps(steps) {
+        this._children = steps;
+        return this;
+    }
+    /**
+     * Allow the user to click any step indicator to jump there. When `true`,
+     * jumping forward still validates intermediate steps in order. When
+     * `false` (default), step indicators ahead of the current step are
+     * disabled.
+     */
+    skippable(v = true) { this._skippable = v; return this; }
+    /** Initial step index. Default 0. */
+    startOnStep(n) { this._startOnStep = n; return this; }
+    /**
+     * Persist the active step to localStorage so refresh / SPA-nav keeps
+     * the user on the same step. Default `true`. Disable for ephemeral
+     * Wizards (e.g. inline modal flows) where you'd rather always start
+     * fresh.
+     */
+    persist(v) { this._persist = v; return this; }
+    getType() { return 'wizard'; }
+    toMeta() {
+        return {
+            type: 'wizard',
+            skippable: this._skippable,
+            startOnStep: this._startOnStep,
+            persist: this._persist,
+        };
+    }
+}
+//# sourceMappingURL=Wizard.js.map

package/dist/schema/Wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wizard.js","sourceRoot":"","sources":["../../src/schema/Wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,OAAO,IAAK,SAAQ,OAAO;IAIH;IAHpB,KAAK,CAAS;IACd,YAAY,CAAS;IAE7B,YAA4B,MAAc;QACxC,KAAK,EAAE,CAAA;QADmB,WAAM,GAAN,MAAM,CAAQ;IAE1C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,IAAY,IAAU,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE3D,+EAA+E;IAC/E,WAAW,CAAC,CAAS,IAAU,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEnE,6DAA6D;IAC7D,MAAM,CAAC,QAAmB;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAEnC,MAAM;QACJ,OAAO;YACL,IAAI,EAAG,MAAe;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC,CAAC,EAAE,IAAI,EAAS,IAAI,CAAC,KAAK,EAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAA;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,MAAO,SAAQ,OAAO;IACzB,UAAU,GAAG,KAAK,CAAA;IAClB,YAAY,GAAG,CAAC,CAAA;IAChB,QAAQ,GAAG,IAAI,CAAA;IAEvB,gBAAwB,KAAK,EAAE,CAAA,CAAC,CAAC;IAEjC,MAAM,CAAC,IAAI;QACT,OAAO,IAAI,MAAM,EAAE,CAAA;IACrB,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,CAAC,GAAG,IAAI,IAAU,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE9D,qCAAqC;IACrC,WAAW,CAAC,CAAS,IAAU,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,OAAO,CAAC,CAAU,IAAU,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE5D,OAAO,KAAa,OAAO,QAAQ,CAAA,CAAC,CAAC;IAErC,MAAM;QACJ,OAAO;YACL,IAAI,EAAS,QAAiB;YAC9B,SAAS,EAAI,IAAI,CAAC,UAAU;YAC5B,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAM,IAAI,CAAC,QAAQ;SAC3B,CAAA;IACH,CAAC;CACF"}

package/dist/schema/index.d.ts

@@ -0,0 +1,26 @@
+export { Element, type ElementMeta, type LayoutContext, type LayoutVisibilityRule, type LayoutPositioning, } from './Element.js';
+export { Text, type TextColor, type TextSize, type TextWeight } from './Text.js';
+export { Heading } from './Heading.js';
+export { Alert, type AlertType } from './Alert.js';
+export { EmptyState } from './EmptyState.js';
+export { Divider } from './Divider.js';
+export { UnorderedList } from './UnorderedList.js';
+export { Breadcrumbs, type BreadcrumbItem } from './Breadcrumbs.js';
+export { Image, type ImageShape } from './Image.js';
+export { Icon, type IconColor } from './Icon.js';
+export { Markdown, type MarkdownProseSize } from './Markdown.js';
+export { Html } from './Html.js';
+export { MetaTag, type MetaTagAttrs } from './MetaTag.js';
+export { LinkTag, type LinkTagAttrs } from './LinkTag.js';
+export { ScriptTag, type ScriptTagAttrs } from './ScriptTag.js';
+export { StyleTag } from './StyleTag.js';
+export { Card } from './Card.js';
+export { Section } from './Section.js';
+export { Tabs, Tab } from './Tabs.js';
+export { Grid } from './Grid.js';
+export { Group } from './Group.js';
+export { Fieldset } from './Fieldset.js';
+export { Split, type SplitFrom } from './Split.js';
+export { Wizard, Step } from './Wizard.js';
+export { resolveSchema, registerResolver, type SchemaDefinition, type SchemaContext, type RenderContext, type RenderMode, type ElementResolver, } from './resolveSchema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAI,KAAK,YAAY,EAAE,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAI,KAAK,YAAY,EAAE,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAA"}

package/dist/schema/index.js

@@ -0,0 +1,26 @@
+export { Element, } from './Element.js';
+export { Text } from './Text.js';
+export { Heading } from './Heading.js';
+export { Alert } from './Alert.js';
+export { EmptyState } from './EmptyState.js';
+export { Divider } from './Divider.js';
+export { UnorderedList } from './UnorderedList.js';
+export { Breadcrumbs } from './Breadcrumbs.js';
+export { Image } from './Image.js';
+export { Icon } from './Icon.js';
+export { Markdown } from './Markdown.js';
+export { Html } from './Html.js';
+export { MetaTag } from './MetaTag.js';
+export { LinkTag } from './LinkTag.js';
+export { ScriptTag } from './ScriptTag.js';
+export { StyleTag } from './StyleTag.js';
+export { Card } from './Card.js';
+export { Section } from './Section.js';
+export { Tabs, Tab } from './Tabs.js';
+export { Grid } from './Grid.js';
+export { Group } from './Group.js';
+export { Fieldset } from './Fieldset.js';
+export { Split } from './Split.js';
+export { Wizard, Step } from './Wizard.js';
+export { resolveSchema, registerResolver, } from './resolveSchema.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GAKR,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,IAAI,EAAkD,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAuB,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAmB,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,QAAQ,EAA0B,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAuB,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAuB,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,aAAa,EACb,gBAAgB,GAMjB,MAAM,oBAAoB,CAAA"}

package/dist/schema/resolveSchema.d.ts

@@ -0,0 +1,122 @@
+import { Element, type ElementMeta } from './Element.js';
+export interface SchemaContext {
+    user?: {
+        name?: string;
+        email?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Render context — extends `SchemaContext` with the rendering mode and
+ * optional record. Used by the field resolver to evaluate visibility flags
+ * (`hideFromTable` / `hideFromEdit` / etc.) and condition callbacks
+ * (`showWhen` / `hideWhen` / `disabledWhen`) against the current page.
+ *
+ * `mode` is unset on schema-only routes (custom Pages). Field visibility is
+ * a no-op in that case.
+ */
+export type RenderMode = 'table' | 'create' | 'edit' | 'view';
+export interface RenderContext extends SchemaContext {
+    mode?: RenderMode;
+    record?: unknown;
+    /**
+     * Current form values for the in-progress resolve cycle. Populated by
+     * the partial-resolve endpoint (Plan #5) and by edit/create page
+     * builders that prefill from a record. When present, `$get / $set`
+     * are framework-bound so field condition callbacks and reactive
+     * `options(fn)` handlers can read/write sibling values.
+     */
+    values?: Record<string, unknown>;
+    /** Read a sibling field's current value from the resolve cycle's values map. */
+    $get?: (name: string) => unknown;
+    /** Mutate a sibling field's value during this resolve cycle. */
+    $set?: (name: string, value: unknown) => void;
+    /**
+     * Name of the field whose change triggered this resolve, if any.
+     * Populated only by the partial-resolve endpoint; undefined on
+     * initial GET render.
+     */
+    changed?: string;
+    /**
+     * URL the FileUpload field should POST to. Stamped onto every
+     * page-data ctx by the route handlers / page-data builders so the
+     * field's `toMeta` doesn't need to know the panel base path. Single
+     * panel-level URL — no per-field variation.
+     */
+    uploadUrl?: string;
+    /**
+     * `true` when the panel has registered an `UploadAdapter` via
+     * `Pilotiq.uploads({ adapter })`. Distinct from `uploadUrl` (which is
+     * always stamped so `FileUpload` can show a clear error if missed) —
+     * this flag tells fields whose upload integration is *optional* (e.g.
+     * `MarkdownField`'s `attachFiles` toolbar button) whether to surface
+     * the affordance at all.
+     */
+    hasUploadAdapter?: boolean;
+    /**
+     * Plan #15 — per-widget filter value rode in on the polling-endpoint
+     * body. Opaque to the framework: each widget's `getData(ctx)` decodes
+     * `ctx.filter` however it wants (`'today' | 'week' | 'month'`, JSON
+     * blob, …). Unset on the initial-render path; set on every polling
+     * fetch when the user picked something from the per-chart filter
+     * dropdown.
+     */
+    filter?: string;
+    /**
+     * Plan #14 row-scoped sugar inside a Repeater. When the resolver is
+     * walking a row's inner schema, `row.index` is the row's position and
+     * `row.$get / row.$set` are bound to the row's local values map. The
+     * top-level `ctx.$get / $set` still see the whole form (cross-row
+     * reads via dotted paths like `items.0.title`); `row.$get(name)` is
+     * just sugar for the common case of "read the same row's siblings".
+     */
+    row?: {
+        index: number;
+        $get: (name: string) => unknown;
+        $set: (name: string, value: unknown) => void;
+        /**
+         * Other rows' values maps, excluding the current row at `index`.
+         * Stamped by `resolveRepeaterRows` (every sibling) and
+         * `resolveBuilderRows` (only same-block-type siblings; each entry is
+         * the row's `data` map). Read by
+         * `disableOptionsWhenSelectedInSiblingRepeaterItems()` to mark
+         * already-picked options as disabled.
+         */
+        siblings?: ReadonlyArray<Record<string, unknown>>;
+        /**
+         * Present only when the row lives inside a `BuilderField` — the row's
+         * block name. See `LayoutContext.row.blockType` for the rationale.
+         */
+        blockType?: string;
+    };
+}
+export type SchemaDefinition = Element[] | ((ctx: SchemaContext) => Element[] | Promise<Element[]>);
+/**
+ * Plugin resolver — replaces the default toMeta+recurse behavior for a
+ * given element type. Plugins receive the original element, the context,
+ * and a `recurse` helper that resolves a child array. Useful when a
+ * pro/feature plugin needs to inject computed data, augment meta, or
+ * reshape children before serialization.
+ *
+ * If no resolver is registered for a type, the default (call `toMeta()`,
+ * recurse into `getChildren()` if present, attach as `meta.children`) runs.
+ */
+export type ElementResolver = (el: Element, ctx: SchemaContext, recurse: (children: Element[]) => Promise<ElementMeta[]>) => Promise<ElementMeta> | ElementMeta;
+/** Register a custom resolver for a given element type. Plugins call this at boot. */
+export declare function registerResolver(type: string, fn: ElementResolver): void;
+/** Internal — used by tests to reset state. Not part of the public API. */
+export declare function _resetResolverRegistry(): void;
+/**
+ * Resolve a schema definition into serializable metadata.
+ *
+ * Walks the Element tree, calling each element's `toMeta()` (or a registered
+ * custom resolver). Children of container elements are resolved recursively
+ * and attached as `meta.children`. Fields evaluate visibility flags + record
+ * conditions against the `RenderContext`; hidden fields are dropped.
+ *
+ * Accepts a `SchemaContext` (or the richer `RenderContext`) — the latter is
+ * required for Field visibility/condition evaluation to do anything useful.
+ */
+export declare function resolveSchema(definition: SchemaDefinition | undefined, ctx?: RenderContext): Promise<ElementMeta[]>;
+//# sourceMappingURL=resolveSchema.d.ts.map

package/dist/schema/resolveSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSchema.d.ts","sourceRoot":"","sources":["../../src/schema/resolveSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAsB,MAAM,cAAc,CAAA;AAyB5E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7D,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,gFAAgF;IAChF,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAChC,gEAAgE;IAChE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE;QACJ,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;QAChC,IAAI,EAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;QAC7C;;;;;;;WAOG;QACH,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;QACjD;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,MAAM,MAAM,gBAAgB,GACxB,OAAO,EAAE,GACT,CAAC,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;AAE5D;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,KACrD,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAA;AAIvC,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,GAAG,IAAI,CAExE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,gBAAgB,GAAG,SAAS,EACxC,GAAG,GAAE,aAAkB,GACtB,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB"}