@pilotiq/pilotiq 0.1.0

package/dist/entries/RepeatableEntry.js

@@ -0,0 +1,121 @@
+import { Entry } from './Entry.js';
+/**
+ * Read-only sibling of `RepeaterField`. Renders an array stored on the
+ * record (`ctx.record[name]`) as a stack of cards (default), an n-column
+ * grid (`grid(n)`), or a compact HTML table (`table([…])`), with the inner
+ * schema resolved once per row against that row's record.
+ *
+ * Each row's children resolve with `ctx.record` set to the row's data, so
+ * inner entries (`TextEntry / BadgeEntry / IconEntry / ImageEntry / …`) read
+ * their state via the same `record[name]` lookup they use everywhere else.
+ *
+ * `RepeatableEntry` does not coerce or validate — the value at
+ * `ctx.record[name]` is read as-is. Non-array / null / undefined / empty-
+ * array values render the inherited `default()` placeholder.
+ *
+ * @example
+ * RepeatableEntry.make('lineItems').schema([
+ *   TextEntry.make('description'),
+ *   TextEntry.make('quantity').numeric(),
+ *   TextEntry.make('total').money('USD'),
+ * ]).table([
+ *   { label: 'Item' },
+ *   { label: 'Qty', alignment: 'right' },
+ *   { label: 'Total', alignment: 'right' },
+ * ])
+ */
+export class RepeatableEntry extends Entry {
+    _children = [];
+    _columns;
+    _grid;
+    _tableColumns;
+    _contained = true;
+    constructor(name) {
+        super(name);
+    }
+    static make(name) {
+        return new RepeatableEntry(name);
+    }
+    getEntryType() { return 'repeatable'; }
+    /** Inner schema rendered per row. */
+    schema(elements) {
+        this._children = elements;
+        return this;
+    }
+    /** Grid column count for the inner schema *inside* one card (mirrors
+     *  `Repeater.columns`). Ignored under table mode. */
+    columns(n) { this._columns = n; return this; }
+    /**
+     * Lay the rows themselves in an n-column grid. Mirrors `Repeater.grid(n)`
+     * but read-only and v1 only takes a fixed integer (the responsive object
+     * form on Repeater is a form-side ergonomic — defer until asked).
+     *
+     * `n < 2` resets to vertical stack (the default).
+     */
+    grid(n) {
+        if (n >= 2)
+            this._grid = n;
+        else
+            delete this._grid;
+        return this;
+    }
+    /**
+     * Compact `<table>` layout — one `<tr>` per row, one `<td>` per inner
+     * entry, with the supplied headers above. Columns map 1:1 to inner
+     * schema entries by declaration order.
+     *
+     * Mutually exclusive with `columns / grid` at render time (the renderer
+     * dispatches `table > grid > stack`). Pass an empty array to clear.
+     */
+    table(columns) {
+        if (columns.length === 0)
+            delete this._tableColumns;
+        else
+            this._tableColumns = columns;
+        return this;
+    }
+    /**
+     * Toggle the outer card chrome. `contained(false)` drops the card border
+     * + padding so each row sits flush — useful when the inner schema brings
+     * its own visual container (a `Section.aside()` per row, say).
+     */
+    contained(v = true) { this._contained = v; return this; }
+    // ─── Read-only access for the resolver ──────────────────
+    getChildren() {
+        return this._children.length > 0 ? this._children : undefined;
+    }
+    /** Direct access to the inner schema — used by `resolveRepeatableRows`. */
+    getInnerSchema() { return this._children; }
+    getColumns() { return this._columns; }
+    getGrid() { return this._grid; }
+    getTableColumns() { return this._tableColumns; }
+    isContained() { return this._contained; }
+    async toMeta(ctx) {
+        const meta = await Promise.resolve(super.toMeta(ctx));
+        meta.rows = [];
+        if (this._columns !== undefined)
+            meta.columns = this._columns;
+        if (this._grid !== undefined)
+            meta.grid = this._grid;
+        if (this._tableColumns !== undefined)
+            meta.table = { columns: this._tableColumns };
+        if (!this._contained)
+            meta.contained = false;
+        return meta;
+    }
+}
+/** Read a row's stable id off common conventions; falls back to the row
+ *  index when the row carries no id-ish field. Mirrors `readRowId` over in
+ *  `resolveSchema.ts` but inlined here so the entry layer doesn't depend on
+ *  Repeater internals. */
+export function readRepeatableRowId(row, fieldName, index) {
+    if (row && typeof row === 'object' && !Array.isArray(row)) {
+        const r = row;
+        const candidate = r['id'] ?? r['__id'] ?? r['uuid'];
+        if (typeof candidate === 'string' || typeof candidate === 'number') {
+            return String(candidate);
+        }
+    }
+    return `${fieldName}-${index}`;
+}
+//# sourceMappingURL=RepeatableEntry.js.map

package/dist/entries/RepeatableEntry.js.map

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

package/dist/entries/TextEntry.d.ts

@@ -0,0 +1,38 @@
+import type { RenderContext } from '../schema/resolveSchema.js';
+import { Entry, type EntryMeta } from './Entry.js';
+export interface TextEntryMeta extends EntryMeta {
+    /** True when the value was auto-rendered from Tiptap rich-text content;
+     *  the renderer should inject the value via `dangerouslySetInnerHTML`
+     *  rather than escape it as plain text. */
+    richtext?: true;
+}
+/**
+ * The default infolist entry. Renders a label-value pair with the value
+ * as plain text; honors all the inherited chrome (`color / weight / size
+ * / lineClamp / wrap / tooltip / copyable`) and built-in formatters
+ * (`since / dateTime / money / numeric / limit`).
+ *
+ * **Rich-text auto-render:** when an adapter package has registered a
+ * renderer (`@pilotiq/tiptap` does this on `registerTiptap()`) and the
+ * resolved value is recognizably Tiptap content, `TextEntry` ships
+ * finished HTML in `_formatted` and flips `richtext: true` so the client
+ * renders the markup. No-op when no renderer is registered or the value
+ * is plain text.
+ *
+ * @example
+ * Resource.detail(record) {
+ *   return [
+ *     TextEntry.make('email').copyable(),
+ *     TextEntry.make('publishedAt').since(),
+ *     TextEntry.make('amount').money('USD').weight('semibold'),
+ *     TextEntry.make('body'),                       // auto-renders Tiptap JSON
+ *   ]
+ * }
+ */
+export declare class TextEntry extends Entry {
+    private constructor();
+    static make(name: string): TextEntry;
+    protected getEntryType(): string;
+    toMeta(ctx?: RenderContext): TextEntryMeta;
+}
+//# sourceMappingURL=TextEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextEntry.d.ts","sourceRoot":"","sources":["../../src/entries/TextEntry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C;;+CAE2C;IAC3C,QAAQ,CAAC,EAAE,IAAI,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;cAIjB,YAAY,IAAI,MAAM;IAEhC,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,aAAa;CAcpD"}

package/dist/entries/TextEntry.js

@@ -0,0 +1,49 @@
+import { tryRenderRichText } from '../richtext/registry.js';
+import { Entry } from './Entry.js';
+/**
+ * The default infolist entry. Renders a label-value pair with the value
+ * as plain text; honors all the inherited chrome (`color / weight / size
+ * / lineClamp / wrap / tooltip / copyable`) and built-in formatters
+ * (`since / dateTime / money / numeric / limit`).
+ *
+ * **Rich-text auto-render:** when an adapter package has registered a
+ * renderer (`@pilotiq/tiptap` does this on `registerTiptap()`) and the
+ * resolved value is recognizably Tiptap content, `TextEntry` ships
+ * finished HTML in `_formatted` and flips `richtext: true` so the client
+ * renders the markup. No-op when no renderer is registered or the value
+ * is plain text.
+ *
+ * @example
+ * Resource.detail(record) {
+ *   return [
+ *     TextEntry.make('email').copyable(),
+ *     TextEntry.make('publishedAt').since(),
+ *     TextEntry.make('amount').money('USD').weight('semibold'),
+ *     TextEntry.make('body'),                       // auto-renders Tiptap JSON
+ *   ]
+ * }
+ */
+export class TextEntry extends Entry {
+    constructor(name) {
+        super(name);
+    }
+    static make(name) {
+        return new TextEntry(name);
+    }
+    getEntryType() { return 'text'; }
+    toMeta(ctx) {
+        // Parent runs `formatStateUsing` first — it wins over auto-render so a
+        // user-supplied formatter can opt out of HTML even when a richtext
+        // renderer is registered.
+        const meta = super.toMeta(ctx);
+        if (meta._formatted !== undefined || meta.format !== undefined)
+            return meta;
+        const html = tryRenderRichText(meta.value);
+        if (html === null)
+            return meta;
+        meta._formatted = html;
+        meta.richtext = true;
+        return meta;
+    }
+}
+//# sourceMappingURL=TextEntry.js.map

package/dist/entries/TextEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextEntry.js","sourceRoot":"","sources":["../../src/entries/TextEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AASlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,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;IAEkB,YAAY,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAElD,MAAM,CAAC,GAAmB;QACjC,uEAAuE;QACvE,mEAAmE;QACnE,0BAA0B;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAkB,CAAA;QAC/C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAE3E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC1C,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAE9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAK,IAAI,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/entries/index.d.ts

@@ -0,0 +1,2 @@
+export { registerEntryComponents, getEntryComponent, type EntryComponent, type EntryComponentProps, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entries/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAA"}

package/dist/entries/index.js

@@ -0,0 +1,8 @@
+// Entry runtime registry — opt-in component registration for
+// `ComponentEntry` elements. Imported by panel `bootstrap/providers.ts`,
+// not by `AdminPanel.ts` (which is re-imported on the client via the Vite
+// plugin's `_components.ts` manifest — same constraint as
+// `@pilotiq/pilotiq/uploads` / `@pilotiq/pilotiq/widgets`, per
+// `feedback_pilotiq_panel_module_client_safe.md`).
+export { registerEntryComponents, getEntryComponent, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/entries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entries/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,yEAAyE;AACzE,0EAA0E;AAC1E,0DAA0D;AAC1D,+DAA+D;AAC/D,mDAAmD;AACnD,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,eAAe,CAAA"}

package/dist/entries/registry.d.ts

@@ -0,0 +1,41 @@
+import type { ComponentType } from 'react';
+/**
+ * Render-time component registry for `ComponentEntry` infolist entries.
+ * Mirrors the widget registry pattern (`@pilotiq/pilotiq/widgets`): users
+ * register components by name in their app's `bootstrap/providers.ts`,
+ * the `ComponentEntry` ships the registered name on the wire
+ * (`{ component: 'CoordinatesMap' }`), and the renderer looks up the
+ * actual component at render through `getEntryComponent()`.
+ *
+ * Why a runtime registry rather than the build-time `_components.ts`
+ * manifest the icon system uses: entries live inside `Resource.detail()`,
+ * not as Resource/Global/Page top-level statics, so the existing
+ * manifest walker (`cfg.resources / globals / pages → _all[c.name] = c`)
+ * doesn't see them. A runtime register-by-name keeps the wire compact
+ * and mirrors the `registerWidgetComponents / registerCodeEditor` precedent.
+ *
+ * @example
+ *   // bootstrap/providers.ts
+ *   import { registerEntryComponents } from '@pilotiq/pilotiq/entries'
+ *   import { CoordinatesMap } from '#entries/CoordinatesMap.js'
+ *   registerEntryComponents({ CoordinatesMap })
+ *
+ *   // Resource.detail()
+ *   ComponentEntry.make('location').component('CoordinatesMap')
+ */
+/**
+ * Props handed to every registered entry component. v1 ships only the
+ * resolved state value — pack additional record fields into the value
+ * via the entry's `.state(r => composedObject)` accessor when the
+ * component needs more than one field. Mirrors the wire-economy posture
+ * of `View` widgets (which receive `{ data }` only).
+ */
+export type EntryComponentProps = {
+    value: unknown;
+};
+export type EntryComponent = ComponentType<EntryComponentProps>;
+export declare function registerEntryComponents(map: Record<string, EntryComponent>): void;
+export declare function getEntryComponent(name: string): EntryComponent | undefined;
+/** Test-only: clear the registry. Not exported from the public entry. */
+export declare function _resetEntryRegistryForTests(): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/entries/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AACpD,MAAM,MAAM,cAAc,GAAQ,aAAa,CAAC,mBAAmB,CAAC,CAAA;AAIpE,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAKjF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/entries/registry.js

@@ -0,0 +1,17 @@
+const registry = {};
+export function registerEntryComponents(map) {
+    for (const key of Object.keys(map)) {
+        const c = map[key];
+        if (c)
+            registry[key] = c;
+    }
+}
+export function getEntryComponent(name) {
+    return registry[name];
+}
+/** Test-only: clear the registry. Not exported from the public entry. */
+export function _resetEntryRegistryForTests() {
+    for (const key of Object.keys(registry))
+        delete registry[key];
+}
+//# sourceMappingURL=registry.js.map

package/dist/entries/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/entries/registry.ts"],"names":[],"mappings":"AAqCA,MAAM,QAAQ,GAAmC,EAAE,CAAA;AAEnD,MAAM,UAAU,uBAAuB,CAAC,GAAmC;IACzE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAClB,IAAI,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,2BAA2B;IACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC/D,CAAC"}