@pilotiq/pilotiq 0.1.0

package/dist/elements/Form.d.ts

@@ -0,0 +1,219 @@
+import { Element, type ElementMeta } from '../schema/Element.js';
+import type { Validator, ValidationErrors } from '../validation/index.js';
+import type { Notification, NotificationMeta } from '../notifications/index.js';
+export type FormMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
+export interface FormContext<R = unknown> {
+    values: Record<string, unknown>;
+    record?: R;
+    request?: unknown;
+    /**
+     * The panel's mount path (e.g. `/admin`, `/new-admin`). Populated by
+     * the framework's POST handlers so user-supplied callbacks
+     * (`redirectAfterSave` / page `getRedirectUrl`) can build absolute
+     * URLs without hardcoding the base.
+     */
+    basePath?: string;
+    [key: string]: unknown;
+}
+export type SaveHandler<R = unknown> = (data: Record<string, unknown>, ctx: FormContext<R>) => Promise<R> | R;
+export type MutateDataHandler = (data: Record<string, unknown>, ctx: FormContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+export type LifecycleHandler<R = unknown> = (data: Record<string, unknown>, ctx: FormContext<R>) => void | Promise<void>;
+export type AfterSaveHandler<R = unknown> = (record: R, ctx: FormContext<R>) => void | Promise<void>;
+export type RedirectHandler<R = unknown> = (record: R, ctx: FormContext<R>) => string;
+export type LoadRecordHandler<R = unknown> = (id: string, ctx: FormContext<R>) => Promise<R | null> | R | null;
+export type FillFromRecordHandler<R = unknown> = (record: R) => Record<string, unknown>;
+/**
+ * Transform values during the edit-mode load path. `mutateFormDataBeforeFill`
+ * runs before `fillFromRecord` (input is whatever was passed into the form);
+ * `mutateFormDataAfterFill` runs after, on the values produced by
+ * `fillFromRecord`. Both receive the loaded record on `ctx.record`.
+ */
+export type FillMutator<R = unknown> = (values: Record<string, unknown>, ctx: FormContext<R>) => Record<string, unknown> | Promise<Record<string, unknown>>;
+/**
+ * Resolve a saved-notification spec into a `Notification`/meta. `null`
+ * means "skip" (notifications disabled for this mode). Strings shorthand
+ * to a success notification with that title.
+ */
+export type SavedNotificationHandler<R = unknown> = string | Notification | NotificationMeta | null | ((record: R, ctx: FormContext<R>) => string | Notification | NotificationMeta | null);
+export interface FormMeta extends ElementMeta {
+    type: 'form';
+    formId: string;
+    /** Plan #8 — wizard step-validate endpoint, when the form has a Wizard descendant. */
+    wizardUrl?: string;
+    method: FormMethod;
+    action?: string;
+    values?: Record<string, unknown>;
+    errors?: ValidationErrors;
+    /**
+     * Plan #5 partial-resolve endpoint URL. Emitted only when at least
+     * one descendant field has `live()` set; the client uses its presence
+     * to decide whether to switch into controlled-state mode and POST on
+     * `live` field changes.
+     */
+    stateUrl?: string;
+}
+/**
+ * Form container. Holds children (Fields, Sections, Tabs, Actions, …) plus
+ * a server-side lifecycle: validate → mutateData → beforeSave → save →
+ * afterSave → redirectAfterSave. Handlers stay on the server; `toMeta()`
+ * emits only what the client needs to render the form (id, method, action
+ * URL, current values, validation errors).
+ *
+ * Phase 2.1 ships the shape and serialization. Lifecycle dispatch on POST
+ * is wired in 2.4.
+ */
+export declare class Form<R = unknown> extends Element {
+    private _formId;
+    private _method;
+    private _action?;
+    private _formValidators;
+    private _mutateData?;
+    private _mutateDataBeforeCreate?;
+    private _mutateDataBeforeUpdate?;
+    private _beforeSave?;
+    private _beforeCreate?;
+    private _beforeUpdate?;
+    private _save?;
+    private _handleCreate?;
+    private _handleUpdate?;
+    private _afterSave?;
+    private _afterCreate?;
+    private _afterUpdate?;
+    private _redirectAfterSave?;
+    private _fillFromRecord?;
+    private _mutateFormDataBeforeFill?;
+    private _mutateFormDataAfterFill?;
+    private _loadRecord?;
+    /**
+     * Saved-notification spec for the generic both-modes path. Mode-specific
+     * specs (`_createdNotification`) take precedence in their respective mode.
+     * `null` means "explicitly disabled" (different from undefined which means
+     * "use the framework default"). `false` (via `disableSavedNotification`)
+     * disables for both modes regardless of mode-specific spec.
+     */
+    private _savedNotification?;
+    private _createdNotification?;
+    private _savedNotificationDisabled;
+    private _values?;
+    private _errors?;
+    private _wizardUrl?;
+    private _stateUrl?;
+    private constructor();
+    static make<R = unknown>(): Form<R>;
+    schema(elements: Element[]): this;
+    formId(id: string): this;
+    method(m: FormMethod): this;
+    action(url: string): this;
+    /** Form-level validators run after field-level ones. Useful for cross-field rules. */
+    validate(...validators: Validator[]): this;
+    /**
+     * Transform the validated payload before `save()`. Runs after validation
+     * passes, on **both** create and update. Pair with
+     * `mutateDataBeforeCreate` / `mutateDataBeforeUpdate` for mode-specific
+     * tweaks that layer on top.
+     */
+    mutateData(fn: MutateDataHandler): this;
+    /** Create-only payload mutator. Runs after `mutateData` when `ctx.record` is undefined. */
+    mutateDataBeforeCreate(fn: MutateDataHandler): this;
+    /** Update-only payload mutator. Runs after `mutateData` when `ctx.record` is set. */
+    mutateDataBeforeUpdate(fn: MutateDataHandler): this;
+    beforeSave(fn: LifecycleHandler<R>): this;
+    /** Create-only pre-save hook. Runs after `beforeSave` when `ctx.record` is undefined. */
+    beforeCreate(fn: LifecycleHandler<R>): this;
+    /** Update-only pre-save hook. Runs after `beforeSave` when `ctx.record` is set. */
+    beforeUpdate(fn: LifecycleHandler<R>): this;
+    /**
+     * Persistence handler. Required for any form that accepts submits. No
+     * default implementation — Phase 3 ships an ORM adapter via
+     * `Resource.model`.
+     */
+    save(fn: SaveHandler<R>): this;
+    /**
+     * Create-only persistence override. Replaces `save()` for create mode.
+     * Use when create and update need distinct persistence paths (e.g.
+     * `Article.create(...)` vs `Article.update(id, ...)`).
+     */
+    handleCreate(fn: SaveHandler<R>): this;
+    /** Update-only persistence override. Replaces `save()` for update mode. */
+    handleUpdate(fn: SaveHandler<R>): this;
+    afterSave(fn: AfterSaveHandler<R>): this;
+    /** Create-only post-save hook. Runs after `afterSave` when `ctx.record` was undefined. */
+    afterCreate(fn: AfterSaveHandler<R>): this;
+    /** Update-only post-save hook. Runs after `afterSave` when `ctx.record` was set. */
+    afterUpdate(fn: AfterSaveHandler<R>): this;
+    /** Where to redirect after a successful save. Receives the saved record. */
+    redirectAfterSave(fn: RedirectHandler<R>): this;
+    /** Map a loaded record into form values for edit mode. Defaults to `{ ...record }`. */
+    fillFromRecord(fn: FillFromRecordHandler<R>): this;
+    /** Transform values BEFORE `fillFromRecord` runs. Edit mode only. */
+    mutateFormDataBeforeFill(fn: FillMutator<R>): this;
+    /** Transform values AFTER `fillFromRecord` runs. Edit mode only. */
+    mutateFormDataAfterFill(fn: FillMutator<R>): this;
+    /** Load a record by id for edit mode. */
+    loadRecord(fn: LoadRecordHandler<R>): this;
+    /**
+     * Notification fired after a successful save (both modes). Pass a string
+     * for a default success toast with that title, a fully-built
+     * `Notification`/meta, or a function that builds one from the saved
+     * record. Pass `null` to suppress the framework's default toast for
+     * this mode.
+     */
+    savedNotification(spec: SavedNotificationHandler<R>): this;
+    /** Create-only notification override. Falls back to `savedNotification` if unset. */
+    createdNotification(spec: SavedNotificationHandler<R>): this;
+    /** Disable the success toast entirely (both modes). */
+    disableSavedNotification(): this;
+    /**
+     * Set the current form values for rendering. Called by route handlers in
+     * edit mode (after `loadRecord` + `fillFromRecord`) and on validation
+     * errors (so the user's input is preserved).
+     */
+    withValues(values: Record<string, unknown>): this;
+    /** Attach validation errors for re-render after a failed submit. */
+    withErrors(errors: ValidationErrors): this;
+    /**
+     * Plan #5 — set the partial-resolve endpoint URL. Stamped at
+     * render-time by the route handler; the client POSTs `live` field
+     * changes here and receives a fresh re-resolved FormMeta back. Pass
+     * `undefined` to clear (e.g. forms with no live fields).
+     */
+    withStateUrl(url: string | undefined): this;
+    getStateUrl(): string | undefined;
+    /**
+     * Plan #8 — set the wizard step-validate endpoint URL. Stamped at
+     * render-time when the form has a Wizard descendant; the client
+     * POSTs `{ step, values }` here on each Next-button click and
+     * receives `{ ok }` (200) or `{ ok:false, errors }` (422).
+     */
+    withWizardUrl(url: string | undefined): this;
+    getWizardUrl(): string | undefined;
+    getFormId(): string;
+    getMethod(): FormMethod;
+    getAction(): string | undefined;
+    getFormValidators(): Validator[];
+    getMutateData(): MutateDataHandler | undefined;
+    getMutateDataBeforeCreate(): MutateDataHandler | undefined;
+    getMutateDataBeforeUpdate(): MutateDataHandler | undefined;
+    getBeforeSave(): LifecycleHandler<R> | undefined;
+    getBeforeCreate(): LifecycleHandler<R> | undefined;
+    getBeforeUpdate(): LifecycleHandler<R> | undefined;
+    getSave(): SaveHandler<R> | undefined;
+    getHandleCreate(): SaveHandler<R> | undefined;
+    getHandleUpdate(): SaveHandler<R> | undefined;
+    getAfterSave(): AfterSaveHandler<R> | undefined;
+    getAfterCreate(): AfterSaveHandler<R> | undefined;
+    getAfterUpdate(): AfterSaveHandler<R> | undefined;
+    getRedirectAfterSave(): RedirectHandler<R> | undefined;
+    getFillFromRecord(): FillFromRecordHandler<R> | undefined;
+    getMutateFormDataBeforeFill(): FillMutator<R> | undefined;
+    getMutateFormDataAfterFill(): FillMutator<R> | undefined;
+    getLoadRecord(): LoadRecordHandler<R> | undefined;
+    getSavedNotification(): SavedNotificationHandler<R> | null | undefined;
+    getCreatedNotification(): SavedNotificationHandler<R> | null | undefined;
+    isSavedNotificationDisabled(): boolean;
+    getType(): string;
+    toMeta(): FormMeta;
+}
+/** @internal — reset the formId counter; tests use this to keep ids stable. */
+export declare function _resetFormIdSeq(): void;
+//# sourceMappingURL=Form.d.ts.map

package/dist/elements/Form.d.ts.map

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

package/dist/elements/Form.js

@@ -0,0 +1,259 @@
+import { Element } from '../schema/Element.js';
+let _formIdSeq = 0;
+function nextFormId() {
+    _formIdSeq += 1;
+    return `form-${_formIdSeq}`;
+}
+/**
+ * Form container. Holds children (Fields, Sections, Tabs, Actions, …) plus
+ * a server-side lifecycle: validate → mutateData → beforeSave → save →
+ * afterSave → redirectAfterSave. Handlers stay on the server; `toMeta()`
+ * emits only what the client needs to render the form (id, method, action
+ * URL, current values, validation errors).
+ *
+ * Phase 2.1 ships the shape and serialization. Lifecycle dispatch on POST
+ * is wired in 2.4.
+ */
+export class Form extends Element {
+    _formId = nextFormId();
+    _method = 'post';
+    _action;
+    _formValidators = [];
+    _mutateData;
+    _mutateDataBeforeCreate;
+    _mutateDataBeforeUpdate;
+    _beforeSave;
+    _beforeCreate;
+    _beforeUpdate;
+    _save;
+    _handleCreate;
+    _handleUpdate;
+    _afterSave;
+    _afterCreate;
+    _afterUpdate;
+    _redirectAfterSave;
+    _fillFromRecord;
+    _mutateFormDataBeforeFill;
+    _mutateFormDataAfterFill;
+    _loadRecord;
+    /**
+     * Saved-notification spec for the generic both-modes path. Mode-specific
+     * specs (`_createdNotification`) take precedence in their respective mode.
+     * `null` means "explicitly disabled" (different from undefined which means
+     * "use the framework default"). `false` (via `disableSavedNotification`)
+     * disables for both modes regardless of mode-specific spec.
+     */
+    _savedNotification;
+    _createdNotification;
+    _savedNotificationDisabled = false;
+    _values;
+    _errors;
+    // Plan #5 — partial-resolve endpoint. Stamped by the route handler at
+    // render time when any descendant field is `live()`; emits as
+    // (Plan #8) `wizardUrl` for step validation endpoint. Stamped only when
+    // the Form has a Wizard descendant.
+    _wizardUrl;
+    // `stateUrl` on FormMeta. Undefined when no live fields → client
+    // skips the controlled-state path entirely.
+    _stateUrl;
+    constructor() { super(); }
+    static make() {
+        return new Form();
+    }
+    // ─── Children ─────────────────────────────────────────
+    schema(elements) {
+        this._children = elements;
+        return this;
+    }
+    // ─── Static config ────────────────────────────────────
+    formId(id) { this._formId = id; return this; }
+    method(m) { this._method = m; return this; }
+    action(url) { this._action = url; return this; }
+    // ─── Lifecycle setters ────────────────────────────────
+    /** Form-level validators run after field-level ones. Useful for cross-field rules. */
+    validate(...validators) {
+        this._formValidators.push(...validators);
+        return this;
+    }
+    /**
+     * Transform the validated payload before `save()`. Runs after validation
+     * passes, on **both** create and update. Pair with
+     * `mutateDataBeforeCreate` / `mutateDataBeforeUpdate` for mode-specific
+     * tweaks that layer on top.
+     */
+    mutateData(fn) {
+        this._mutateData = fn;
+        return this;
+    }
+    /** Create-only payload mutator. Runs after `mutateData` when `ctx.record` is undefined. */
+    mutateDataBeforeCreate(fn) {
+        this._mutateDataBeforeCreate = fn;
+        return this;
+    }
+    /** Update-only payload mutator. Runs after `mutateData` when `ctx.record` is set. */
+    mutateDataBeforeUpdate(fn) {
+        this._mutateDataBeforeUpdate = fn;
+        return this;
+    }
+    beforeSave(fn) { this._beforeSave = fn; return this; }
+    /** Create-only pre-save hook. Runs after `beforeSave` when `ctx.record` is undefined. */
+    beforeCreate(fn) { this._beforeCreate = fn; return this; }
+    /** Update-only pre-save hook. Runs after `beforeSave` when `ctx.record` is set. */
+    beforeUpdate(fn) { this._beforeUpdate = fn; return this; }
+    /**
+     * Persistence handler. Required for any form that accepts submits. No
+     * default implementation — Phase 3 ships an ORM adapter via
+     * `Resource.model`.
+     */
+    save(fn) { this._save = fn; return this; }
+    /**
+     * Create-only persistence override. Replaces `save()` for create mode.
+     * Use when create and update need distinct persistence paths (e.g.
+     * `Article.create(...)` vs `Article.update(id, ...)`).
+     */
+    handleCreate(fn) { this._handleCreate = fn; return this; }
+    /** Update-only persistence override. Replaces `save()` for update mode. */
+    handleUpdate(fn) { this._handleUpdate = fn; return this; }
+    afterSave(fn) { this._afterSave = fn; return this; }
+    /** Create-only post-save hook. Runs after `afterSave` when `ctx.record` was undefined. */
+    afterCreate(fn) { this._afterCreate = fn; return this; }
+    /** Update-only post-save hook. Runs after `afterSave` when `ctx.record` was set. */
+    afterUpdate(fn) { this._afterUpdate = fn; return this; }
+    /** Where to redirect after a successful save. Receives the saved record. */
+    redirectAfterSave(fn) {
+        this._redirectAfterSave = fn;
+        return this;
+    }
+    /** Map a loaded record into form values for edit mode. Defaults to `{ ...record }`. */
+    fillFromRecord(fn) {
+        this._fillFromRecord = fn;
+        return this;
+    }
+    /** Transform values BEFORE `fillFromRecord` runs. Edit mode only. */
+    mutateFormDataBeforeFill(fn) {
+        this._mutateFormDataBeforeFill = fn;
+        return this;
+    }
+    /** Transform values AFTER `fillFromRecord` runs. Edit mode only. */
+    mutateFormDataAfterFill(fn) {
+        this._mutateFormDataAfterFill = fn;
+        return this;
+    }
+    /** Load a record by id for edit mode. */
+    loadRecord(fn) {
+        this._loadRecord = fn;
+        return this;
+    }
+    /**
+     * Notification fired after a successful save (both modes). Pass a string
+     * for a default success toast with that title, a fully-built
+     * `Notification`/meta, or a function that builds one from the saved
+     * record. Pass `null` to suppress the framework's default toast for
+     * this mode.
+     */
+    savedNotification(spec) {
+        this._savedNotification = spec;
+        return this;
+    }
+    /** Create-only notification override. Falls back to `savedNotification` if unset. */
+    createdNotification(spec) {
+        this._createdNotification = spec;
+        return this;
+    }
+    /** Disable the success toast entirely (both modes). */
+    disableSavedNotification() {
+        this._savedNotificationDisabled = true;
+        return this;
+    }
+    // ─── Render-time state ────────────────────────────────
+    /**
+     * Set the current form values for rendering. Called by route handlers in
+     * edit mode (after `loadRecord` + `fillFromRecord`) and on validation
+     * errors (so the user's input is preserved).
+     */
+    withValues(values) {
+        this._values = values;
+        return this;
+    }
+    /** Attach validation errors for re-render after a failed submit. */
+    withErrors(errors) {
+        this._errors = errors;
+        return this;
+    }
+    /**
+     * Plan #5 — set the partial-resolve endpoint URL. Stamped at
+     * render-time by the route handler; the client POSTs `live` field
+     * changes here and receives a fresh re-resolved FormMeta back. Pass
+     * `undefined` to clear (e.g. forms with no live fields).
+     */
+    withStateUrl(url) {
+        if (url === undefined) {
+            delete this._stateUrl;
+        }
+        else {
+            this._stateUrl = url;
+        }
+        return this;
+    }
+    getStateUrl() { return this._stateUrl; }
+    /**
+     * Plan #8 — set the wizard step-validate endpoint URL. Stamped at
+     * render-time when the form has a Wizard descendant; the client
+     * POSTs `{ step, values }` here on each Next-button click and
+     * receives `{ ok }` (200) or `{ ok:false, errors }` (422).
+     */
+    withWizardUrl(url) {
+        if (url === undefined) {
+            delete this._wizardUrl;
+        }
+        else {
+            this._wizardUrl = url;
+        }
+        return this;
+    }
+    getWizardUrl() { return this._wizardUrl; }
+    // ─── Getters (used by route handlers) ────────────────
+    getFormId() { return this._formId; }
+    getMethod() { return this._method; }
+    getAction() { return this._action; }
+    getFormValidators() { return this._formValidators; }
+    getMutateData() { return this._mutateData; }
+    getMutateDataBeforeCreate() { return this._mutateDataBeforeCreate; }
+    getMutateDataBeforeUpdate() { return this._mutateDataBeforeUpdate; }
+    getBeforeSave() { return this._beforeSave; }
+    getBeforeCreate() { return this._beforeCreate; }
+    getBeforeUpdate() { return this._beforeUpdate; }
+    getSave() { return this._save; }
+    getHandleCreate() { return this._handleCreate; }
+    getHandleUpdate() { return this._handleUpdate; }
+    getAfterSave() { return this._afterSave; }
+    getAfterCreate() { return this._afterCreate; }
+    getAfterUpdate() { return this._afterUpdate; }
+    getRedirectAfterSave() { return this._redirectAfterSave; }
+    getFillFromRecord() { return this._fillFromRecord; }
+    getMutateFormDataBeforeFill() { return this._mutateFormDataBeforeFill; }
+    getMutateFormDataAfterFill() { return this._mutateFormDataAfterFill; }
+    getLoadRecord() { return this._loadRecord; }
+    getSavedNotification() { return this._savedNotification; }
+    getCreatedNotification() { return this._createdNotification; }
+    isSavedNotificationDisabled() { return this._savedNotificationDisabled; }
+    // ─── Serialization ────────────────────────────────────
+    getType() { return 'form'; }
+    toMeta() {
+        return {
+            type: 'form',
+            formId: this._formId,
+            method: this._method,
+            ...(this._action !== undefined ? { action: this._action } : {}),
+            ...(this._values !== undefined ? { values: this._values } : {}),
+            ...(this._errors !== undefined ? { errors: this._errors } : {}),
+            ...(this._stateUrl !== undefined ? { stateUrl: this._stateUrl } : {}),
+            ...(this._wizardUrl !== undefined ? { wizardUrl: this._wizardUrl } : {}),
+        };
+    }
+}
+/** @internal — reset the formId counter; tests use this to keep ids stable. */
+export function _resetFormIdSeq() {
+    _formIdSeq = 0;
+}
+//# sourceMappingURL=Form.js.map

package/dist/elements/Form.js.map

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

package/dist/elements/ListTabs.d.ts

@@ -0,0 +1,17 @@
+import { Element, type ElementMeta } from '../schema/Element.js';
+import type { ListTab } from '../Tab.js';
+/** Container element holding a strip of `ListTab` triggers above a Table.
+ * Built by `ListPage.schema()` from `ListPage.getTabs()` — users typically
+ * don't construct this directly. The renderer treats it like a flat row of
+ * tab triggers (no body / no per-tab content), since each tab modifies the
+ * shared Table query rather than swapping in different content. */
+export declare class ListTabs extends Element {
+    private constructor();
+    static make(): ListTabs;
+    /** Set the tab list. Each entry is a `ListTab` instance with its own
+     * label/icon/badge/query modifier. */
+    tabs(tabs: ListTab[]): this;
+    getType(): string;
+    toMeta(): ElementMeta;
+}
+//# sourceMappingURL=ListTabs.d.ts.map

package/dist/elements/ListTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListTabs.d.ts","sourceRoot":"","sources":["../../src/elements/ListTabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC;;;;mEAImE;AACnE,qBAAa,QAAS,SAAQ,OAAO;IACnC,OAAO;IAEP,MAAM,CAAC,IAAI,IAAI,QAAQ;IAIvB;0CACsC;IACtC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKlB,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,WAAW;CAG/B"}

package/dist/elements/ListTabs.js

@@ -0,0 +1,23 @@
+import { Element } from '../schema/Element.js';
+/** Container element holding a strip of `ListTab` triggers above a Table.
+ * Built by `ListPage.schema()` from `ListPage.getTabs()` — users typically
+ * don't construct this directly. The renderer treats it like a flat row of
+ * tab triggers (no body / no per-tab content), since each tab modifies the
+ * shared Table query rather than swapping in different content. */
+export class ListTabs extends Element {
+    constructor() { super(); }
+    static make() {
+        return new ListTabs();
+    }
+    /** Set the tab list. Each entry is a `ListTab` instance with its own
+     * label/icon/badge/query modifier. */
+    tabs(tabs) {
+        this._children = tabs;
+        return this;
+    }
+    getType() { return 'listTabs'; }
+    toMeta() {
+        return { type: 'listTabs' };
+    }
+}
+//# sourceMappingURL=ListTabs.js.map

package/dist/elements/ListTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListTabs.js","sourceRoot":"","sources":["../../src/elements/ListTabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAoB,MAAM,sBAAsB,CAAA;AAGhE;;;;mEAImE;AACnE,MAAM,OAAO,QAAS,SAAQ,OAAO;IACnC,gBAAwB,KAAK,EAAE,CAAA,CAAC,CAAC;IAEjC,MAAM,CAAC,IAAI;QACT,OAAO,IAAI,QAAQ,EAAE,CAAA;IACvB,CAAC;IAED;0CACsC;IACtC,IAAI,CAAC,IAAe;QAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAEQ,OAAO,KAAa,OAAO,UAAU,CAAA,CAAC,CAAC;IAEvC,MAAM;QACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;IAC7B,CAAC;CACF"}