@pilotiq/pilotiq 0.24.1 → 0.24.3

package/src/entries/RepeatableEntry.test.ts

@@ -1,239 +0,0 @@
-import { describe, it, beforeEach } from 'node:test'
-import assert from 'node:assert/strict'
-
-import { resolveSchema, _resetResolverRegistry } from '../schema/resolveSchema.js'
-import { RepeatableEntry } from './RepeatableEntry.js'
-import { TextEntry }       from './TextEntry.js'
-import { BadgeEntry }      from './BadgeEntry.js'
-import type { ElementMeta } from '../schema/Element.js'
-import type { EntryMeta }   from './Entry.js'
-
-beforeEach(() => _resetResolverRegistry())
-
-describe('RepeatableEntry', () => {
-  it('serializes the discriminator + chrome', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('items').schema([TextEntry.make('label')])],
-      { record: { items: [{ label: 'A' }, { label: 'B' }] } },
-    )
-    const m = out[0] as EntryMeta
-    assert.equal(m.entryType, 'repeatable')
-    assert.equal(m.label,     'Items')
-  })
-
-  it('resolves one row per array element with row-scoped record', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('items').schema([
-        TextEntry.make('label'),
-        BadgeEntry.make('status'),
-      ])],
-      { record: { items: [
-        { label: 'Item A', status: 'draft' },
-        { label: 'Item B', status: 'published' },
-      ] } },
-    )
-    const m = out[0] as ElementMeta & { rows: Array<{ id: string; children: ElementMeta[] }> }
-    assert.equal(m.rows.length, 2)
-    assert.equal(m.rows[0]!.children.length, 2)
-    // Row 0: TextEntry resolved against { label: 'Item A', status: 'draft' }
-    assert.equal((m.rows[0]!.children[0] as ElementMeta)['value'], 'Item A')
-    assert.equal((m.rows[0]!.children[1] as ElementMeta)['value'], 'draft')
-    // Row 1
-    assert.equal((m.rows[1]!.children[0] as ElementMeta)['value'], 'Item B')
-    assert.equal((m.rows[1]!.children[1] as ElementMeta)['value'], 'published')
-  })
-
-  it('emits empty rows when the record value is missing / null / non-array', async () => {
-    const cases: Array<unknown> = [undefined, null, 'not-an-array', 42, {}]
-    for (const value of cases) {
-      const out = await resolveSchema(
-        [RepeatableEntry.make('items').schema([TextEntry.make('label')])],
-        { record: { items: value } },
-      )
-      const m = out[0] as ElementMeta & { rows: unknown[] }
-      assert.deepEqual(m.rows, [], `expected empty rows for ${JSON.stringify(value)}`)
-    }
-  })
-
-  it('emits empty rows when the array is empty', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('items').schema([TextEntry.make('label')])],
-      { record: { items: [] } },
-    )
-    const m = out[0] as ElementMeta & { rows: unknown[] }
-    assert.deepEqual(m.rows, [])
-  })
-
-  it('reads stable ids off id / __id / uuid; falls back to fieldName-index', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('items').schema([TextEntry.make('label')])],
-      { record: { items: [
-        { id: 7,         label: 'A' },
-        { __id: 'x-9',   label: 'B' },
-        { uuid: 'u-3',   label: 'C' },
-        { label: 'D' }, // no id-ish field
-      ] } },
-    )
-    const m = out[0] as ElementMeta & { rows: Array<{ id: string }> }
-    assert.equal(m.rows[0]!.id, '7')
-    assert.equal(m.rows[1]!.id, 'x-9')
-    assert.equal(m.rows[2]!.id, 'u-3')
-    assert.equal(m.rows[3]!.id, 'items-3')
-  })
-
-  it('emits columns / grid / table chrome only when configured', async () => {
-    const bare = await resolveSchema(
-      [RepeatableEntry.make('items').schema([TextEntry.make('label')])],
-      { record: { items: [{ label: 'A' }] } },
-    )
-    const m0 = bare[0] as ElementMeta & {
-      columns?: number; grid?: number; table?: unknown; contained?: boolean
-    }
-    assert.equal(m0.columns,   undefined)
-    assert.equal(m0.grid,      undefined)
-    assert.equal(m0.table,     undefined)
-    assert.equal(m0.contained, undefined)
-
-    const styled = await resolveSchema(
-      [
-        RepeatableEntry.make('items')
-          .schema([TextEntry.make('label')])
-          .columns(2)
-          .grid(3)
-          .contained(false),
-      ],
-      { record: { items: [{ label: 'A' }] } },
-    )
-    const m1 = styled[0] as ElementMeta & {
-      columns?: number; grid?: number; contained?: boolean
-    }
-    assert.equal(m1.columns,   2)
-    assert.equal(m1.grid,      3)
-    assert.equal(m1.contained, false)
-  })
-
-  it('grid(n<2) clears the grid mode', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('items').schema([TextEntry.make('label')]).grid(3).grid(1)],
-      { record: { items: [{ label: 'A' }] } },
-    )
-    const m = out[0] as ElementMeta & { grid?: number }
-    assert.equal(m.grid, undefined)
-  })
-
-  it('table(...) emits the column descriptors', async () => {
-    const out = await resolveSchema(
-      [
-        RepeatableEntry.make('items')
-          .schema([TextEntry.make('label'), TextEntry.make('qty').numeric()])
-          .table([
-            { label: 'Item' },
-            { label: 'Qty', alignment: 'right', width: '6rem' },
-          ]),
-      ],
-      { record: { items: [{ label: 'A', qty: 1 }] } },
-    )
-    const m = out[0] as ElementMeta & {
-      table?: { columns: Array<{ label: string; alignment?: string; width?: string }> }
-    }
-    assert.equal(m.table?.columns.length, 2)
-    assert.equal(m.table?.columns[0]?.label, 'Item')
-    assert.equal(m.table?.columns[1]?.alignment, 'right')
-    assert.equal(m.table?.columns[1]?.width,     '6rem')
-  })
-
-  it('table([]) clears table mode', async () => {
-    const out = await resolveSchema(
-      [
-        RepeatableEntry.make('items')
-          .schema([TextEntry.make('label')])
-          .table([{ label: 'X' }])
-          .table([]),
-      ],
-      { record: { items: [{ label: 'A' }] } },
-    )
-    const m = out[0] as ElementMeta & { table?: unknown }
-    assert.equal(m.table, undefined)
-  })
-
-  it('inner formatStateUsing runs per row against the row record', async () => {
-    const out = await resolveSchema(
-      [
-        RepeatableEntry.make('items').schema([
-          TextEntry.make('amount').formatStateUsing(v => `$${Number(v).toFixed(2)}`),
-        ]),
-      ],
-      { record: { items: [
-        { amount: 10 },
-        { amount: 12.5 },
-      ] } },
-    )
-    const m = out[0] as ElementMeta & { rows: Array<{ children: ElementMeta[] }> }
-    assert.equal((m.rows[0]!.children[0] as ElementMeta)['_formatted'], '$10.00')
-    assert.equal((m.rows[1]!.children[0] as ElementMeta)['_formatted'], '$12.50')
-  })
-
-  it('primitive array elements stash under `_value` so an inner _value entry can target them', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('tags').schema([TextEntry.make('_value').label('Tag')])],
-      { record: { tags: ['featured', 'sale', 'new'] } },
-    )
-    const m = out[0] as ElementMeta & { rows: Array<{ children: ElementMeta[] }> }
-    assert.equal(m.rows.length, 3)
-    assert.equal((m.rows[0]!.children[0] as ElementMeta)['value'], 'featured')
-    assert.equal((m.rows[2]!.children[0] as ElementMeta)['value'], 'new')
-  })
-
-  it('inherits Entry chrome — label / inlineLabel / helperText / default', async () => {
-    const out = await resolveSchema(
-      [
-        RepeatableEntry.make('items')
-          .label('Line items')
-          .inlineLabel()
-          .helperText('From the original PO')
-          .default('No items')
-          .schema([TextEntry.make('label')]),
-      ],
-      { record: { items: [{ label: 'A' }] } },
-    )
-    const m = out[0] as ElementMeta
-    assert.equal(m['label'],       'Line items')
-    assert.equal(m['inlineLabel'], true)
-    assert.equal(m['helperText'],  'From the original PO')
-    assert.equal(m['default'],     'No items')
-  })
-
-  it('accepts a custom state() resolver for the array source', async () => {
-    const out = await resolveSchema(
-      [
-        RepeatableEntry.make('lines')
-          .state((r: Record<string, unknown>) => r['nested'] as unknown[])
-          .schema([TextEntry.make('label')]),
-      ],
-      // No top-level `lines` key — the resolver pulls from `nested` instead.
-      // Note: state() only feeds `EntryMeta.value`. The row source is read
-      // directly off `record[name]`, so this scenario is a no-rows case
-      // unless the consumer also names the field after the source key.
-      { record: { lines: [{ label: 'A' }], nested: [{ label: 'X' }] } },
-    )
-    const m = out[0] as ElementMeta & {
-      rows: Array<{ children: ElementMeta[] }>
-      value?: unknown
-    }
-    // Rows still resolve from `record.lines` (RepeatableEntry's row source
-    // is name-bound — `state()` doesn't redirect the row read).
-    assert.equal(m.rows.length, 1)
-    assert.equal((m.rows[0]!.children[0] as ElementMeta)['value'], 'A')
-    // But the `value` field reflects the state() override.
-    assert.deepEqual(m.value, [{ label: 'X' }])
-  })
-
-  it('empty inner schema short-circuits to empty rows', async () => {
-    const out = await resolveSchema(
-      [RepeatableEntry.make('items')],
-      { record: { items: [{ label: 'A' }] } },
-    )
-    const m = out[0] as ElementMeta & { rows: unknown[] }
-    assert.deepEqual(m.rows, [])
-  })
-})

package/src/entries/RepeatableEntry.ts

@@ -1,173 +0,0 @@
-import { Element, type ElementMeta } from '../schema/Element.js'
-import { Entry, type EntryMeta } from './Entry.js'
-import type { RenderContext } from '../schema/resolveSchema.js'
-
-/**
- * Header descriptor for `RepeatableEntry.table([...])` mode. One entry per
- * inner schema element, in declaration order — column[i] is the header for
- * `schema[i]`. Mirrors `RepeaterTableColumn` so the two surfaces read the
- * same; kept as a separate type so future divergences (e.g. `width()` on a
- * read-only column) can land here without touching the form-side field.
- *
- * `alignment` aligns header text + cell contents (cells use `text-*`).
- * `width` is a raw CSS width string passed to `<col style="width: …">`.
- */
-export interface RepeatableEntryTableColumn {
-  label:       string
-  alignment?:  'left' | 'center' | 'right'
-  width?:      string
-}
-
-/**
- * One resolved row of a `RepeatableEntry`. `id` is a stable per-row key
- * (read from the row's `id`-ish field if present, otherwise the row index)
- * so React reconciliation behaves on reorder. `children` is the resolved
- * inner schema, scoped to this row's record.
- */
-export interface RepeatableEntryRowMeta {
-  id:       string
-  children: ElementMeta[]
-}
-
-export interface RepeatableEntryMeta extends EntryMeta {
-  rows:        RepeatableEntryRowMeta[]
-  /** Column count for the inner schema *inside* one card (mirrors
-   *  `Repeater.columns`). Ignored under `table` mode. */
-  columns?:    number
-  /** Number of cards across (≥ 2). Ignored under `table` mode. */
-  grid?:       number
-  /** Compact `<table>` layout — supplied headers map 1:1 to inner schema
-   *  fields by declaration order. Mutually exclusive with `columns / grid`
-   *  (the renderer picks the most specific layout — `table > grid > stack`). */
-  table?:      { columns: RepeatableEntryTableColumn[] }
-  /** When `false`, strips the outer card chrome — useful when each row is
-   *  already self-contained (e.g. a single `Section.aside()` per row). */
-  contained?:  boolean
-}
-
-/**
- * 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 {
-  protected override _children: Element[] = []
-
-  private _columns?:      number
-  private _grid?:         number
-  private _tableColumns?: RepeatableEntryTableColumn[]
-  private _contained     = true
-
-  private constructor(name: string) {
-    super(name)
-  }
-
-  static make(name: string): RepeatableEntry {
-    return new RepeatableEntry(name)
-  }
-
-  protected override getEntryType(): string { return 'repeatable' }
-
-  /** Inner schema rendered per row. */
-  schema(elements: Element[]): this {
-    this._children = elements
-    return this
-  }
-
-  /** Grid column count for the inner schema *inside* one card (mirrors
-   *  `Repeater.columns`). Ignored under table mode. */
-  columns(n: number): this { 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: number): this {
-    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: RepeatableEntryTableColumn[]): this {
-    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 { this._contained = v; return this }
-
-  // ─── Read-only access for the resolver ──────────────────
-
-  override getChildren(): Element[] | undefined {
-    return this._children.length > 0 ? this._children : undefined
-  }
-
-  /** Direct access to the inner schema — used by `resolveRepeatableRows`. */
-  getInnerSchema(): Element[] { return this._children }
-
-  getColumns():      number | undefined                    { return this._columns }
-  getGrid():         number | undefined                    { return this._grid }
-  getTableColumns(): RepeatableEntryTableColumn[] | undefined { return this._tableColumns }
-  isContained():     boolean                               { return this._contained }
-
-  override async toMeta(ctx?: RenderContext): Promise<RepeatableEntryMeta> {
-    const meta = await Promise.resolve(super.toMeta(ctx)) as RepeatableEntryMeta
-    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: unknown, fieldName: string, index: number): string {
-  if (row && typeof row === 'object' && !Array.isArray(row)) {
-    const r = row as Record<string, unknown>
-    const candidate = r['id'] ?? r['__id'] ?? r['uuid']
-    if (typeof candidate === 'string' || typeof candidate === 'number') {
-      return String(candidate)
-    }
-  }
-  return `${fieldName}-${index}`
-}