@pilotiq/pilotiq 0.1.0

package/src/index.ts

@@ -0,0 +1,521 @@
+// ─── Panel core ───────────────────────────────────────
+export {
+  Pilotiq,
+  type PilotiqConfig,
+  type PilotiqPlugin,
+  type UserResolver,
+  type UploadConfig,
+  type SignOutConfig,
+} from './Pilotiq.js'
+export {
+  UserMenuItem,
+  type UserMenuItemMeta,
+  type UserMenuItemColor,
+  type UserMenuItemValue,
+} from './UserMenuItem.js'
+export {
+  type RightPanelContribution,
+  type RightPanelProps,
+  RIGHT_PANEL_DEFAULT_WIDTH,
+  RIGHT_PANEL_MIN_WIDTH,
+  RIGHT_PANEL_MAX_WIDTH,
+} from './RightPanel.js'
+export {
+  resolveRenderHooks,
+  CHROME_HOOK_NAMES,
+  PAGE_HOOK_NAMES,
+  type RenderHookName,
+  type RenderHookContext,
+  type RenderHookFn,
+  type RenderHookScope,
+  type RenderHookEntry,
+  type RenderHookMap,
+} from './RenderHook.js'
+export { PilotiqRegistry } from './PilotiqRegistry.js'
+export { pilotiq } from './PilotiqServiceProvider.js'
+export { registerPilotiqRoutes } from './routes.js'
+export {
+  searchAllResources,
+  type GlobalSearchResult,
+  type GlobalSearchOptions,
+} from './search.js'
+
+// Per-page-role data builders (consumed by Vike +data hooks for SPA nav).
+export type { NavItem, UserMenuMeta, PanelInfoRoute } from './pageData.js'
+export {
+  applyPageHooks,
+  pageHooksFor,
+  type PageRole,
+} from './applyPageHooks.js'
+export {
+  dispatchPageData,
+  panelInfo,
+  resolvePageHooks,
+  applyRoleHooks,
+  dashboardData,
+  resourceIndexData,
+  resourceCreateData,
+  resourceEditData,
+  resourceViewData,
+  globalEditData,
+  globalViewData,
+  customPageData,
+  resolveServerDataElements,
+  tagWidgetUrls,
+  widgetData,
+  type ServerDataMap,
+  type WidgetScope,
+  type WidgetRequest,
+  type WidgetSuccess,
+  type WidgetFailure,
+  type PageContextLike,
+} from './pageData.js'
+export { Resource, type ResourcePages, type ResourceClass } from './Resource.js'
+export {
+  RelationManager,
+  RESERVED_RELATIONSHIP_TOKENS,
+  safeManagerPolicy,
+  isManagerCanOverridden,
+  type RelationManagerContext,
+  type ManagerCanMethod,
+} from './RelationManager.js'
+export { Global, type GlobalPages, type GlobalClass } from './Global.js'
+export { Cluster, type ClusterClass } from './Cluster.js'
+export { Page, type PageMeta, type PageMode } from './Page.js'
+export {
+  // Page base classes — extend these to bind a Page to a Resource.
+  ListPage, CreatePage, EditPage, ViewPage,
+  // Factory functions — return anonymous subclasses bound to a Resource.
+  defaultPages,
+  defaultListPage, defaultCreatePage, defaultEditPage, defaultViewPage,
+  // Helpers exposed for advanced override of the default schema wiring.
+  applyFormDefaults, applyTableDefaults,
+} from './defaultPages.js'
+export {
+  defaultGlobalPages,
+  defaultGlobalEditPage,
+  defaultGlobalViewPage,
+} from './defaultGlobalPages.js'
+export {
+  Column,
+  type ColumnMeta,
+  type ColumnAlignment,
+  type ColumnType,
+  type ColumnWeight,
+  type ColumnColor,
+  type ColumnFormat,
+  type FormatStateHandler,
+  type ColumnDisabledFn,
+  type ColumnSelectOption,
+} from './Column.js'
+
+export {
+  TextColumn,
+  BadgeColumn,
+  type BadgeColor,
+  IconColumn,
+  type IconOption,
+  BooleanColumn,
+  ImageColumn,
+  TextInputColumn,
+  type TextInputColumnType,
+  ToggleColumn,
+  SelectColumn,
+  type SelectColumnOptionsInput,
+} from './columns/index.js'
+
+// ─── Column summarizers (footer aggregates) ───────────
+export {
+  Summarizer,
+  Sum,
+  Average,
+  Count,
+  Range,
+  type SummarizerKind,
+  type SummarizerMeta,
+  type SummaryResult,
+  type SummaryFormatter,
+} from './summarizers/index.js'
+
+// ─── ORM model wiring ─────────────────────────────────
+export {
+  modelSave, modelLoadRecord, modelTableRecords, findRecord, getPrimaryKey,
+  defaultRelatedQuery, resolveRelatedQuery, modelRelationTableRecords,
+  type ModelLike, type ModelQuery, type ModelWhereOperator,
+  type QueryContext, type ResourceLike,
+} from './orm/modelDefaults.js'
+
+// ─── Schema (Element tree + resolver) ─────────────────
+export { Element, type ElementMeta } from './schema/Element.js'
+export {
+  resolveSchema,
+  registerResolver,
+  type SchemaDefinition,
+  type SchemaContext,
+  type RenderContext,
+  type RenderMode,
+  type ElementResolver,
+} from './schema/resolveSchema.js'
+
+// Display elements
+export { Text, type TextColor, type TextSize, type TextWeight } from './schema/Text.js'
+export { Heading } from './schema/Heading.js'
+export { Alert, type AlertType } from './schema/Alert.js'
+export { EmptyState } from './schema/EmptyState.js'
+export { Divider } from './schema/Divider.js'
+export { UnorderedList } from './schema/UnorderedList.js'
+export { Image, type ImageShape } from './schema/Image.js'
+export { Icon, type IconColor } from './schema/Icon.js'
+export { Markdown, type MarkdownProseSize } from './schema/Markdown.js'
+export { Html } from './schema/Html.js'
+export { MetaTag,   type MetaTagAttrs }   from './schema/MetaTag.js'
+export { LinkTag,   type LinkTagAttrs }   from './schema/LinkTag.js'
+export { ScriptTag, type ScriptTagAttrs } from './schema/ScriptTag.js'
+export { StyleTag } from './schema/StyleTag.js'
+
+// Plan #16 — read-only entry primitives for `Resource.detail()`.
+export {
+  Entry,
+  isEntry,
+  type EntryMeta,
+  type EntryFormat,
+  type EntryFormatStateHandler,
+  type EntryWeight,
+  type EntryColor,
+  type EntrySize,
+} from './entries/Entry.js'
+export { TextEntry } from './entries/TextEntry.js'
+export { BadgeEntry } from './entries/BadgeEntry.js'
+export { IconEntry, type IconEntryOption } from './entries/IconEntry.js'
+export { ImageEntry, type ImageEntryShape } from './entries/ImageEntry.js'
+export { KeyValueEntry } from './entries/KeyValueEntry.js'
+export { ColorEntry, type ColorEntryShape } from './entries/ColorEntry.js'
+export { CodeEntry } from './entries/CodeEntry.js'
+export { ComponentEntry } from './entries/ComponentEntry.js'
+export {
+  RepeatableEntry,
+  type RepeatableEntryMeta,
+  type RepeatableEntryRowMeta,
+  type RepeatableEntryTableColumn,
+} from './entries/RepeatableEntry.js'
+
+// Plan #15 — server-data widget elements
+export {
+  ServerDataElement,
+  isServerDataElement,
+  stampServerDataMeta,
+} from './schema/ServerDataElement.js'
+export { View, type ViewDataHandler } from './schema/View.js'
+export {
+  Stat,
+  type StatMeta,
+  type StatColor,
+  type StatDescriptionIcon,
+  type StatDescriptionIconPosition,
+} from './schema/Stat.js'
+export {
+  StatsOverview,
+  type StatsHandler,
+  type StatsOverviewPayload,
+} from './schema/StatsOverview.js'
+export {
+  TableWidget,
+  type TableWidgetRecordsHandler,
+  type TableWidgetRecordsResult,
+  type TableWidgetQueryHandler,
+  type TableWidgetPayload,
+} from './schema/TableWidget.js'
+
+// Container elements
+export { Card } from './schema/Card.js'
+export { Section } from './schema/Section.js'
+export { Tabs, Tab } from './schema/Tabs.js'
+export { Grid } from './schema/Grid.js'
+export { Group } from './schema/Group.js'
+export { Fieldset } from './schema/Fieldset.js'
+export { Split, type SplitFrom } from './schema/Split.js'
+export { Wizard, Step } from './schema/Wizard.js'
+
+// Form / Table containers (own their own lifecycle)
+export {
+  Form,
+  type FormMethod,
+  type FormMeta,
+  type FormContext,
+  type SaveHandler,
+  type MutateDataHandler,
+  type LifecycleHandler,
+  type AfterSaveHandler,
+  type RedirectHandler,
+  type LoadRecordHandler,
+  type FillFromRecordHandler,
+} from './elements/Form.js'
+export {
+  Table,
+  type TableMeta,
+  type TableContext,
+  type TableQueryHandler,
+  type TableRecordsHandler,
+  type TableRecordsResult,
+  type SortDirection,
+  type ContentLayout,
+  type CardSchemaHandler,
+  type CardsPerRow,
+} from './elements/Table.js'
+export {
+  TableGroup,
+  type TableGroupMeta,
+  type TableGroupTitleHandler,
+  type TableGroupDescriptionHandler,
+  type TableGroupKeyComparator,
+  orderByKeys,
+} from './elements/TableGroup.js'
+export {
+  loadTableRecords,
+  parseTableQuery,
+  parseActiveGroup,
+  parseFilterValues,
+  findTables,
+  type QueryParams,
+} from './elements/dispatchTable.js'
+
+// List-page tabs (Filament-style query-shortcut strips above the table)
+export {
+  ListTab,
+  type ListTabMeta,
+  type TabBadgeColor,
+  type TabBadgeHandler,
+  type TabQueryHandler,
+  type TabContextHandler,
+} from './Tab.js'
+export { ListTabs } from './elements/ListTabs.js'
+
+// ─── Filters ──────────────────────────────────────────
+export {
+  Filter,
+  type FilterKind,
+  type FilterMeta,
+  type FilterQueryHandler,
+  type FilterIndicatorHandler,
+} from './filters/Filter.js'
+export { SelectFilter, type SelectFilterOption } from './filters/SelectFilter.js'
+export {
+  MultiSelectFilter,
+  type MultiSelectFilterOption,
+  parseMultiSelectValue,
+  encodeMultiSelectValue,
+} from './filters/MultiSelectFilter.js'
+export { BooleanFilter, coerceBooleanFilterValue } from './filters/BooleanFilter.js'
+export { TrashedFilter } from './filters/TrashedFilter.js'
+export { TernaryFilter } from './filters/TernaryFilter.js'
+export {
+  DateRangeFilter,
+  parseDateRangeValue,
+  encodeDateRangeValue,
+  type DateRangeValue,
+} from './filters/DateRangeFilter.js'
+export {
+  FormFilter,
+  parseFormFilterValue,
+  encodeFormFilterValue,
+  type FormFilterValue,
+  type FormFilterQueryHandler,
+  type FormFilterIndicatorHandler,
+} from './filters/FormFilter.js'
+export {
+  QueryBuilderFilter,
+  parseQueryBuilderValue,
+  encodeQueryBuilderValue,
+  emptyQueryBuilderTree,
+  applyTreeToQuery,
+  isQueryBuilderTree,
+  countLeafRules,
+  type QueryBuilderTree,
+  type QueryBuilderTreeChild,
+  type QueryBuilderRule,
+  type QueryBuilderQueryHandler,
+  type QueryBuilderIndicatorHandler,
+} from './filters/QueryBuilderFilter.js'
+export {
+  Constraint,
+  TextConstraint,
+  NumberConstraint,
+  DateConstraint,
+  SelectConstraint,
+  BooleanConstraint,
+  type ConstraintMeta,
+  type ConstraintOperator,
+  type ConstraintOperatorName,
+  type ConstraintValueKind,
+} from './filters/queryBuilder/index.js'
+export {
+  dispatchFormSubmit,
+  findForms,
+  selectForm,
+  selectFormById,
+  type DispatchResult,
+  type DispatchSuccess,
+  type DispatchFailure,
+} from './elements/dispatchForm.js'
+export {
+  dispatchAction,
+  findActions,
+  parseActionBody,
+  type ActionRequestInput,
+  type DispatchActionInput,
+  type DispatchActionResult,
+  type DispatchActionSuccess,
+  type DispatchActionFailure,
+  type ResolveRecord,
+} from './elements/dispatchAction.js'
+
+// ─── Fields ───────────────────────────────────────────
+export {
+  Field,
+  type FieldType,
+  type FieldMeta,
+  type FieldCondition,
+  type ConditionContext,
+  type LiveOptions,
+  type AfterStateUpdatedHandler,
+  type AfterStateUpdatedContext,
+  type FieldDecoration,
+  type FormatStateUsingHandler,
+  type DistinctOptions,
+} from './fields/Field.js'
+export { resolveField, resolveFields } from './fields/resolveField.js'
+export { TextField } from './fields/TextField.js'
+export { TextareaField } from './fields/TextareaField.js'
+export { EmailField } from './fields/EmailField.js'
+export { NumberField } from './fields/NumberField.js'
+export { SelectField } from './fields/SelectField.js'
+export { ToggleField } from './fields/ToggleField.js'
+export { DateField } from './fields/DateField.js'
+export { SlugField } from './fields/SlugField.js'
+export { HiddenField, Hidden }     from './fields/HiddenField.js'
+export { CheckboxField, Checkbox } from './fields/CheckboxField.js'
+export { RadioField, Radio }       from './fields/RadioField.js'
+export { ToggleButtonsField, ToggleButtons } from './fields/ToggleButtonsField.js'
+export { CheckboxListField, CheckboxList } from './fields/CheckboxListField.js'
+export { SliderField, Slider }             from './fields/SliderField.js'
+export { ColorPickerField, ColorPicker }   from './fields/ColorPickerField.js'
+export { DateTimePickerField, DateTimePicker } from './fields/DateField.js'
+export { KeyValueField, KeyValue }         from './fields/KeyValueField.js'
+export { TagsInputField, TagsInput, type TagsSuggestionsResolver } from './fields/TagsInputField.js'
+export { FileUploadField, FileUpload }     from './fields/FileUploadField.js'
+export {
+  MarkdownField,
+  DEFAULT_MARKDOWN_TOOLBAR,
+  type MarkdownToolbarButton,
+  type MarkdownAttachmentVisibility,
+} from './fields/MarkdownField.js'
+export {
+  RepeaterField,
+  Repeater,
+  isRepeaterField,
+  type RepeaterFieldMeta,
+  type RepeaterRowMeta,
+  type RepeaterItemLabel,
+  type RepeaterTableColumn,
+  type RepeaterItemHiddenRule,
+} from './fields/RepeaterField.js'
+export {
+  RowButton,
+  type RowButtonMeta,
+  type RowButtonsMeta,
+  type RowButtonKind,
+  type RowButtonColor,
+} from './fields/RowButton.js'
+export {
+  BuilderField,
+  Builder,
+  isBuilderField,
+  type BuilderFieldMeta,
+  type BuilderRowMeta,
+  type BuilderItemLabel,
+  type BuilderItemHiddenRule,
+  type BuilderAddActionAlignment,
+} from './fields/BuilderField.js'
+export { Block, type BlockMeta } from './schema/Block.js'
+
+// ─── Uploads ──────────────────────────────────────────
+// `localUpload` (and any future Node-only adapters) live under the
+// `@pilotiq/pilotiq/uploads` subpath so client bundles don't drag in
+// `node:fs/promises` / `node:crypto` via the Vite plugin's manifest
+// crawl. Types are safe to re-export from the root since TS strips
+// them at build time.
+export type {
+  UploadAdapter,
+  UploadRequest,
+  UploadResult,
+} from './uploads/index.js'
+export {
+  type SelectOption,
+  type OptionsResolver,
+  resolveOptions,
+} from './fields/optionsResolver.js'
+
+// ─── Actions ──────────────────────────────────────────
+export {
+  Action,
+  type ActionPlacement,
+  type ActionContext,
+  type ActionHandler,
+  type ActionResult,
+  type ActionConfirm,
+  type ActionMethod,
+  type ActionMeta,
+  type ActionColor,
+  type ActionSize,
+  type ActionModalWidth,
+  type ActionModalMeta,
+  type ActionVisibilityContext,
+  type VisibilityRule,
+} from './actions/Action.js'
+
+export {
+  ActionGroup,
+  type ActionGroupMeta,
+} from './actions/ActionGroup.js'
+
+// ─── Notifications ────────────────────────────────────
+export {
+  Notification,
+  type NotificationType,
+  type NotificationMeta,
+} from './notifications/Notification.js'
+export type { Notifiable } from './notifications/types.js'
+export {
+  listForUser    as listDatabaseNotifications,
+  unreadCount    as databaseNotificationsUnreadCount,
+  markAsRead     as markDatabaseNotificationAsRead,
+  markAsUnread   as markDatabaseNotificationAsUnread,
+  markAllAsRead  as markAllDatabaseNotificationsAsRead,
+  persistDatabaseNotification,
+  type DatabaseNotificationMeta,
+} from './notifications/index.js'
+export type { DatabaseNotificationsConfig } from './Pilotiq.js'
+
+// ─── Validation ───────────────────────────────────────
+export {
+  makeValidator,
+  required, email, minLength, maxLength, min, max, pattern,
+  unique,
+  validateSchema, isValid,
+  type Validator, type ValidatorFn, type ValidatorContext,
+  type SerializedRule, type ValidationErrors,
+  type UniqueOptions,
+} from './validation/index.js'
+
+// ─── Theme ────────────────────────────────────────────
+export { resolveTheme, generateThemeCSS, iconMap, resolveIconName } from './theme/index.js'
+export {
+  presets, baseColors, resolveThemeColor, resolveChartColor, radiusMap,
+  colors, BASE_COLOR_NAMES, HUE_NAMES, parseSeedToScale,
+} from './theme/index.js'
+export type {
+  ThemeConfig, ThemeMeta,
+  StylePreset, BaseColor, HueColor, ThemeColor, ChartColor, RadiusPreset,
+  IconLibrary, ThemeFonts, PresetDefinition,
+  ColorName, ColorScale, ColorStep,
+} from './theme/index.js'

package/src/io/csv.test.ts

@@ -0,0 +1,142 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+
+import { encodeCsv, parseCsv } from './csv.js'
+
+describe('encodeCsv', () => {
+  it('emits header row + body rows separated by CRLF', () => {
+    const out = encodeCsv(
+      [{ id: 1, name: 'Ada' }, { id: 2, name: 'Grace' }],
+      [{ key: 'id', label: 'ID' }, { key: 'name', label: 'Name' }],
+    )
+    assert.equal(out, 'ID,Name\r\n1,Ada\r\n2,Grace\r\n')
+  })
+
+  it('falls back to key when label is omitted', () => {
+    const out = encodeCsv([{ id: 1 }], [{ key: 'id' }])
+    assert.equal(out, 'id\r\n1\r\n')
+  })
+
+  it('header-only output when rows are empty (no trailing CRLF)', () => {
+    const out = encodeCsv([], [{ key: 'id', label: 'ID' }, { key: 'name' }])
+    assert.equal(out, 'ID,name')
+  })
+
+  it('returns empty string when columns are empty', () => {
+    assert.equal(encodeCsv([{ id: 1 }], []), '')
+  })
+
+  it('null / undefined / missing keys → empty cell', () => {
+    const out = encodeCsv(
+      [{ a: null, b: undefined }],
+      [{ key: 'a' }, { key: 'b' }, { key: 'c' }],
+    )
+    assert.equal(out, 'a,b,c\r\n,,\r\n')
+  })
+
+  it('Date values serialize as ISO 8601', () => {
+    const d = new Date('2026-05-03T14:00:00.000Z')
+    const out = encodeCsv([{ at: d }], [{ key: 'at' }])
+    assert.equal(out, 'at\r\n2026-05-03T14:00:00.000Z\r\n')
+  })
+
+  it('numbers, booleans, bigints serialize via String()', () => {
+    const out = encodeCsv(
+      [{ n: 42, b: true, big: 9007199254740993n }],
+      [{ key: 'n' }, { key: 'b' }, { key: 'big' }],
+    )
+    assert.equal(out, 'n,b,big\r\n42,true,9007199254740993\r\n')
+  })
+
+  it('quotes cells containing comma / quote / newline / leading or trailing whitespace', () => {
+    const out = encodeCsv(
+      [{ a: 'has, comma', b: 'has "quote"', c: 'line\nbreak', d: ' padded ' }],
+      [{ key: 'a' }, { key: 'b' }, { key: 'c' }, { key: 'd' }],
+    )
+    assert.equal(
+      out,
+      'a,b,c,d\r\n"has, comma","has ""quote""","line\nbreak"," padded "\r\n',
+    )
+  })
+
+  it('plain values without special characters do not get quoted', () => {
+    const out = encodeCsv([{ a: 'hello' }], [{ key: 'a' }])
+    assert.equal(out, 'a\r\nhello\r\n')
+  })
+
+  it('object values fall back to JSON.stringify', () => {
+    const out = encodeCsv([{ meta: { x: 1 } }], [{ key: 'meta' }])
+    assert.equal(out, 'meta\r\n"{""x"":1}"\r\n')
+  })
+})
+
+describe('parseCsv', () => {
+  it('parses headers + body into objects keyed by header', () => {
+    const r = parseCsv('id,name\r\n1,Ada\r\n2,Grace\r\n')
+    assert.deepEqual(r.headers, ['id', 'name'])
+    assert.deepEqual(r.rows, [
+      { id: '1', name: 'Ada' },
+      { id: '2', name: 'Grace' },
+    ])
+  })
+
+  it('tolerates LF-only line endings', () => {
+    const r = parseCsv('a,b\n1,2\n3,4')
+    assert.deepEqual(r.rows, [{ a: '1', b: '2' }, { a: '3', b: '4' }])
+  })
+
+  it('strips a UTF-8 BOM', () => {
+    const r = parseCsv('id\r\n42\r\n')
+    assert.deepEqual(r.headers, ['id'])
+    assert.deepEqual(r.rows, [{ id: '42' }])
+  })
+
+  it('drops a trailing empty line', () => {
+    const r = parseCsv('id\r\n1\r\n2\r\n\r\n')
+    assert.deepEqual(r.rows, [{ id: '1' }, { id: '2' }])
+  })
+
+  it('handles unquoted, quoted, and mixed cells', () => {
+    const r = parseCsv('a,b,c\r\nplain,"has, comma","line\nbreak"\r\n')
+    assert.deepEqual(r.rows, [{ a: 'plain', b: 'has, comma', c: 'line\nbreak' }])
+  })
+
+  it('decodes "" → " inside a quoted cell', () => {
+    const r = parseCsv('a\r\n"he said ""hi"""\r\n')
+    assert.deepEqual(r.rows, [{ a: 'he said "hi"' }])
+  })
+
+  it('treats every cell as a string (no type inference)', () => {
+    const r = parseCsv('n,b,d\r\n42,true,2026-05-03\r\n')
+    assert.deepEqual(r.rows, [{ n: '42', b: 'true', d: '2026-05-03' }])
+  })
+
+  it('row with fewer cells than headers fills with empty string', () => {
+    const r = parseCsv('a,b,c\r\n1,2\r\n')
+    assert.deepEqual(r.rows, [{ a: '1', b: '2', c: '' }])
+  })
+
+  it('row with extra cells silently drops them', () => {
+    const r = parseCsv('a,b\r\n1,2,3,4\r\n')
+    assert.deepEqual(r.rows, [{ a: '1', b: '2' }])
+  })
+
+  it('throws on empty input', () => {
+    assert.throws(() => parseCsv(''),  /empty input/)
+    assert.throws(() => parseCsv('  '), /empty input/)
+  })
+
+  it('throws on unterminated quoted cell at EOF', () => {
+    assert.throws(() => parseCsv('a\r\n"unclosed'), /unterminated/)
+  })
+
+  it('round-trip — encode then parse recovers row data as strings', () => {
+    const rows = [
+      { id: '1', name: 'has, comma',  body: 'multi\nline' },
+      { id: '2', name: 'plain',       body: 'with "quotes"' },
+    ]
+    const csv = encodeCsv(rows, [{ key: 'id' }, { key: 'name' }, { key: 'body' }])
+    const parsed = parseCsv(csv)
+    assert.deepEqual(parsed.rows, rows)
+  })
+})