@pilotiq/pilotiq 0.1.0

package/dist/elements/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/elements/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,GAWL,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,KAAK,GAKN,MAAM,YAAY,CAAA"}

package/dist/entries/BadgeEntry.d.ts

@@ -0,0 +1,21 @@
+import { Entry, type EntryMeta } from './Entry.js';
+import type { BadgeColor } from '../columns/BadgeColumn.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+/**
+ * Read-only sibling of `BadgeColumn`. Renders the resolved state value as
+ * a colored pill. Pair with `.colors({ value: BadgeColor })` to map each
+ * value to a preset; unknown values fall back to `gray`.
+ *
+ * @example
+ * BadgeEntry.make('status').colors({ draft: 'gray', published: 'success', archived: 'warning' })
+ */
+export declare class BadgeEntry extends Entry {
+    private _colors;
+    private constructor();
+    static make(name: string): BadgeEntry;
+    /** value→color preset map. Unknown values render as `gray`. */
+    colors(map: Record<string, BadgeColor>): this;
+    protected getEntryType(): string;
+    toMeta(ctx?: RenderContext): Promise<EntryMeta>;
+}
+//# sourceMappingURL=BadgeEntry.d.ts.map

package/dist/entries/BadgeEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BadgeEntry.d.ts","sourceRoot":"","sources":["../../src/entries/BadgeEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAO,CAAC,OAAO,CAAiC;IAEhD,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAIrC,+DAA+D;IAC/D,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;cAK1B,YAAY,IAAI,MAAM;IAE1B,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;CAO/D"}

package/dist/entries/BadgeEntry.js

@@ -0,0 +1,32 @@
+import { Entry } from './Entry.js';
+/**
+ * Read-only sibling of `BadgeColumn`. Renders the resolved state value as
+ * a colored pill. Pair with `.colors({ value: BadgeColor })` to map each
+ * value to a preset; unknown values fall back to `gray`.
+ *
+ * @example
+ * BadgeEntry.make('status').colors({ draft: 'gray', published: 'success', archived: 'warning' })
+ */
+export class BadgeEntry extends Entry {
+    _colors = {};
+    constructor(name) {
+        super(name);
+    }
+    static make(name) {
+        return new BadgeEntry(name);
+    }
+    /** value→color preset map. Unknown values render as `gray`. */
+    colors(map) {
+        this._colors = { ...this._colors, ...map };
+        return this;
+    }
+    getEntryType() { return 'badge'; }
+    async toMeta(ctx) {
+        const meta = await Promise.resolve(super.toMeta(ctx));
+        if (Object.keys(this._colors).length > 0) {
+            meta.colors = this._colors;
+        }
+        return meta;
+    }
+}
+//# sourceMappingURL=BadgeEntry.js.map

package/dist/entries/BadgeEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BadgeEntry.js","sourceRoot":"","sources":["../../src/entries/BadgeEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAIlD;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC3B,OAAO,GAA+B,EAAE,CAAA;IAEhD,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAA;IACb,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,GAA+B;QACpC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAA;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAEkB,YAAY,KAAa,OAAO,OAAO,CAAA,CAAC,CAAC;IAEnD,KAAK,CAAC,MAAM,CAAC,GAAmB;QACvC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAwD,CAAA;QAC5G,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/entries/CodeEntry.d.ts

@@ -0,0 +1,38 @@
+import { Entry, type EntryMeta } from './Entry.js';
+export interface CodeEntryMeta extends EntryMeta {
+    language?: string;
+}
+/**
+ * Read-only sibling of `CodeEditorField` — renders the resolved value as
+ * `<pre><code>` with a monospace font. Pairs with `Resource.detail()` for
+ * showing user-supplied code, JSON blobs, or config snippets.
+ *
+ * v1 ships **without bundled syntax highlighting** to keep the core
+ * package small. Pass a `language()` hint and a consumer can register a
+ * highlighter via the existing rich-text renderer registry pattern (or
+ * the upcoming `@pilotiq/codemirror` adapter's read-only mode); without
+ * a registered highlighter the entry renders plain monospaced text.
+ *
+ *   CodeEntry.make('payload').language('json').copyable()
+ *
+ * Honors all the inherited chrome (`color / size / weight / tooltip /
+ * copyable`), though `weight` is rarely useful on code blocks.
+ *
+ * For PHP arrays / JS objects, set `formatStateUsing(JSON.stringify)`
+ * to control the wire shape — entries don't auto-stringify objects.
+ */
+export declare class CodeEntry extends Entry {
+    private _language?;
+    private constructor();
+    static make(name: string): CodeEntry;
+    /**
+     * Language hint passed through to the meta (`'json' | 'ts' | 'html' |
+     * …`). Plays the same role as `CodeEditorField.language()` — opaque to
+     * the framework, consumed by an optional highlighter registered by
+     * the consumer.
+     */
+    language(id: string): this;
+    protected getEntryType(): string;
+    toMeta(ctx?: Parameters<Entry['toMeta']>[0]): CodeEntryMeta;
+}
+//# sourceMappingURL=CodeEntry.d.ts.map

package/dist/entries/CodeEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeEntry.d.ts","sourceRoot":"","sources":["../../src/entries/CodeEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,OAAO,CAAC,SAAS,CAAC,CAAQ;IAE1B,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAIpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;cAEP,YAAY,IAAI,MAAM;IAEhC,MAAM,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa;CAKrE"}

package/dist/entries/CodeEntry.js

@@ -0,0 +1,44 @@
+import { Entry } from './Entry.js';
+/**
+ * Read-only sibling of `CodeEditorField` — renders the resolved value as
+ * `<pre><code>` with a monospace font. Pairs with `Resource.detail()` for
+ * showing user-supplied code, JSON blobs, or config snippets.
+ *
+ * v1 ships **without bundled syntax highlighting** to keep the core
+ * package small. Pass a `language()` hint and a consumer can register a
+ * highlighter via the existing rich-text renderer registry pattern (or
+ * the upcoming `@pilotiq/codemirror` adapter's read-only mode); without
+ * a registered highlighter the entry renders plain monospaced text.
+ *
+ *   CodeEntry.make('payload').language('json').copyable()
+ *
+ * Honors all the inherited chrome (`color / size / weight / tooltip /
+ * copyable`), though `weight` is rarely useful on code blocks.
+ *
+ * For PHP arrays / JS objects, set `formatStateUsing(JSON.stringify)`
+ * to control the wire shape — entries don't auto-stringify objects.
+ */
+export class CodeEntry extends Entry {
+    _language;
+    constructor(name) {
+        super(name);
+    }
+    static make(name) {
+        return new CodeEntry(name);
+    }
+    /**
+     * Language hint passed through to the meta (`'json' | 'ts' | 'html' |
+     * …`). Plays the same role as `CodeEditorField.language()` — opaque to
+     * the framework, consumed by an optional highlighter registered by
+     * the consumer.
+     */
+    language(id) { this._language = id; return this; }
+    getEntryType() { return 'code'; }
+    toMeta(ctx) {
+        const meta = super.toMeta(ctx);
+        if (this._language !== undefined)
+            meta.language = this._language;
+        return meta;
+    }
+}
+//# sourceMappingURL=CodeEntry.js.map

package/dist/entries/CodeEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeEntry.js","sourceRoot":"","sources":["../../src/entries/CodeEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAMlD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC1B,SAAS,CAAS;IAE1B,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAA;IACb,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,EAAU,IAAU,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE5C,YAAY,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAElD,MAAM,CAAC,GAAoC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAkB,CAAA;QAC/C,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAA;QAChE,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/entries/ColorEntry.d.ts

@@ -0,0 +1,32 @@
+import { Entry, type EntryMeta } from './Entry.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+export type ColorEntryShape = 'square' | 'rounded' | 'circle';
+/**
+ * Read-only swatch entry — sibling of `ColorPickerField`. The state value
+ * is a CSS color string (`#aabbcc`, `rgb(…)`, `oklch(…)`, …) rendered as
+ * a colored chip. The raw value is shown beside the chip by default; toggle
+ * with `.copyable()` for click-to-copy on the value text.
+ *
+ * @example
+ * ColorEntry.make('brandColor').dimensions(24).circle()
+ */
+export declare class ColorEntry extends Entry {
+    private _width;
+    private _height;
+    private _shape;
+    private _showValue;
+    private constructor();
+    static make(name: string): ColorEntry;
+    width(px: number): this;
+    height(px: number): this;
+    /** Square sugar — sets width and height to the same pixel value. */
+    dimensions(px: number): this;
+    square(): this;
+    rounded(): this;
+    circle(): this;
+    /** Hide the raw color string next to the swatch (chip only). */
+    hideValue(v?: boolean): this;
+    protected getEntryType(): string;
+    toMeta(ctx?: RenderContext): Promise<EntryMeta>;
+}
+//# sourceMappingURL=ColorEntry.d.ts.map

package/dist/entries/ColorEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorEntry.d.ts","sourceRoot":"","sources":["../../src/entries/ColorEntry.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,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE7D;;;;;;;;GAQG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAO;IAEzB,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAIrC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IACvB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAExB,oEAAoE;IACpE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAM5B,MAAM,IAAI,IAAI;IACd,OAAO,IAAI,IAAI;IACf,MAAM,IAAI,IAAI;IAEd,gEAAgE;IAChE,SAAS,CAAC,CAAC,UAAO,GAAG,IAAI;cAEN,YAAY,IAAI,MAAM;IAE1B,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;CAe/D"}

package/dist/entries/ColorEntry.js

@@ -0,0 +1,48 @@
+import { Entry } from './Entry.js';
+/**
+ * Read-only swatch entry — sibling of `ColorPickerField`. The state value
+ * is a CSS color string (`#aabbcc`, `rgb(…)`, `oklch(…)`, …) rendered as
+ * a colored chip. The raw value is shown beside the chip by default; toggle
+ * with `.copyable()` for click-to-copy on the value text.
+ *
+ * @example
+ * ColorEntry.make('brandColor').dimensions(24).circle()
+ */
+export class ColorEntry extends Entry {
+    _width = 24;
+    _height = 24;
+    _shape = 'rounded';
+    _showValue = true;
+    constructor(name) {
+        super(name);
+    }
+    static make(name) {
+        return new ColorEntry(name);
+    }
+    width(px) { this._width = px; return this; }
+    height(px) { this._height = px; return this; }
+    /** Square sugar — sets width and height to the same pixel value. */
+    dimensions(px) {
+        this._width = px;
+        this._height = px;
+        return this;
+    }
+    square() { this._shape = 'square'; return this; }
+    rounded() { this._shape = 'rounded'; return this; }
+    circle() { this._shape = 'circle'; return this; }
+    /** Hide the raw color string next to the swatch (chip only). */
+    hideValue(v = true) { this._showValue = !v; return this; }
+    getEntryType() { return 'color'; }
+    async toMeta(ctx) {
+        const meta = await Promise.resolve(super.toMeta(ctx));
+        meta.colorWidth = this._width;
+        meta.colorHeight = this._height;
+        meta.colorShape = this._shape;
+        if (this._width === this._height)
+            meta.colorSize = this._width;
+        if (!this._showValue)
+            meta.showValue = false;
+        return meta;
+    }
+}
+//# sourceMappingURL=ColorEntry.js.map

package/dist/entries/ColorEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorEntry.js","sourceRoot":"","sources":["../../src/entries/ColorEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAKlD;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC3B,MAAM,GAAI,EAAE,CAAA;IACZ,OAAO,GAAG,EAAE,CAAA;IACZ,MAAM,GAAoB,SAAS,CAAA;IACnC,UAAU,GAAG,IAAI,CAAA;IAEzB,YAAoB,IAAY;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAA;IACb,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY;QACtB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,EAAU,IAAW,IAAI,CAAC,MAAM,GAAI,EAAE,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAU,IAAU,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE3D,oEAAoE;IACpE,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,MAAM,GAAI,EAAE,CAAA;QACjB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAY,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAE,OAAO,IAAI,CAAA,CAAC,CAAC;IACxD,OAAO,KAAW,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IACxD,MAAM,KAAY,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAE,OAAO,IAAI,CAAA,CAAC,CAAC;IAExD,gEAAgE;IAChE,SAAS,CAAC,CAAC,GAAG,IAAI,IAAU,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE5C,YAAY,KAAa,OAAO,OAAO,CAAA,CAAC,CAAC;IAEnD,KAAK,CAAC,MAAM,CAAC,GAAmB;QACvC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAMnD,CAAA;QACD,IAAI,CAAC,UAAU,GAAI,IAAI,CAAC,MAAM,CAAA;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAA;QAC/B,IAAI,CAAC,UAAU,GAAI,IAAI,CAAC,MAAM,CAAA;QAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAA;QAC9D,IAAI,CAAC,IAAI,CAAC,UAAU;YAAc,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACxD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/entries/ComponentEntry.d.ts

@@ -0,0 +1,66 @@
+import { Entry, type EntryMeta } from './Entry.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+/**
+ * Escape-hatch infolist entry. Hands rendering off to a user-supplied
+ * React component registered via `registerEntryComponents()`. Useful
+ * when the built-in entries (Text/Badge/Icon/Image/KeyValue/Color) don't
+ * fit — a coordinates map, an audit-trail timeline, an embedded chart.
+ *
+ * Two usage patterns mirror the `View` widget shape:
+ *
+ * **Subclass form** — extend `ComponentEntry` so the component reference
+ * lives as a static on a stable class:
+ *
+ *   import { ComponentEntry } from '@pilotiq/pilotiq'
+ *   export class CoordinatesMap extends ComponentEntry {
+ *     static componentName = 'CoordinatesMap'
+ *   }
+ *
+ *   // bootstrap/providers.ts
+ *   registerEntryComponents({ CoordinatesMap })
+ *
+ *   // Resource.detail()
+ *   CoordinatesMap.make('location').label('Where')
+ *
+ * **Fluent form** — for one-off cases where a subclass is overkill:
+ *
+ *   ComponentEntry.make('location').component('CoordinatesMap')
+ *
+ * The component receives `{ value, record }` as its sole props — `value`
+ * is the entry's resolved state value (honors `.state(path | fn)` like
+ * any other entry) and `record` is the full loaded record. Components
+ * are looked up at render through the entry-component registry (see
+ * `@pilotiq/pilotiq/entries`).
+ */
+export declare class ComponentEntry extends Entry {
+    /**
+     * Component name used to look up the registered React component at
+     * render time. Subclasses set this as a static; the fluent form sets
+     * it via `.component(name)`.
+     *
+     * (Despite the name, this is a *string key* into the runtime registry,
+     * not a component reference itself — keeps `ComponentEntry` shippable
+     * through `viewProps` and avoids the `_components.ts` manifest walker,
+     * mirroring the `View` widget convention.)
+     */
+    static componentName?: string;
+    protected _componentName?: string;
+    constructor(name: string);
+    static make(this: new (name: string) => ComponentEntry, name: string): ComponentEntry;
+    /** Set / override the registered component name. */
+    component(name: string): this;
+    protected getEntryType(): string;
+    /** Resolve the effective component name (instance > static > fallback to entry name). */
+    getComponentName(): string;
+    /**
+     * Builds the wire meta with `entryType: 'component'` plus the
+     * registered component-name lookup key. Inherits `value`, `label`,
+     * chrome, and `_formatted` from `Entry.toMeta` — the renderer wraps
+     * the user component in `<EntryShell>` for label / helperText / tooltip
+     * / copyable parity with every other entry leaf.
+     */
+    toMeta(ctx?: RenderContext): EntryMeta & {
+        component: string;
+    };
+}
+//# sourceMappingURL=ComponentEntry.d.ts.map

package/dist/entries/ComponentEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentEntry.d.ts","sourceRoot":"","sources":["../../src/entries/ComponentEntry.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAE7B,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;gBAKrB,IAAI,EAAE,MAAM;IAIxB,MAAM,CAAC,IAAI,CACT,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,KAAK,cAAc,EAC1C,IAAI,EAAE,MAAM,GACX,cAAc;IAIjB,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;cAKV,YAAY,IAAI,MAAM;IAEzC,yFAAyF;IACzF,gBAAgB,IAAI,MAAM;IAU1B;;;;;;OAMG;IACM,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE;CAIxE"}

package/dist/entries/ComponentEntry.js

@@ -0,0 +1,86 @@
+import { Entry } from './Entry.js';
+/**
+ * Escape-hatch infolist entry. Hands rendering off to a user-supplied
+ * React component registered via `registerEntryComponents()`. Useful
+ * when the built-in entries (Text/Badge/Icon/Image/KeyValue/Color) don't
+ * fit — a coordinates map, an audit-trail timeline, an embedded chart.
+ *
+ * Two usage patterns mirror the `View` widget shape:
+ *
+ * **Subclass form** — extend `ComponentEntry` so the component reference
+ * lives as a static on a stable class:
+ *
+ *   import { ComponentEntry } from '@pilotiq/pilotiq'
+ *   export class CoordinatesMap extends ComponentEntry {
+ *     static componentName = 'CoordinatesMap'
+ *   }
+ *
+ *   // bootstrap/providers.ts
+ *   registerEntryComponents({ CoordinatesMap })
+ *
+ *   // Resource.detail()
+ *   CoordinatesMap.make('location').label('Where')
+ *
+ * **Fluent form** — for one-off cases where a subclass is overkill:
+ *
+ *   ComponentEntry.make('location').component('CoordinatesMap')
+ *
+ * The component receives `{ value, record }` as its sole props — `value`
+ * is the entry's resolved state value (honors `.state(path | fn)` like
+ * any other entry) and `record` is the full loaded record. Components
+ * are looked up at render through the entry-component registry (see
+ * `@pilotiq/pilotiq/entries`).
+ */
+export class ComponentEntry extends Entry {
+    /**
+     * Component name used to look up the registered React component at
+     * render time. Subclasses set this as a static; the fluent form sets
+     * it via `.component(name)`.
+     *
+     * (Despite the name, this is a *string key* into the runtime registry,
+     * not a component reference itself — keeps `ComponentEntry` shippable
+     * through `viewProps` and avoids the `_components.ts` manifest walker,
+     * mirroring the `View` widget convention.)
+     */
+    static componentName;
+    _componentName;
+    // Public for `make()`'s `new this(name)` factory call from subclasses —
+    // a protected ctor here breaks `class Foo extends ComponentEntry {}; Foo.make('x')`
+    // because the typeof Foo signature wouldn't satisfy `new (name) => ComponentEntry`.
+    constructor(name) {
+        super(name);
+    }
+    static make(name) {
+        return new this(name);
+    }
+    /** Set / override the registered component name. */
+    component(name) {
+        this._componentName = name;
+        return this;
+    }
+    getEntryType() { return 'component'; }
+    /** Resolve the effective component name (instance > static > fallback to entry name). */
+    getComponentName() {
+        if (this._componentName)
+            return this._componentName;
+        const ctor = this.constructor;
+        if (ctor.componentName)
+            return ctor.componentName;
+        // Last resort — use the entry's `name`, mirroring `View.getId()`'s
+        // fallback. The renderer surfaces a "component not registered" error
+        // when the registry doesn't carry it.
+        return this._name;
+    }
+    /**
+     * Builds the wire meta with `entryType: 'component'` plus the
+     * registered component-name lookup key. Inherits `value`, `label`,
+     * chrome, and `_formatted` from `Entry.toMeta` — the renderer wraps
+     * the user component in `<EntryShell>` for label / helperText / tooltip
+     * / copyable parity with every other entry leaf.
+     */
+    toMeta(ctx) {
+        const meta = super.toMeta(ctx);
+        return { ...meta, component: this.getComponentName() };
+    }
+}
+//# sourceMappingURL=ComponentEntry.js.map

package/dist/entries/ComponentEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentEntry.js","sourceRoot":"","sources":["../../src/entries/ComponentEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,CAAS;IAEnB,cAAc,CAAS;IAEjC,wEAAwE;IACxE,oFAAoF;IACpF,oFAAoF;IACpF,YAAY,IAAY;QACtB,KAAK,CAAC,IAAI,CAAC,CAAA;IACb,CAAC;IAED,MAAM,CAAC,IAAI,CAET,IAAY;QAEZ,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED,oDAAoD;IACpD,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IAEkB,YAAY,KAAa,OAAO,WAAW,CAAA,CAAC,CAAC;IAEhE,yFAAyF;IACzF,gBAAgB;QACd,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC,cAAc,CAAA;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAyC,CAAA;QAC3D,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAA;QACjD,mEAAmE;QACnE,qEAAqE;QACrE,sCAAsC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;;;OAMG;IACM,MAAM,CAAC,GAAmB;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAc,CAAA;QAC3C,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAA;IACxD,CAAC;CACF"}

package/dist/entries/Entry.d.ts

@@ -0,0 +1,175 @@
+import { Element, type ElementMeta } from '../schema/Element.js';
+import type { RenderContext } from '../schema/resolveSchema.js';
+/**
+ * Per-record formatter callback. Receives the resolved state value and the
+ * full record; returns the rendered string. Runs server-side at resolve
+ * time — output is stamped on `EntryMeta._formatted` so the renderer can
+ * skip re-running the format spec.
+ */
+export type EntryFormatStateHandler = (value: unknown, record: Record<string, unknown>) => string;
+/**
+ * Override for `Entry.resolveValue`. String form is dotted-path traversal
+ * (`'author.name'`, `'tags.0.name'`); function form runs the user handler
+ * with the full record. Used for joins, computed columns, or anywhere the
+ * value isn't `record[name]`.
+ */
+export type EntryStateResolver = string | ((record: Record<string, unknown>) => unknown);
+/** Built-in formatters — same shape as `ColumnFormat` so the renderer
+ *  reuses `applyColumnFormat()` unchanged. */
+export type EntryFormat = {
+    kind: 'dateTime';
+    pattern?: string;
+} | {
+    kind: 'since';
+} | {
+    kind: 'money';
+    currency: string;
+    locale?: string;
+} | {
+    kind: 'numeric';
+    decimals?: number;
+    locale?: string;
+} | {
+    kind: 'limit';
+    chars: number;
+};
+export type EntryWeight = 'normal' | 'medium' | 'semibold' | 'bold';
+export type EntryColor = 'default' | 'muted' | 'primary' | 'destructive' | 'success' | 'warning' | 'info';
+export type EntrySize = 'xs' | 'sm' | 'base' | 'lg' | 'xl';
+/**
+ * JSON shape sent to the client for every entry. Subclasses extend the
+ * union via `entryType` (`'text' | 'badge' | 'icon' | 'image'`) and
+ * tack on subclass-specific keys without further widening.
+ */
+export interface EntryMeta extends ElementMeta {
+    type: 'entry';
+    entryType: string;
+    name: string;
+    label: string;
+    value: unknown;
+    inlineLabel?: boolean;
+    default?: string;
+    helperText?: string;
+    tooltip?: string;
+    weight?: EntryWeight;
+    color?: EntryColor;
+    size?: EntrySize;
+    format?: EntryFormat;
+    copyable?: {
+        label?: string;
+    };
+    /**
+     * Server-evaluated `formatStateUsing` output. The renderer prefers this
+     * over re-applying `format` when present (mirrors the `Column._formatted`
+     * convention from Plan #2).
+     */
+    _formatted?: string;
+    lineClamp?: number;
+    wrap?: boolean;
+}
+/**
+ * Read-only sibling of `Field`. Renders a label-value pair on `ViewPage`
+ * (or anywhere `Resource.detail()` returns elements).
+ *
+ * Entries resolve their value from `ctx.record[name]` at meta-build time
+ * — they're inert templates with no input components, no validators, no
+ * submit chrome. The cosmetic surface (`color / weight / size / tooltip`)
+ * mirrors the `Column` chrome so rows of a table and detail-page entries
+ * stay visually consistent.
+ *
+ * Subclasses set the `entryType` discriminator (`'text' | 'badge' | …`)
+ * which the renderer dispatches on; everything else lives on the base.
+ */
+export declare abstract class Entry extends Element {
+    protected _name: string;
+    protected _label?: string;
+    protected _inlineLabel: boolean;
+    protected _default?: string;
+    protected _helperText?: string;
+    protected _tooltip?: string;
+    protected _weight?: EntryWeight;
+    protected _color?: EntryColor;
+    protected _size?: EntrySize;
+    protected _format?: EntryFormat;
+    protected _formatState?: EntryFormatStateHandler;
+    protected _state?: EntryStateResolver;
+    protected _copyable?: {
+        label?: string;
+    };
+    protected _lineClamp?: number;
+    protected _wrap: boolean;
+    protected constructor(name: string);
+    /** Subclasses set the wire-side discriminator (`'text' | 'badge' | …`). */
+    protected abstract getEntryType(): string;
+    getType(): string;
+    getName(): string;
+    /** Override the auto-derived label. Default = startCase of `name`. */
+    label(text: string): this;
+    /** Render label to the left of the value rather than above it. */
+    inlineLabel(v?: boolean): this;
+    /** Fallback string when the resolved value is null / undefined / empty. */
+    default(s: string): this;
+    /** Alias matching the field-side spelling. */
+    placeholder(s: string): this;
+    helperText(text: string): this;
+    tooltip(text: string): this;
+    weight(w: EntryWeight): this;
+    color(c: EntryColor): this;
+    size(s: EntrySize): this;
+    /** Truncate the value with an ellipsis when it spills onto more than `n`
+     *  lines (CSS `-webkit-line-clamp`). Mutually exclusive with `wrap()`. */
+    lineClamp(n: number): this;
+    /** Allow the value to wrap onto multiple lines. Without this the value
+     *  is rendered with `whitespace-nowrap`. */
+    wrap(v?: boolean): this;
+    dateTime(pattern?: string): this;
+    since(): this;
+    money(currency: string, locale?: string): this;
+    numeric(opts?: {
+        decimals?: number;
+        locale?: string;
+    }): this;
+    limit(chars: number): this;
+    /** Per-record formatter — receives the resolved state value and the full
+     *  record, returns the display string. Wins over `format` when both are
+     *  set (output stamped on `_formatted`). */
+    formatStateUsing(fn: EntryFormatStateHandler): this;
+    /** Render a copy-icon button next to the value. v1 copies via the
+     *  client `navigator.clipboard.writeText` of the *raw* state value, or
+     *  the formatted string when `formatStateUsing` is set. */
+    copyable(label?: string): this;
+    /**
+     * Override the default `record[name]` lookup. String form does dotted-
+     * path traversal — `'author.name'`, `'tags.0.label'`; missing
+     * intermediates resolve to `undefined`. Function form runs the
+     * user-supplied accessor with the full record.
+     *
+     * The entry's `name` still drives the auto-derived label and the wire-
+     * side discriminator key, so use `.label(...)` alongside when the path
+     * doesn't read well as a heading.
+     *
+     * @example
+     * TextEntry.make('authorName').state('author.name').label('Author')
+     * TextEntry.make('total').state(r => Number(r.subtotal) + Number(r.tax))
+     */
+    state(resolver: EntryStateResolver): this;
+    /** Read the state value out of the loaded record. Honors `state()`
+     *  override (string dotted-path or accessor fn) when set; otherwise
+     *  falls back to `record[name]`. */
+    resolveValue(ctx?: RenderContext): unknown;
+    /** Default label = startCase of the attribute name. */
+    protected deriveLabel(): string;
+    /**
+     * Build the wire-side meta. Subclasses override to add type-specific
+     * keys; all should call `super.toMeta(ctx)` first and spread.
+     *
+     * Async because `formatStateUsing` may want to await a lookup; v1
+     * callers pass synchronous handlers but the contract leaves room.
+     */
+    toMeta(ctx?: RenderContext): EntryMeta | Promise<EntryMeta>;
+}
+/** Type guard mirroring `isServerDataElement` / `isRepeaterField`. Lets
+ *  walkers branch on entries without `instanceof`-tripping over Vite
+ *  module-cache duplication (`feedback_vite_ssr_module_dup_instanceof`). */
+export declare function isEntry(el: Element): el is Entry;
+//# sourceMappingURL=Entry.d.ts.map

package/dist/entries/Entry.d.ts.map

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