@pilotiq/pilotiq 0.23.1 → 0.24.2

package/src/columns/IconColumn.test.ts

@@ -1,54 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-
-import { IconColumn } from './IconColumn.js'
-
-describe('IconColumn', () => {
-  it('emits columnType:icon with the value→{icon,color} map', () => {
-    const meta = IconColumn.make('isAdmin')
-      .options({
-        true:  { icon: 'shield-check', color: 'success' },
-        false: { icon: 'user',         color: 'muted'   },
-      })
-      .toMeta()
-    assert.equal(meta.columnType, 'icon')
-    assert.deepEqual(meta.iconOptions, {
-      true:  { icon: 'shield-check', color: 'success' },
-      false: { icon: 'user',         color: 'muted'   },
-    })
-  })
-
-  it('omits iconOptions when no map is set', () => {
-    const meta = IconColumn.make('flag').toMeta()
-    assert.equal(meta.columnType,  'icon')
-    assert.equal(meta.iconOptions, undefined)
-  })
-
-  it('color-less options round-trip', () => {
-    const meta = IconColumn.make('icon')
-      .options({ a: { icon: 'check' } })
-      .toMeta()
-    assert.equal(meta.iconOptions?.['a']?.icon, 'check')
-    assert.equal(meta.iconOptions?.['a']?.color, undefined)
-  })
-
-  it('successive .options() calls merge', () => {
-    const meta = IconColumn.make('priority')
-      .options({ high: { icon: 'arrow-up'   } })
-      .options({ low:  { icon: 'arrow-down' } })
-      .toMeta()
-    assert.deepEqual(meta.iconOptions, {
-      high: { icon: 'arrow-up'   },
-      low:  { icon: 'arrow-down' },
-    })
-  })
-
-  it('inherits the base alignment / tooltip chain', () => {
-    const meta = IconColumn.make('status')
-      .alignment('center')
-      .tooltip('Status flag')
-      .toMeta()
-    assert.equal(meta.alignment, 'center')
-    assert.equal(meta.tooltip,   'Status flag')
-  })
-})

package/src/columns/IconColumn.ts

@@ -1,37 +0,0 @@
-import { Column, type ColumnMeta, type ColumnColor } from '../Column.js'
-
-/** Per-value rendering option for an IconColumn cell. */
-export interface IconOption {
-  icon: string
-  color?: ColumnColor | string
-}
-
-/**
- * Renders the cell as a small icon. Use a value-to-icon map to vary the
- * icon by raw cell value (e.g. status string, boolean, numeric flag).
- *
- *   IconColumn.make('isAdmin').options({
- *     true:  { icon: 'shield-check', color: 'success' },
- *     false: { icon: 'user',         color: 'muted'   },
- *   })
- */
-export class IconColumn extends Column {
-  protected _options: Record<string, IconOption> = {}
-
-  static override make(name: string): IconColumn {
-    const c = new IconColumn(name)
-    c.setColumnType('icon')
-    return c
-  }
-
-  options(map: Record<string, IconOption>): this {
-    this._options = { ...this._options, ...map }
-    return this
-  }
-
-  protected override serializeExtras(meta: ColumnMeta): void {
-    if (Object.keys(this._options).length > 0) {
-      meta.iconOptions = this._options
-    }
-  }
-}

package/src/columns/ImageColumn.test.ts

@@ -1,41 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-
-import { ImageColumn } from './ImageColumn.js'
-
-describe('ImageColumn', () => {
-  it('emits columnType:image with size and shape', () => {
-    const meta = ImageColumn.make('avatar').size(48).circular().toMeta()
-    assert.equal(meta.columnType, 'image')
-    assert.equal(meta.imageSize,  48)
-    assert.equal(meta.imageShape, 'circle')
-  })
-
-  it('defaults to 32px square', () => {
-    const meta = ImageColumn.make('avatar').toMeta()
-    assert.equal(meta.imageSize,  32)
-    assert.equal(meta.imageShape, 'square')
-  })
-
-  it('square() flips back from circular()', () => {
-    const meta = ImageColumn.make('avatar').circular().square().toMeta()
-    assert.equal(meta.imageShape, 'square')
-  })
-
-  it('inherits the alignment / tooltip / width chain', () => {
-    const meta = ImageColumn.make('avatar')
-      .alignment('center')
-      .tooltip('Profile picture')
-      .width('80px')
-      .toMeta()
-    assert.equal(meta.alignment, 'center')
-    assert.equal(meta.tooltip,   'Profile picture')
-    assert.equal(meta.width,     '80px')
-  })
-
-  it('size(64).circular() round-trips', () => {
-    const meta = ImageColumn.make('avatar').size(64).circular().toMeta()
-    assert.equal(meta.imageSize,  64)
-    assert.equal(meta.imageShape, 'circle')
-  })
-})

package/src/columns/ImageColumn.ts

@@ -1,28 +0,0 @@
-import { Column, type ColumnMeta } from '../Column.js'
-
-/**
- * Renders the cell value as an image (avatar / thumbnail). The cell
- * value should be a URL string. Defaults to a 32px square; use
- * `.size(n)` and `.circular()` / `.square()` to tweak.
- */
-export class ImageColumn extends Column {
-  protected _size = 32
-  protected _shape: 'square' | 'circle' = 'square'
-
-  static override make(name: string): ImageColumn {
-    const c = new ImageColumn(name)
-    c.setColumnType('image')
-    return c
-  }
-
-  /** Width = height in px. Default 32. */
-  size(px: number): this { this._size = px; return this }
-
-  circular(): this { this._shape = 'circle'; return this }
-  square(): this   { this._shape = 'square'; return this }
-
-  protected override serializeExtras(meta: ColumnMeta): void {
-    meta.imageSize  = this._size
-    meta.imageShape = this._shape
-  }
-}

package/src/columns/SelectColumn.ts

@@ -1,98 +0,0 @@
-import { Column, type ColumnMeta, type ColumnSelectOption } from '../Column.js'
-
-/** Accepted shapes for `SelectColumn.options(...)`. The map form
- * (`{ draft: 'Draft' }`) is convenience sugar for the array form. */
-export type SelectColumnOptionsInput =
-  | Record<string, string>
-  | Array<ColumnSelectOption>
-
-/** Per-row resolver — runs once per visible row at table-data time and
- * stamps the resolved options on the row under `_cellSelectOptions[col]`
- * so the inline `<select>` shows row-specific values (e.g. assignee
- * candidates filtered by record team). May return a Promise. */
-export type SelectColumnOptionsResolver =
-  (record: unknown) => SelectColumnOptionsInput | Promise<SelectColumnOptionsInput>
-
-/** Normalize either input shape to the canonical array form. Shared
- * between the static `.options()` setter and the per-row resolver path
- * inside `dispatchTable.ts`. */
-export function normalizeSelectOptions(opts: SelectColumnOptionsInput): ColumnSelectOption[] {
-  return Array.isArray(opts)
-    ? opts.map(o => ({ value: o.value, label: o.label }))
-    : Object.entries(opts).map(([value, label]) => ({ value, label }))
-}
-
-/**
- * Inline-edit select. Renders a `<select>` in the cell; each change
- * fires an immediate PATCH.
- *
- *   SelectColumn.make('status')
- *     .options({ draft: 'Draft', published: 'Published', archived: 'Archived' })
- *     .nullable()
- *
- * Pair with `Column.disabled(record => …)` for per-row gating
- * (e.g. forbid changing status once archived).
- *
- * Per-row options resolve via `.options(record => …)`:
- *
- *   SelectColumn.make('assigneeId')
- *     .options(async (row) => {
- *       const team = await Team.find(row.teamId)
- *       return team.members.map(m => ({ value: String(m.id), label: m.name }))
- *     })
- *
- * The resolver runs once per visible row in `loadTableRecords` and
- * stamps the resolved option list on `row._cellSelectOptions[col.name]`.
- * Failed resolvers stay silent — the cell falls back to whatever was
- * passed as a static `.options(...)` (or an empty list) so a single bad
- * row doesn't break the whole table.
- */
-export class SelectColumn extends Column {
-  protected _options: ColumnSelectOption[] = []
-  protected _optionsResolver?: SelectColumnOptionsResolver
-  protected _nullable = false
-  protected _selectablePlaceholder = true
-
-  static override make(name: string): SelectColumn {
-    const c = new SelectColumn(name)
-    c.setColumnType('select')
-    return c
-  }
-
-  /** Static options OR a per-row resolver. Function form receives the
-   * raw record and may return a Promise — runs once per row in
-   * `loadTableRecords`. Re-calling replaces the previous set; mixing
-   * static + resolver replaces both because the renderer reads the
-   * per-row stamp first and falls back to the static list. */
-  options(opts: SelectColumnOptionsInput | SelectColumnOptionsResolver): this {
-    if (typeof opts === 'function') {
-      this._optionsResolver = opts
-      this._options = []
-    } else {
-      this._options = normalizeSelectOptions(opts)
-      delete this._optionsResolver
-    }
-    return this
-  }
-
-  /** Add an explicit "—" option that maps to `null`. Without this a
-   * required column has no way to clear the value through the inline
-   * control. */
-  nullable(v = true): this { this._nullable = v; return this }
-
-  /** Hide the placeholder option (the leading "Select…" entry) once a
-   * value is set. Default: keep showing it so users can clear or
-   * reselect. Filament parity. */
-  selectablePlaceholder(v = true): this { this._selectablePlaceholder = v; return this }
-
-  getOptions(): ReadonlyArray<ColumnSelectOption> { return this._options }
-  getOptionsResolver(): SelectColumnOptionsResolver | undefined { return this._optionsResolver }
-
-  protected override serializeExtras(meta: ColumnMeta): void {
-    // The static list still serializes when set so the renderer has a
-    // fallback if the per-row resolver throws or stamps no options.
-    if (this._options.length > 0) meta.selectOptions = this._options.slice()
-    if (this._nullable) meta.selectNullable = true
-    if (!this._selectablePlaceholder) meta.selectablePlaceholder = false
-  }
-}

package/src/columns/TextColumn.test.ts

@@ -1,190 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-
-import { TextColumn } from './TextColumn.js'
-import { Column } from '../Column.js'
-
-describe('TextColumn', () => {
-  it('toMeta omits columnType (text is the default)', () => {
-    const meta = TextColumn.make('title').toMeta()
-    assert.equal(meta.type, 'column')
-    assert.equal(meta.name, 'title')
-    // 'text' is the default columnType — kept off the wire to keep meta tidy.
-    assert.equal(meta.columnType, undefined)
-  })
-
-  it('inherits the full base-column chain', () => {
-    const meta = TextColumn.make('a')
-      .label('A')
-      .sortable()
-      .searchable()
-      .alignment('end')
-      .width('120px')
-      .default('—')
-      .tooltip('Help')
-      .wrap()
-      .lineClamp(2)
-      .weight('semibold')
-      .color('muted')
-      .toMeta()
-    assert.equal(meta.label,     'A')
-    assert.equal(meta.sortable,  true)
-    assert.equal(meta.alignment, 'end')
-    assert.equal(meta.width,     '120px')
-    assert.equal(meta.default,   '—')
-    assert.equal(meta.tooltip,   'Help')
-    assert.equal(meta.wrap,      true)
-    assert.equal(meta.lineClamp, 2)
-    assert.equal(meta.weight,    'semibold')
-    assert.equal(meta.color,     'muted')
-  })
-
-  describe('built-in formatters', () => {
-    it('dateTime() emits format spec', () => {
-      const meta = TextColumn.make('publishedAt').dateTime().toMeta()
-      assert.deepEqual(meta.format, { kind: 'dateTime' })
-    })
-
-    it('dateTime("PPpp") carries the pattern', () => {
-      const meta = TextColumn.make('publishedAt').dateTime('PPpp').toMeta()
-      assert.deepEqual(meta.format, { kind: 'dateTime', pattern: 'PPpp' })
-    })
-
-    it('since() emits kind:since', () => {
-      const meta = TextColumn.make('createdAt').since().toMeta()
-      assert.deepEqual(meta.format, { kind: 'since' })
-    })
-
-    it('money(currency) emits kind:money + currency', () => {
-      const meta = TextColumn.make('price').money('USD').toMeta()
-      assert.deepEqual(meta.format, { kind: 'money', currency: 'USD' })
-    })
-
-    it('money(currency, locale) carries the locale', () => {
-      const meta = TextColumn.make('price').money('EUR', 'de-DE').toMeta()
-      assert.deepEqual(meta.format, { kind: 'money', currency: 'EUR', locale: 'de-DE' })
-    })
-
-    it('numeric() with no opts emits bare kind:numeric', () => {
-      const meta = TextColumn.make('count').numeric().toMeta()
-      assert.deepEqual(meta.format, { kind: 'numeric' })
-    })
-
-    it('numeric({ decimals }) carries decimals', () => {
-      const meta = TextColumn.make('count').numeric({ decimals: 2 }).toMeta()
-      assert.deepEqual(meta.format, { kind: 'numeric', decimals: 2 })
-    })
-
-    it('limit(n) emits kind:limit + chars', () => {
-      const meta = TextColumn.make('body').limit(40).toMeta()
-      assert.deepEqual(meta.format, { kind: 'limit', chars: 40 })
-    })
-
-    it('words(n) emits kind:words + words', () => {
-      const meta = TextColumn.make('body').words(20).toMeta()
-      assert.deepEqual(meta.format, { kind: 'words', words: 20 })
-    })
-
-    it('characters(n) is a Filament-parity alias for limit(n)', () => {
-      const a = TextColumn.make('body').characters(40).toMeta()
-      const b = TextColumn.make('body').limit(40).toMeta()
-      assert.deepEqual(a.format, b.format)
-      assert.deepEqual(a.format, { kind: 'limit', chars: 40 })
-    })
-
-    it('formatters overwrite each other — last call wins', () => {
-      const meta = TextColumn.make('body').words(10).limit(40).toMeta()
-      assert.deepEqual(meta.format, { kind: 'limit', chars: 40 })
-    })
-  })
-
-  describe('rich-display chrome', () => {
-    it('listWithLineBreaks() emits flag only when called', () => {
-      const off = TextColumn.make('tags').toMeta()
-      const on  = TextColumn.make('tags').listWithLineBreaks().toMeta()
-      assert.equal(off['listWithLineBreaks'], undefined)
-      assert.equal(on['listWithLineBreaks'],  true)
-    })
-
-    it('bulleted() emits flag only when called', () => {
-      const off = TextColumn.make('tags').toMeta()
-      const on  = TextColumn.make('tags').bulleted().toMeta()
-      assert.equal(off['bulleted'], undefined)
-      assert.equal(on['bulleted'],  true)
-    })
-
-    it('copyMessage() defaults to "Copied!"', () => {
-      const meta = TextColumn.make('email').copyMessage().toMeta()
-      assert.equal(meta['copyMessage'], 'Copied!')
-    })
-
-    it('copyMessage(s) honors the custom toast string', () => {
-      const meta = TextColumn.make('email').copyMessage('Email copied').toMeta()
-      assert.equal(meta['copyMessage'], 'Email copied')
-    })
-
-    it('chrome flags compose with each other and with format()', () => {
-      const meta = TextColumn.make('bio')
-        .words(20)
-        .listWithLineBreaks()
-        .bulleted()
-        .copyMessage('Done')
-        .toMeta()
-      assert.deepEqual(meta.format,            { kind: 'words', words: 20 })
-      assert.equal(meta['listWithLineBreaks'], true)
-      assert.equal(meta['bulleted'],           true)
-      assert.equal(meta['copyMessage'],        'Done')
-    })
-  })
-
-  describe('markdown / html', () => {
-    it('markdown() stamps richText: "markdown"', () => {
-      const meta = TextColumn.make('body').markdown().toMeta()
-      assert.equal(meta['richText'], 'markdown')
-    })
-
-    it('html() stamps richText: "html"', () => {
-      const meta = TextColumn.make('body').html().toMeta()
-      assert.equal(meta['richText'], 'html')
-    })
-
-    it('html() and markdown() are mutually exclusive — last call wins', () => {
-      const a = TextColumn.make('body').markdown().html().toMeta()
-      const b = TextColumn.make('body').html().markdown().toMeta()
-      assert.equal(a['richText'], 'html')
-      assert.equal(b['richText'], 'markdown')
-    })
-
-    it('markdown(false) clears the flag', () => {
-      const col = TextColumn.make('body').markdown()
-      assert.equal(col.isRichText(), true)
-      col.markdown(false)
-      assert.equal(col.isRichText(), false)
-    })
-
-    it('allowRaw() sets sanitize to false', () => {
-      const col = TextColumn.make('body').markdown().allowRaw()
-      assert.equal(col.getSanitize(), false)
-    })
-
-    it('sanitize(opts) carries the widened config through the accessor', () => {
-      const col = TextColumn.make('body').html().sanitize({ allowedTags: ['span'] })
-      assert.deepEqual(col.getSanitize(), { allowedTags: ['span'] })
-    })
-  })
-
-  it('formatStateUsing stamps hasFormatter:true on the meta', () => {
-    const col = TextColumn.make('priority').formatStateUsing((v) => `★ ${v}`)
-    const meta = col.toMeta()
-    assert.equal(meta.hasFormatter, true)
-    assert.equal(col.hasFormatter(), true)
-  })
-
-  it('Column.make and TextColumn.make produce equivalent meta', () => {
-    // Plan §44: `Column.make()` is an alias for `TextColumn.make()`. The
-    // wire shape must stay identical so existing code keeps working.
-    const a = Column.make('title').label('Title').sortable().toMeta()
-    const b = TextColumn.make('title').label('Title').sortable().toMeta()
-    assert.deepEqual(a, b)
-  })
-})

package/src/columns/TextColumn.ts

@@ -1,20 +0,0 @@
-import { Column } from '../Column.js'
-
-/**
- * The standard text column. Renders cell values as plain text and exposes
- * the full chain of built-in formatters (`dateTime / since / money /
- * numeric / limit`) plus typography setters (`weight / color`) inherited
- * from `Column`.
- *
- * `TextColumn.make('name')` and `Column.make('name')` are equivalent —
- * the base `Column` defaults `columnType = 'text'`, so the bare factory
- * keeps working unchanged. `TextColumn.make` exists for symmetry with
- * the other column subclasses (`BadgeColumn / IconColumn / BooleanColumn /
- * ImageColumn`) so callers reading a list page can spot the column kind
- * at a glance.
- */
-export class TextColumn extends Column {
-  static override make(name: string): TextColumn {
-    return new TextColumn(name)
-  }
-}

package/src/columns/TextInputColumn.ts

@@ -1,68 +0,0 @@
-import { Column, type ColumnMeta } from '../Column.js'
-
-/** HTML `<input type=…>` discriminator for `TextInputColumn`. Mirrors
- * the subset of types we coerce server-side; richer types (date, color,
- * file) belong to dedicated columns or stay form-only. */
-export type TextInputColumnType = 'text' | 'number' | 'email' | 'url' | 'tel'
-
-/**
- * Inline-edit text input. Renders an `<input>` directly in the cell;
- * commits via debounced PATCH on typing + immediate PATCH on blur.
- *
- *   TextInputColumn.make('title')
- *     .placeholder('Untitled')
- *     .validate([required(), minLength(3)])
- *     .debounce(750)
- *
- * Numeric variant:
- *
- *   TextInputColumn.make('price').type('number').step(0.01).min(0)
- */
-export class TextInputColumn extends Column {
-  protected _inputType: TextInputColumnType = 'text'
-  protected _inputPlaceholder?: string
-  protected _step?: number
-  protected _min?:  number
-  protected _max?:  number
-  protected _debounceMs?: number
-
-  static override make(name: string): TextInputColumn {
-    const c = new TextInputColumn(name)
-    c.setColumnType('textInput')
-    return c
-  }
-
-  /** Map to `<input type=…>`. Default `'text'`. `'number'` parses to
-   * a JS number server-side; the rest stay strings. */
-  type(t: TextInputColumnType): this { this._inputType = t; return this }
-
-  /** Input placeholder (the text shown when the input is empty). NOT
-   * the same as `Column.placeholder()` / `default()`, which is the
-   * empty-cell fallback for read-only formatters. */
-  placeholder(p: string): this { this._inputPlaceholder = p; return this }
-
-  /** Numeric `<input step=…>`. */
-  step(n: number): this { this._step = n; return this }
-
-  /** Numeric `<input min=…>`. */
-  min(n: number): this { this._min = n; return this }
-
-  /** Numeric `<input max=…>`. */
-  max(n: number): this { this._max = n; return this }
-
-  /** Override the renderer's default debounce. Time between the last
-   * keystroke and the PATCH fire (ms). Blur always commits immediately
-   * regardless. */
-  debounce(ms: number): this { this._debounceMs = ms; return this }
-
-  getInputType(): TextInputColumnType { return this._inputType }
-
-  protected override serializeExtras(meta: ColumnMeta): void {
-    if (this._inputType !== 'text') meta.inputType = this._inputType
-    if (this._inputPlaceholder !== undefined) meta.inputPlaceholder = this._inputPlaceholder
-    if (this._step !== undefined) meta.inputStep = this._step
-    if (this._min  !== undefined) meta.inputMin  = this._min
-    if (this._max  !== undefined) meta.inputMax  = this._max
-    if (this._debounceMs !== undefined) meta.debounceMs = this._debounceMs
-  }
-}

package/src/columns/ToggleColumn.ts

@@ -1,46 +0,0 @@
-import { Column, type ColumnMeta, type ColumnColor } from '../Column.js'
-
-/**
- * Inline-edit boolean toggle. Renders a Switch in the cell; each click
- * fires an immediate PATCH (no debounce). Falsy values render off,
- * truthy on — strings like `'true'` / `'1'` from URL-encoded bodies are
- * normalized by the route handler.
- *
- *   ToggleColumn.make('featured')
- *     .onColor('success')
- *     .onIcon('star').offIcon('star-off')
- *
- * Pair with `Column.disabled(record => …)` for per-row gating
- * (e.g. forbid toggling on archived rows).
- */
-export class ToggleColumn extends Column {
-  protected _onColor?:  ColumnColor
-  protected _offColor?: ColumnColor
-  protected _onIcon?:   string
-  protected _offIcon?:  string
-
-  static override make(name: string): ToggleColumn {
-    const c = new ToggleColumn(name)
-    c.setColumnType('toggle')
-    return c
-  }
-
-  /** Color preset applied to the switch when on. Defaults to `'primary'`
-   * (renderer-side fallback) so users can opt into success / warning. */
-  onColor(c: ColumnColor): this { this._onColor = c; return this }
-
-  /** Color preset applied to the switch when off. Defaults to `'muted'`. */
-  offColor(c: ColumnColor): this { this._offColor = c; return this }
-
-  /** Icon (registry name) shown on the on side. When set on either side
-   * the renderer flips into icon-button mode instead of native toggle. */
-  onIcon(name: string): this { this._onIcon = name; return this }
-  offIcon(name: string): this { this._offIcon = name; return this }
-
-  protected override serializeExtras(meta: ColumnMeta): void {
-    if (this._onColor  !== undefined) meta.toggleOnColor  = this._onColor
-    if (this._offColor !== undefined) meta.toggleOffColor = this._offColor
-    if (this._onIcon   !== undefined) meta.toggleOnIcon   = this._onIcon
-    if (this._offIcon  !== undefined) meta.toggleOffIcon  = this._offIcon
-  }
-}