@pilotiq/pilotiq 0.1.0

package/dist/fields/BuilderField.js

@@ -0,0 +1,359 @@
+import { Field } from './Field.js';
+import { serializeRowButtons, normalizeGridConfig, } from './RepeaterField.js';
+/**
+ * Heterogeneous-row Repeater. The author registers N block-types via
+ * `.blocks([Block.make('heading').schema([…]), …])`; the rendered form
+ * lets the end user pick from those types when adding rows.
+ *
+ * Storage on the parent record is `[{ __id, type, data: {…} }, …]` — a
+ * `{ type, data }` envelope per row. JSON-friendly, collision-free with
+ * any inner field name, mirrors Filament. See `docs/plans/builder-field.md`
+ * for the wire-format details.
+ */
+export class BuilderField extends Field {
+    _blocks = [];
+    _blocksByName = new Map();
+    _minItems;
+    _maxItems;
+    _defaultBlock;
+    _reorderable = false;
+    _reorderableWithButtons = false;
+    _collapsible = false;
+    _defaultCollapsed = false;
+    _accordion = false;
+    _cloneable = false;
+    _addable = true;
+    _deletable = true;
+    _addBetween = false;
+    _itemNumbers = false;
+    _blockNumbers = false;
+    _blockIcons = true;
+    _blockPickerColumns;
+    _addActionLabel;
+    _addActionAlignment = 'start';
+    _itemLabel;
+    _itemHidden;
+    _itemCanDelete;
+    _itemCanClone;
+    _itemCanReorder;
+    _extraItemActions = [];
+    _grid;
+    _buttons = {};
+    _relationship;
+    constructor(name) {
+        super(name, 'builder');
+    }
+    static make(name) {
+        return new BuilderField(name);
+    }
+    /** Register the block types the user can pick from. Order = picker order. */
+    blocks(blocks) {
+        this._blocks = blocks;
+        this._blocksByName = new Map(blocks.map(b => [b.name, b]));
+        return this;
+    }
+    /** Validator + client gate. */
+    minItems(n) { this._minItems = n; return this; }
+    maxItems(n) { this._maxItems = n; return this; }
+    /**
+     * Block name auto-selected when adding a row without explicitly opening
+     * the picker (e.g. when there's only one block type, or for "quick add"
+     * UX). Defaults to undefined → picker always opens.
+     */
+    defaultBlock(name) { this._defaultBlock = name; return this; }
+    reorderable(value = true) { this._reorderable = value; return this; }
+    /**
+     * Force button-only reorder (Up / Down arrows on each row). When `false`
+     * (default), reorderable rows use HTML5 drag-and-drop with the buttons
+     * as a keyboard fallback. Mirrors Filament's
+     * `reorderableWithButtons(bool)`.
+     */
+    reorderableWithButtons(value = true) {
+        this._reorderableWithButtons = value;
+        return this;
+    }
+    collapsible(value = true) { this._collapsible = value; return this; }
+    collapsed(value = true) { this._defaultCollapsed = value; return this; }
+    /**
+     * Accordion mode: only one row open at a time. Picking a different row
+     * collapses the currently-open one. Pair with `collapsed()` to start
+     * with every row collapsed (default is "first row open"). Auto-arms
+     * `collapsible()` since the accordion ergonomic is meaningless on a
+     * non-collapsible builder. Mirrors `RepeaterField.accordion()`.
+     */
+    accordion(value = true) {
+        this._accordion = value;
+        if (value)
+            this._collapsible = true;
+        return this;
+    }
+    cloneable(value = true) { this._cloneable = value; return this; }
+    /**
+     * Hide the `Add block` button. `maxItems` is the validator gate; this is
+     * the separate UX gate (e.g. read-only on a published record). Default `true`.
+     */
+    addable(value = true) { this._addable = value; return this; }
+    /**
+     * Hide the per-row delete button. `minItems` is the validator gate; this
+     * is the UX gate. Default `true`.
+     */
+    deletable(value = true) { this._deletable = value; return this; }
+    /**
+     * Mount inline `+ Insert` zones above each row (and at the very top)
+     * so the user can insert a new block between existing rows without
+     * scrolling to the field's bottom `Add block` button. Mirrors
+     * Filament's `addBetweenAction()` affordance. Additive — the bottom
+     * `Add block` button stays. Respects `addable === false` and
+     * `maxItems`; per-block `Block.maxItems` already filters the picker.
+     */
+    addBetween(value = true) { this._addBetween = value; return this; }
+    /** Position of the `Add block` button. */
+    addActionAlignment(a) {
+        this._addActionAlignment = a;
+        return this;
+    }
+    addActionLabel(label) { this._addActionLabel = label; return this; }
+    /** Grid column count for the picker dropdown. Default 1. */
+    blockPickerColumns(n) { this._blockPickerColumns = n; return this; }
+    /** Show 1-based numbering on each row's header. */
+    blockNumbers(value = true) { this._blockNumbers = value; return this; }
+    /** Show the block's icon in each row's header. Default `true`. */
+    blockIcons(value = true) { this._blockIcons = value; return this; }
+    /** Alias of `blockNumbers` for users coming from Repeater (parity flag). */
+    itemNumbers(value = true) { this._itemNumbers = value; return this; }
+    itemLabel(fn) { this._itemLabel = fn; return this; }
+    itemHidden(rule) { this._itemHidden = rule; return this; }
+    /**
+     * Per-row gate for the trash button. Mirrors `Repeater.itemCanDelete`.
+     * Predicate sees a row-scoped `LayoutContext` with `ctx.row.blockType`
+     * exposing the row's block name so a single rule can branch by block.
+     * Throwing → button stays visible + warn (fail-open, same posture as
+     * `itemHidden`). Presentation only — gate the parent form's lifecycle
+     * hooks for real authorization.
+     */
+    itemCanDelete(rule) { this._itemCanDelete = rule; return this; }
+    /**
+     * Per-row gate for the clone (`Duplicate row`) button. Mirrors
+     * `Repeater.itemCanClone`. No-op when `cloneable()` is off field-wide.
+     */
+    itemCanClone(rule) { this._itemCanClone = rule; return this; }
+    /**
+     * Per-row gate for the reorder controls (drag grip + Up / Down arrows).
+     * Mirrors `Repeater.itemCanReorder`. No-op when `reorderable()` is off
+     * field-wide. Drag targeting is unaffected — non-pinned rows can still
+     * drop at the pinned row's slot; pin both sides to keep a pair adjacent.
+     */
+    itemCanReorder(rule) { this._itemCanReorder = rule; return this; }
+    /**
+     * Per-row action buttons rendered alongside clone/delete in each row's
+     * header. Field-level only in v1 — applies to every block. Per-block
+     * variants (`Block.extraItemActions(...)`) deferred. See
+     * `RepeaterField.extraItemActions` for the dispatch contract; the only
+     * Builder-specific note is that `ctx.row` exposes `blockType` so a
+     * single handler can branch by block.
+     */
+    extraItemActions(actions) {
+        this._extraItemActions = actions;
+        return this;
+    }
+    /**
+     * Lay the ROWS themselves in an n-column grid. Distinct from
+     * `Block.columns(n)`, which grids fields *inside* a single block's
+     * body. Accepts the scalar form (`grid(2)`) or a responsive object
+     * (`grid({ default: 1, md: 2 })`). See `RepeaterField.grid()` for
+     * the shared semantics — same renderer behavior, same drag-indicator
+     * caveat.
+     */
+    grid(config) {
+        const normalized = normalizeGridConfig(config);
+        if (normalized === undefined)
+            delete this._grid;
+        else
+            this._grid = normalized;
+        return this;
+    }
+    /**
+     * Persist rows to a `HasMany` (or `MorphMany` / `MorphOne`) relation on
+     * the parent record instead of serializing them to a JSON column. Each
+     * row maps to a real child record carrying a `type` discriminator + a
+     * JSON `data` payload (column names configurable). Submit creates /
+     * updates / deletes children against the relation transparently.
+     *
+     * For `morphMany`, the child also carries `<morphName>Id` +
+     * `<morphName>Type` columns; the framework stamps both on every create
+     * (and refuses to overwrite them on update) so a tampered POST body
+     * can't reassign a row to a different polymorphic parent. The morph
+     * shape is read off the parent's `static relations[name]` descriptor —
+     * no `foreignKey` override applies.
+     *
+     * Pass either the relationship name as a string (the common case —
+     * `model` + `foreignKey` are auto-discovered from the parent's
+     * `static relations` map; `typeColumn` / `dataColumn` default to
+     * `'type'` / `'data'`) or an object form for explicit overrides.
+     *
+     * Mutually exclusive with `dehydrated(false)` — the field's whole purpose
+     * is to write data, so silently dropping it would be confusing.
+     * Validators run unchanged.
+     */
+    relationship(arg) {
+        if (this.isDehydrated() === false) {
+            throw new Error(`[Pilotiq] Builder "${this.name}": relationship() is incompatible with dehydrated(false) — the field's purpose is to persist data.`);
+        }
+        this._relationship = typeof arg === 'string' ? { name: arg } : { ...arg };
+        return this;
+    }
+    /**
+     * Sugar over `.relationship({ ..., orderColumn: col })`. Sets the order
+     * column on an already-configured relationship; throws when
+     * `relationship()` hasn't been called first so misconfiguration surfaces
+     * eagerly.
+     */
+    orderColumn(col) {
+        if (!this._relationship) {
+            throw new Error(`[Pilotiq] Builder "${this.name}": orderColumn() requires relationship() to be configured first.`);
+        }
+        this._relationship.orderColumn = col;
+        return this;
+    }
+    /**
+     * Customize the bottom Add button's chrome. Equivalent to
+     * `addActionLabel()` plus icon / color / tooltip overrides; the
+     * customizer wins when both are set (it ships under `meta.buttons.add`
+     * which the renderer reads after `addActionLabel`).
+     */
+    addAction(b) { this._buttons.add = b; return this; }
+    /** Customize the per-row clone button. */
+    cloneAction(b) { this._buttons.clone = b; return this; }
+    /** Customize the per-row trash button. */
+    deleteAction(b) { this._buttons.delete = b; return this; }
+    /** Customize the per-row Up arrow. */
+    moveUpAction(b) { this._buttons.moveUp = b; return this; }
+    /** Customize the per-row Down arrow. */
+    moveDownAction(b) { this._buttons.moveDown = b; return this; }
+    /**
+     * Customize the drag-grip handle (label → aria-label, tooltip → title,
+     * icon swaps the glyph, color re-tones the handle). The grip isn't a
+     * real `<button>` so click semantics don't apply.
+     */
+    reorderAction(b) { this._buttons.reorder = b; return this; }
+    /** Customize the per-row collapse chevron. */
+    collapseAction(b) { this._buttons.collapse = b; return this; }
+    // ─── Read-only access ────────────────────────────────
+    getChildren() {
+        // Builder rows are addressed per-row via `getBlocks()` + dotted paths.
+        // Never return them as flat children — the parent walkers must stop
+        // at the Builder boundary, just like RepeaterField.
+        return undefined;
+    }
+    getBlocks() { return this._blocks; }
+    getBlock(name) { return this._blocksByName.get(name); }
+    getMinItems() { return this._minItems; }
+    getMaxItems() { return this._maxItems; }
+    getDefaultBlock() { return this._defaultBlock; }
+    isReorderable() { return this._reorderable; }
+    isReorderableWithButtons() { return this._reorderableWithButtons; }
+    isCollapsible() { return this._collapsible; }
+    isDefaultCollapsed() { return this._defaultCollapsed; }
+    isAccordion() { return this._accordion; }
+    isCloneable() { return this._cloneable; }
+    isAddable() { return this._addable; }
+    isDeletable() { return this._deletable; }
+    isAddBetween() { return this._addBetween; }
+    showsBlockNumbers() { return this._blockNumbers || this._itemNumbers; }
+    showsBlockIcons() { return this._blockIcons; }
+    getBlockPickerColumns() { return this._blockPickerColumns; }
+    getAddActionLabel() { return this._addActionLabel; }
+    getAddActionAlignment() { return this._addActionAlignment; }
+    getItemLabel() { return this._itemLabel; }
+    getItemHidden() { return this._itemHidden; }
+    getItemCanDelete() { return this._itemCanDelete; }
+    getItemCanClone() { return this._itemCanClone; }
+    getItemCanReorder() { return this._itemCanReorder; }
+    getExtraItemActions() { return this._extraItemActions; }
+    getGrid() { return this._grid; }
+    /** Resolved relationship config (`undefined` when not configured). */
+    getRelationship() { return this._relationship; }
+    isRelationship() { return this._relationship !== undefined; }
+    /** The configured customizer for a given slot, or `undefined`. */
+    getButton(kind) { return this._buttons[kind]; }
+    // ─── Meta ────────────────────────────────────────────
+    /**
+     * Bare meta — `rows` and per-row resolved children are populated by
+     * `resolveBuilderRows` in `schema/resolveSchema.ts`. The `blocks` array
+     * (picker entries) ships unconditionally; the picker UI needs it before
+     * the user has added any rows.
+     */
+    toMeta(ctx) {
+        const base = this.buildMeta(ctx);
+        const meta = {
+            ...base,
+            fieldType: 'builder',
+            rows: [],
+            blocks: this._blocks.map(b => b.toMeta()),
+        };
+        if (this._minItems !== undefined)
+            meta.minItems = this._minItems;
+        if (this._maxItems !== undefined)
+            meta.maxItems = this._maxItems;
+        if (this._defaultBlock !== undefined)
+            meta.defaultBlock = this._defaultBlock;
+        if (this._reorderable)
+            meta.reorderable = true;
+        if (this._reorderableWithButtons)
+            meta.reorderableWithButtons = true;
+        if (this._collapsible)
+            meta.collapsible = true;
+        if (this._defaultCollapsed)
+            meta.defaultCollapsed = true;
+        if (this._accordion)
+            meta.accordion = true;
+        if (this._cloneable)
+            meta.cloneable = true;
+        if (this._addable === false)
+            meta.addable = false;
+        if (this._deletable === false)
+            meta.deletable = false;
+        if (this._addBetween)
+            meta.addBetween = true;
+        if (this._blockNumbers)
+            meta.blockNumbers = true;
+        if (this._blockIcons === false)
+            meta.blockIcons = false;
+        if (this._itemNumbers)
+            meta.itemNumbers = true;
+        if (this._blockPickerColumns !== undefined)
+            meta.blockPickerColumns = this._blockPickerColumns;
+        if (this._addActionLabel !== undefined)
+            meta.addActionLabel = this._addActionLabel;
+        if (this._addActionAlignment !== 'start')
+            meta.addActionAlignment = this._addActionAlignment;
+        if (this._grid !== undefined)
+            meta.grid = this._grid;
+        if (this._relationship !== undefined) {
+            const r = { name: this._relationship.name };
+            if (this._relationship.typeColumn !== undefined)
+                r.typeColumn = this._relationship.typeColumn;
+            if (this._relationship.dataColumn !== undefined)
+                r.dataColumn = this._relationship.dataColumn;
+            if (this._relationship.orderColumn !== undefined)
+                r.orderColumn = this._relationship.orderColumn;
+            meta.relationship = r;
+        }
+        const buttons = serializeRowButtons(this._buttons);
+        if (buttons !== undefined)
+            meta.buttons = buttons;
+        return meta;
+    }
+}
+export const Builder = BuilderField;
+/**
+ * Structural Builder check — Vite's SSR module cache can load this
+ * package via two paths during a single dev session, so `instanceof
+ * BuilderField` can silently return false across module copies. The
+ * structural check matches `getType() === 'field'` (Field's discriminator)
+ * + `fieldType === 'builder'`. Same posture as `isRepeaterField`.
+ */
+export function isBuilderField(el) {
+    return el.getType() === 'field' && el['fieldType'] === 'builder';
+}
+//# sourceMappingURL=BuilderField.js.map

package/dist/fields/BuilderField.js.map

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

package/dist/fields/CheckboxField.d.ts

@@ -0,0 +1,18 @@
+import { Field, type FieldMeta } from './Field.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+/**
+ * Single boolean field rendered as a square checkbox + side label.
+ * Distinct from `ToggleField` — Toggle is a pill-style switch and
+ * conventionally signals an active/inactive state, while Checkbox
+ * conventionally signals an opt-in or accept-terms-style choice.
+ *
+ * Both produce the same shape of body value. `coerceFormValues`
+ * normalizes either to `true | false` via the same branch.
+ */
+export declare class CheckboxField extends Field {
+    private constructor();
+    static make(name: string): CheckboxField;
+    toMeta(ctx?: RenderContext): FieldMeta;
+}
+export declare const Checkbox: typeof CheckboxField;
+//# sourceMappingURL=CheckboxField.d.ts.map

package/dist/fields/CheckboxField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckboxField.d.ts","sourceRoot":"","sources":["../../src/fields/CheckboxField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAI/B,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS;CAGhD;AAED,eAAO,MAAM,QAAQ,sBAAgB,CAAA"}

package/dist/fields/CheckboxField.js

@@ -0,0 +1,23 @@
+import { Field } from './Field.js';
+/**
+ * Single boolean field rendered as a square checkbox + side label.
+ * Distinct from `ToggleField` — Toggle is a pill-style switch and
+ * conventionally signals an active/inactive state, while Checkbox
+ * conventionally signals an opt-in or accept-terms-style choice.
+ *
+ * Both produce the same shape of body value. `coerceFormValues`
+ * normalizes either to `true | false` via the same branch.
+ */
+export class CheckboxField extends Field {
+    constructor(name) {
+        super(name, 'checkbox');
+    }
+    static make(name) {
+        return new CheckboxField(name);
+    }
+    toMeta(ctx) {
+        return this.buildMeta(ctx);
+    }
+}
+export const Checkbox = CheckboxField;
+//# sourceMappingURL=CheckboxField.js.map

package/dist/fields/CheckboxField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckboxField.js","sourceRoot":"","sources":["../../src/fields/CheckboxField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAGlD;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAEQ,MAAM,CAAC,GAAmB;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAA"}

package/dist/fields/CheckboxListField.d.ts

@@ -0,0 +1,25 @@
+import { Field, type FieldMeta } from './Field.js';
+import { type OptionsResolver, type SelectOption } from './optionsResolver.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+/**
+ * Multi-choice field. Value is `string[]`. Same `OptionsResolver`
+ * shape as `SelectField` / `RadioField` so dependent options work
+ * everywhere identically.
+ *
+ * `columns(n)` lays the checkboxes out in an `n`-wide grid; default
+ * 1 (vertical stack).
+ */
+export declare class CheckboxListField extends Field {
+    private _options;
+    private _columns;
+    private constructor();
+    static make(name: string): CheckboxListField;
+    options(opts: SelectOption[] | OptionsResolver): this;
+    columns(n: number): this;
+    getOptions(): SelectOption[];
+    hasDynamicOptions(): boolean;
+    getColumns(): number;
+    toMeta(ctx?: RenderContext): Promise<FieldMeta>;
+}
+export declare const CheckboxList: typeof CheckboxListField;
+//# sourceMappingURL=CheckboxListField.d.ts.map

package/dist/fields/CheckboxListField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckboxListField.d.ts","sourceRoot":"","sources":["../../src/fields/CheckboxListField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,QAAQ,CAAI;IAEpB,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAI5C,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,eAAe,GAAG,IAAI;IAKrD,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxB,UAAU,IAAI,YAAY,EAAE;IAI5B,iBAAiB,IAAI,OAAO;IAI5B,UAAU,IAAI,MAAM;IAEL,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;CAc/D;AAED,eAAO,MAAM,YAAY,0BAAoB,CAAA"}

package/dist/fields/CheckboxListField.js

@@ -0,0 +1,46 @@
+import { Field } from './Field.js';
+import { resolveOptions, disableOptionsTakenInSiblings, } from './optionsResolver.js';
+/**
+ * Multi-choice field. Value is `string[]`. Same `OptionsResolver`
+ * shape as `SelectField` / `RadioField` so dependent options work
+ * everywhere identically.
+ *
+ * `columns(n)` lays the checkboxes out in an `n`-wide grid; default
+ * 1 (vertical stack).
+ */
+export class CheckboxListField extends Field {
+    _options = [];
+    _columns = 1;
+    constructor(name) {
+        super(name, 'checkboxList');
+    }
+    static make(name) {
+        return new CheckboxListField(name);
+    }
+    options(opts) {
+        this._options = opts;
+        return this;
+    }
+    columns(n) {
+        this._columns = Math.max(1, Math.floor(n));
+        return this;
+    }
+    getOptions() {
+        return Array.isArray(this._options) ? this._options : [];
+    }
+    hasDynamicOptions() {
+        return typeof this._options === 'function';
+    }
+    getColumns() { return this._columns; }
+    async toMeta(ctx) {
+        const base = this.buildMeta(ctx);
+        const options = disableOptionsTakenInSiblings(await resolveOptions(this._options, ctx, this.name), this.shouldDisableOptionsTakenInSiblings(), this.name, ctx);
+        return {
+            ...base,
+            options,
+            ...(this._columns !== 1 ? { columns: this._columns } : {}),
+        };
+    }
+}
+export const CheckboxList = CheckboxListField;
+//# sourceMappingURL=CheckboxListField.js.map

package/dist/fields/CheckboxListField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckboxListField.js","sourceRoot":"","sources":["../../src/fields/CheckboxListField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,cAAc,EACd,6BAA6B,GAG9B,MAAM,sBAAsB,CAAA;AAG7B;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAClC,QAAQ,GAAqC,EAAE,CAAA;IAC/C,QAAQ,GAAG,CAAC,CAAA;IAEpB,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,CAAC,IAAsC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,CAAC,CAAS;QACf,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1D,CAAC;IAED,iBAAiB;QACf,OAAO,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAA;IAC5C,CAAC;IAED,UAAU,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAA,CAAC,CAAC;IAEpC,KAAK,CAAC,MAAM,CAAC,GAAmB;QACvC,MAAM,IAAI,GAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,6BAA6B,CAC3C,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EACnD,IAAI,CAAC,mCAAmC,EAAE,EAC1C,IAAI,CAAC,IAAI,EACT,GAAG,CACJ,CAAA;QACD,OAAO;YACL,GAAG,IAAI;YACP,OAAO;YACP,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAA;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAA"}

package/dist/fields/ColorPickerField.d.ts

@@ -0,0 +1,16 @@
+import { Field, type FieldMeta } from './Field.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+/**
+ * Hex color input. UI is a native `<input type="color">` plus a text
+ * mirror so users can paste literal hex codes. Value persisted as
+ * `#rrggbb`.
+ *
+ * v1: no swatches preset, no alpha channel.
+ */
+export declare class ColorPickerField extends Field {
+    private constructor();
+    static make(name: string): ColorPickerField;
+    toMeta(ctx?: RenderContext): FieldMeta;
+}
+export declare const ColorPicker: typeof ColorPickerField;
+//# sourceMappingURL=ColorPickerField.d.ts.map

package/dist/fields/ColorPickerField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorPickerField.d.ts","sourceRoot":"","sources":["../../src/fields/ColorPickerField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAIlC,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS;CAGhD;AAED,eAAO,MAAM,WAAW,yBAAmB,CAAA"}

package/dist/fields/ColorPickerField.js

@@ -0,0 +1,21 @@
+import { Field } from './Field.js';
+/**
+ * Hex color input. UI is a native `<input type="color">` plus a text
+ * mirror so users can paste literal hex codes. Value persisted as
+ * `#rrggbb`.
+ *
+ * v1: no swatches preset, no alpha channel.
+ */
+export class ColorPickerField extends Field {
+    constructor(name) {
+        super(name, 'color');
+    }
+    static make(name) {
+        return new ColorPickerField(name);
+    }
+    toMeta(ctx) {
+        return this.buildMeta(ctx);
+    }
+}
+export const ColorPicker = ColorPickerField;
+//# sourceMappingURL=ColorPickerField.js.map

package/dist/fields/ColorPickerField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorPickerField.js","sourceRoot":"","sources":["../../src/fields/ColorPickerField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAGlD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACtB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IAEQ,MAAM,CAAC,GAAmB;QACjC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAA"}

package/dist/fields/DateField.d.ts

@@ -0,0 +1,29 @@
+import { Field, type FieldMeta } from './Field.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+export declare class DateField extends Field {
+    protected _withTime: boolean;
+    protected constructor(name: string, fieldType?: string);
+    static make(name: string): DateField;
+    /**
+     * Include a time picker alongside the date picker. Coerces the
+     * combined `YYYY-MM-DDTHH:mm` body value into a `Date` on submit
+     * (the renderer reads `withTime` off the meta to pick the right
+     * input). Equivalent to using `DateTimePicker.make()` directly,
+     * which constructs with the `'dateTime'` fieldType discriminator
+     * for renderer dispatch.
+     */
+    withTime(value?: boolean): this;
+    hasTime(): boolean;
+    toMeta(ctx?: RenderContext): FieldMeta;
+}
+/**
+ * `DateField` with `.withTime()` baked in. Same class, different
+ * default — for users who'd rather declare intent through the type
+ * than chain a setter.
+ */
+export declare class DateTimePickerField extends DateField {
+    private constructor();
+    static make(name: string): DateTimePickerField;
+}
+export declare const DateTimePicker: typeof DateTimePickerField;
+//# sourceMappingURL=DateField.d.ts.map

package/dist/fields/DateField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateField.d.ts","sourceRoot":"","sources":["../../src/fields/DateField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAS,CAAC,SAAS,UAAQ;IAE3B,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe;IAI9D,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAIpC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,GAAE,OAAc,GAAG,IAAI;IAKrC,OAAO,IAAI,OAAO;IAET,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS;CAMhD;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;CAG/C;AAED,eAAO,MAAM,cAAc,4BAAsB,CAAA"}

package/dist/fields/DateField.js

@@ -0,0 +1,45 @@
+import { Field } from './Field.js';
+export class DateField extends Field {
+    _withTime = false;
+    constructor(name, fieldType = 'date') {
+        super(name, fieldType);
+    }
+    static make(name) {
+        return new DateField(name);
+    }
+    /**
+     * Include a time picker alongside the date picker. Coerces the
+     * combined `YYYY-MM-DDTHH:mm` body value into a `Date` on submit
+     * (the renderer reads `withTime` off the meta to pick the right
+     * input). Equivalent to using `DateTimePicker.make()` directly,
+     * which constructs with the `'dateTime'` fieldType discriminator
+     * for renderer dispatch.
+     */
+    withTime(value = true) {
+        this._withTime = value;
+        return this;
+    }
+    hasTime() { return this._withTime; }
+    toMeta(ctx) {
+        return {
+            ...this.buildMeta(ctx),
+            ...(this._withTime ? { withTime: true } : {}),
+        };
+    }
+}
+/**
+ * `DateField` with `.withTime()` baked in. Same class, different
+ * default — for users who'd rather declare intent through the type
+ * than chain a setter.
+ */
+export class DateTimePickerField extends DateField {
+    constructor(name) {
+        super(name, 'dateTime');
+        this._withTime = true;
+    }
+    static make(name) {
+        return new DateTimePickerField(name);
+    }
+}
+export const DateTimePicker = DateTimePickerField;
+//# sourceMappingURL=DateField.js.map

package/dist/fields/DateField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateField.js","sourceRoot":"","sources":["../../src/fields/DateField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAGlD,MAAM,OAAO,SAAU,SAAQ,KAAK;IACxB,SAAS,GAAG,KAAK,CAAA;IAE3B,YAAsB,IAAY,EAAE,YAAoB,MAAM;QAC5D,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAiB,IAAI;QAC5B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAc,OAAO,IAAI,CAAC,SAAS,CAAA,CAAC,CAAC;IAEnC,MAAM,CAAC,GAAmB;QACjC,OAAO;YACL,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAA;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;IACvB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAA"}

package/dist/fields/EmailField.d.ts

@@ -0,0 +1,8 @@
+import { Field, type FieldMeta } from './Field.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+export declare class EmailField extends Field {
+    private constructor();
+    static make(name: string): EmailField;
+    toMeta(ctx?: RenderContext): FieldMeta;
+}
+//# sourceMappingURL=EmailField.d.ts.map

package/dist/fields/EmailField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailField.d.ts","sourceRoot":"","sources":["../../src/fields/EmailField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAI5B,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS;CAGhD"}