@pilotiq/pilotiq 0.1.0

package/dist/actions/exportFactory.js

@@ -0,0 +1,144 @@
+/**
+ * Internals for the `Action.export` / `Action.bulkExport` factories.
+ *
+ * Lives in its own module to keep the cycle between `Action.ts` and
+ * `Table.ts` honest — `Action.export` calls into here via dynamic
+ * import inside the handler, so module-eval order never reads either
+ * side's exports too early.
+ */
+import { Table } from '../elements/Table.js';
+import { encodeCsv } from '../io/csv.js';
+import { parseTableQuery } from '../elements/dispatchTable.js';
+const DEFAULT_MAX_ROWS = 50_000;
+const DEFAULT_CHUNK = 1_000;
+/**
+ * Resolve the column spec into a uniform `{ key, label, format? }[]`,
+ * defaulting to every `Column` child on `R.table(Table.make())` when
+ * the spec is omitted.
+ */
+export function resolveExportColumns(spec, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+R) {
+    if (spec && spec.length > 0) {
+        return spec.map(s => typeof s === 'string'
+            ? { key: s, label: s }
+            : { key: s.key, label: s.label ?? s.key, ...(s.format ? { format: s.format } : {}) });
+    }
+    const tableInst = R.table?.(Table.make());
+    if (!tableInst)
+        return [];
+    const cols = tableInst.getColumns?.() ?? [];
+    return cols.map(c => ({ key: c.name, label: c.getLabel?.() ?? c.name }));
+}
+/**
+ * Read the URL query record off `ctx.request`. Routes pass a Hono-like
+ * request object whose `.query` is a `Record<string, string>`. Fall
+ * back to `{}` when missing (programmatic dispatches in tests).
+ */
+export function readRequestQuery(ctx) {
+    const req = ctx.request;
+    const q = req?.query;
+    if (q && typeof q === 'object')
+        return q;
+    return {};
+}
+/**
+ * Drive the table's `records()` handler in pages until we run out of
+ * rows or hit `maxRows`. Returns the collected raw records (not yet
+ * mapped to row objects).
+ *
+ * Scope behavior:
+ *  - `'all'`:      empty TableContext (no filters/search/sort applied)
+ *  - `'filtered'`: TableContext built from the URL query (filters /
+ *                  search / sort all flow through)
+ *  - `'page'`:     same as `'filtered'` but only the visible page
+ */
+export async function collectExportRows(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+table, ctx, scope = 'filtered', maxRows = DEFAULT_MAX_ROWS, chunkSize = DEFAULT_CHUNK) {
+    const handler = table.getRecords?.();
+    if (!handler) {
+        throw new Error('Resource table has no records() handler — cannot export. Set R.model or Table.records(fn).');
+    }
+    const baseCtx = scope === 'all' ? {} : buildTableCtxFromQuery(readRequestQuery(ctx), table);
+    const collected = [];
+    let page = scope === 'page' ? (baseCtx.page ?? 1) : 1;
+    const effectivePerPage = scope === 'page' ? (baseCtx.perPage ?? chunkSize) : chunkSize;
+    while (collected.length <= maxRows) {
+        const result = await handler({ ...baseCtx, page, perPage: effectivePerPage });
+        const rows = Array.isArray(result) ? result : (result?.rows ?? []);
+        collected.push(...rows);
+        if (rows.length < effectivePerPage)
+            break;
+        if (scope === 'page')
+            break;
+        page++;
+    }
+    return collected;
+}
+/**
+ * Build a `TableContext` from a URL-query record by reusing the same
+ * parsing the list page does. Filters mirror onto the table's Filter
+ * children so any `Filter.query()` overrides see them on subsequent
+ * runs (defensive — `loadTableRecords` does the same).
+ */
+function buildTableCtxFromQuery(query, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+table) {
+    const { search, sort, page, perPage } = parseTableQuery(query);
+    const tableFilters = table.getFilters?.() ?? [];
+    const filterValues = {};
+    const reserved = new Set(['search', 'sort', 'page', 'perPage', 'group']);
+    for (const f of tableFilters) {
+        const name = f.name;
+        if (reserved.has(name))
+            continue;
+        const v = query[name];
+        if (typeof v === 'string' && v !== '')
+            filterValues[name] = v;
+    }
+    for (const f of tableFilters) {
+        const v = filterValues[f.name];
+        if (v !== undefined && typeof f.withValue === 'function')
+            f.withValue(v);
+    }
+    const out = {};
+    if (search !== undefined)
+        out.search = search;
+    if (sort !== undefined)
+        out.sort = sort;
+    if (Object.keys(filterValues).length > 0)
+        out.filters = filterValues;
+    if (page !== undefined)
+        out.page = page;
+    if (perPage !== undefined)
+        out.perPage = perPage;
+    return out;
+}
+/** Build a single CSV/JSON-shaped row by reading each resolved column's
+ *  key off the record (with `format` applied when set). */
+export function buildExportRow(record, cols) {
+    const r = record;
+    const out = {};
+    for (const col of cols) {
+        const raw = r[col.key];
+        out[col.key] = col.format ? col.format(raw, r) : raw;
+    }
+    return out;
+}
+/** Encode `rows` as the requested format. Object values that survive
+ *  to here go through the CSV escape rules / `JSON.stringify`. */
+export function encodeExport(rows, cols, format) {
+    if (format === 'json') {
+        return { body: JSON.stringify(rows, null, 2), contentType: 'application/json' };
+    }
+    const csvCols = cols.map(c => ({ key: c.key, label: c.label }));
+    return { body: encodeCsv(rows, csvCols), contentType: 'text/csv; charset=utf-8' };
+}
+/** Default filename: `${slug}-${YYYY-MM-DD}.${ext}`. */
+export function defaultExportFilename(slug, format) {
+    const date = new Date().toISOString().slice(0, 10);
+    const ext = format === 'json' ? 'json' : 'csv';
+    return `${slug}-${date}.${ext}`;
+}
+//# sourceMappingURL=exportFactory.js.map

package/dist/actions/exportFactory.js.map

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

package/dist/actions/importFactory.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Internals for the `Action.import` factory. Lives in its own module
+ * to keep the cycle between `Action.ts` and the field types (Select /
+ * FileUpload) honest — `Action.import` calls in here via dynamic import
+ * inside the handler.
+ */
+import type { ActionContext } from './Action.js';
+import type { Element } from '../schema/Element.js';
+export type ImportFormat = 'csv' | 'json';
+export interface ImportSummary {
+    created: number;
+    updated: number;
+    skipped: number;
+    /** Per-row failure messages (non-empty `validate` returns + thrown
+     *  errors during create / update). 1-indexed for human-friendly
+     *  display in the success notification. */
+    errors: Array<{
+        row: number;
+        message: string;
+    }>;
+}
+export interface ImportContext extends ActionContext {
+    rowIndex?: number;
+}
+export interface ImportOptions {
+    /** CSV / JSON header → model attribute key. Default: identity (the
+     *  CSV header IS the model attribute). For JSON, this remaps the
+     *  parsed object keys 1:1. */
+    columns?: Record<string, string>;
+    /** Output format. Default `'csv'`. JSON-format imports parse the
+     *  uploaded file as `JSON.parse(text)`; arrays import as-is, single
+     *  objects wrap into `[obj]`. */
+    format?: ImportFormat;
+    /** Model attribute used as the upsert key. When set, the importer
+     *  looks up an existing record by `M.query().where(upsertBy, row[upsertBy])`
+     *  before deciding create vs update. When omitted, every row is a
+     *  create. */
+    upsertBy?: string;
+    /** Per-row guard. Return a string to skip the row + accumulate as a
+     *  failure; return `null` (or `undefined`) to allow the row through.
+     *  Async-aware. */
+    validate?: (row: Record<string, unknown>, ctx: ImportContext) => string | null | undefined | Promise<string | null | undefined>;
+    /** Mutate the row payload before `M.create`. Async-aware. */
+    beforeCreate?: (row: Record<string, unknown>, ctx: ImportContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /** Mutate the row payload before `M.update`. Receives the existing
+     *  record so the hook can copy / preserve fields the import shouldn't
+     *  overwrite. Async-aware. */
+    beforeUpdate?: (row: Record<string, unknown>, existing: unknown, ctx: ImportContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /** Hard cap on the row count. Aborts with an error notification when
+     *  exceeded — protects against accidental million-row uploads. Default
+     *  `10_000`. */
+    maxRows?: number;
+    /** Final hook after the import loop. Useful for audit-log writes,
+     *  cache invalidation, etc. Async-aware. */
+    onComplete?: (summary: ImportSummary, ctx: ImportContext) => void | Promise<void>;
+}
+/**
+ * Parse an uploaded file's text into an array of row objects keyed by
+ * model attribute (after applying `opts.columns` remap for CSV).
+ *
+ * Throws on invalid CSV / JSON; the caller's outer `try` surfaces the
+ * error message via the result notification.
+ */
+export declare function parseImportText(text: string, format: ImportFormat, columns?: Record<string, string>): Array<Record<string, unknown>>;
+/**
+ * Run the per-row import loop. Pulled out of the factory body so the
+ * factory stays at the level of "compose modal + handler" instead of
+ * "do the work".
+ *
+ * Returns the aggregated summary (counts + per-row error messages).
+ * Failures don't roll back — partial-success is the contract. The
+ * caller surfaces the summary via a notification.
+ */
+export declare function runImport(rows: Array<Record<string, unknown>>, M: any, mode: 'create' | 'upsert', opts: ImportOptions, ctx: ImportContext): Promise<ImportSummary>;
+/** Build the modal-form schema for an import action. v1 ships:
+ *
+ *  - `FileUpload.make('file')` — required, capped at 10 MB, accepts
+ *    `.csv,.json` by default; users can override the field via the
+ *    `Action.schema([...])` chain.
+ *  - When `upsertBy` is set, a `Select.make('mode')` toggles between
+ *    "Create only" and "Create or update" with `'upsert'` as the
+ *    default selection.
+ *
+ *  Returns an `Element[]` the factory drops into `Action.schema(...)`
+ *  to drive the auto-built modal form. */
+export declare function buildImportSchema(opts: ImportOptions): Element[];
+/** Build a one-line success / warning notification body for the
+ *  import summary — surfaces the first 5 row failures inline so users
+ *  see what went wrong without hunting through logs. */
+export declare function buildImportNotification(summary: ImportSummary, opts: {
+    upsert: boolean;
+}): {
+    type: 'success' | 'warning' | 'error';
+    title: string;
+    body?: string;
+};
+//# sourceMappingURL=importFactory.d.ts.map

package/dist/actions/importFactory.d.ts.map

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

package/dist/actions/importFactory.js

@@ -0,0 +1,143 @@
+/**
+ * Internals for the `Action.import` factory. Lives in its own module
+ * to keep the cycle between `Action.ts` and the field types (Select /
+ * FileUpload) honest — `Action.import` calls in here via dynamic import
+ * inside the handler.
+ */
+import { parseCsv } from '../io/csv.js';
+import { FileUpload } from '../fields/FileUploadField.js';
+import { SelectField } from '../fields/SelectField.js';
+/**
+ * Parse an uploaded file's text into an array of row objects keyed by
+ * model attribute (after applying `opts.columns` remap for CSV).
+ *
+ * Throws on invalid CSV / JSON; the caller's outer `try` surfaces the
+ * error message via the result notification.
+ */
+export function parseImportText(text, format, columns) {
+    if (format === 'json') {
+        const parsed = JSON.parse(text);
+        if (Array.isArray(parsed))
+            return parsed;
+        if (parsed && typeof parsed === 'object')
+            return [parsed];
+        throw new Error('JSON import expected an array or object');
+    }
+    const csv = parseCsv(text);
+    if (!columns || Object.keys(columns).length === 0) {
+        return csv.rows;
+    }
+    // Remap CSV headers → model keys. CSV cells stay as strings; the ORM
+    // does any final coercion (or the user's `beforeCreate` hook).
+    return csv.rows.map(row => {
+        const out = {};
+        for (const [csvKey, value] of Object.entries(row)) {
+            const modelKey = columns[csvKey] ?? csvKey;
+            out[modelKey] = value;
+        }
+        return out;
+    });
+}
+/**
+ * Run the per-row import loop. Pulled out of the factory body so the
+ * factory stays at the level of "compose modal + handler" instead of
+ * "do the work".
+ *
+ * Returns the aggregated summary (counts + per-row error messages).
+ * Failures don't roll back — partial-success is the contract. The
+ * caller surfaces the summary via a notification.
+ */
+export async function runImport(rows, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+M, mode, opts, ctx) {
+    const summary = { created: 0, updated: 0, skipped: 0, errors: [] };
+    const upsertBy = opts.upsertBy;
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        const rowCtx = { ...ctx, rowIndex: i };
+        try {
+            const guard = await opts.validate?.(row, rowCtx);
+            if (typeof guard === 'string' && guard.length > 0) {
+                summary.skipped++;
+                summary.errors.push({ row: i + 1, message: guard });
+                continue;
+            }
+            if (mode === 'upsert' && upsertBy) {
+                const slice = await M.query().where(upsertBy, row[upsertBy]).paginate(1, 1);
+                const existing = (slice?.data ?? [])[0];
+                if (existing) {
+                    const id = String(existing.id ?? '');
+                    const payload = opts.beforeUpdate
+                        ? await opts.beforeUpdate(row, existing, rowCtx)
+                        : row;
+                    await M.update(id, payload);
+                    summary.updated++;
+                    continue;
+                }
+            }
+            const payload = opts.beforeCreate
+                ? await opts.beforeCreate(row, rowCtx)
+                : row;
+            await M.create(payload);
+            summary.created++;
+        }
+        catch (err) {
+            summary.skipped++;
+            summary.errors.push({ row: i + 1, message: err instanceof Error ? err.message : 'unknown' });
+        }
+    }
+    await opts.onComplete?.(summary, ctx);
+    return summary;
+}
+/** Build the modal-form schema for an import action. v1 ships:
+ *
+ *  - `FileUpload.make('file')` — required, capped at 10 MB, accepts
+ *    `.csv,.json` by default; users can override the field via the
+ *    `Action.schema([...])` chain.
+ *  - When `upsertBy` is set, a `Select.make('mode')` toggles between
+ *    "Create only" and "Create or update" with `'upsert'` as the
+ *    default selection.
+ *
+ *  Returns an `Element[]` the factory drops into `Action.schema(...)`
+ *  to drive the auto-built modal form. */
+export function buildImportSchema(opts) {
+    const elements = [];
+    const file = FileUpload.make('file')
+        .label('File')
+        .accept(['.csv', '.json', 'text/csv', 'application/json'])
+        .maxSize(10_000_000)
+        .required();
+    elements.push(file);
+    if (typeof opts.upsertBy === 'string' && opts.upsertBy.length > 0) {
+        const mode = SelectField.make('mode')
+            .label('Mode')
+            .options([
+            { value: 'create', label: 'Create only' },
+            { value: 'upsert', label: 'Create or update' },
+        ])
+            .default('upsert');
+        elements.push(mode);
+    }
+    return elements;
+}
+/** Build a one-line success / warning notification body for the
+ *  import summary — surfaces the first 5 row failures inline so users
+ *  see what went wrong without hunting through logs. */
+export function buildImportNotification(summary, opts) {
+    const total = summary.created + summary.updated + summary.skipped;
+    if (total === 0) {
+        return { type: 'warning', title: 'Import complete — no rows processed' };
+    }
+    const parts = [`${summary.created} created`];
+    if (opts.upsert)
+        parts.push(`${summary.updated} updated`);
+    if (summary.skipped > 0)
+        parts.push(`${summary.skipped} skipped`);
+    const title = `Import complete — ${parts.join(', ')}`;
+    const type = summary.errors.length > 0 ? 'warning' : 'success';
+    if (summary.errors.length === 0)
+        return { type, title };
+    const body = summary.errors.slice(0, 5).map(e => `Row ${e.row}: ${e.message}`).join('\n');
+    return { type, title, body };
+}
+//# sourceMappingURL=importFactory.js.map

package/dist/actions/importFactory.js.map

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

package/dist/actions/index.d.ts

@@ -0,0 +1,3 @@
+export { Action, type ActionPlacement, type ActionContext, type ActionHandler, type ActionConfirm, type ActionMeta, type ActionColor, type ActionSize, type ActionVisibilityContext, type VisibilityRule, } from './Action.js';
+export { ActionGroup, type ActionGroupMeta, } from './ActionGroup.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAA"}

package/dist/actions/index.js

@@ -0,0 +1,3 @@
+export { Action, } from './Action.js';
+export { ActionGroup, } from './ActionGroup.js';
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,GAUP,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,WAAW,GAEZ,MAAM,kBAAkB,CAAA"}

package/dist/applyPageHooks.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Splice resolved render-hook metas into a resolved page schema at the
+ * role-specific positions Filament's docs document. The Day 2 half of
+ * `docs/plans/render-hooks.md` — Day 1 wired the chrome / panelInfo
+ * subset; this file covers the page-role slots.
+ *
+ * Operates at the **meta level** — call after `resolveSchema()` has run
+ * over the page's `Element[]`. The hook fns themselves were resolved
+ * server-side via `resolvePageHooks()` (which does its own fail-closed
+ * + scope filtering); this helper just inserts the resulting metas at
+ * the right positions in the tree.
+ *
+ * Splicing is **top-level only** — Tables / Forms nested inside a
+ * Group / Section won't receive the table.before / form.before hooks.
+ * Acceptable for v1 (the typical resource page has the Table or Form
+ * at the top of its schema).
+ */
+import type { ElementMeta } from './schema/Element.js';
+import type { RenderHookMap, RenderHookName } from './RenderHook.js';
+/**
+ * Page role used to pick which slot positions apply. Mirrors the
+ * per-builder data fn that owns the role.
+ */
+export type PageRole = 'dashboard' | 'list' | 'create' | 'edit' | 'view' | 'global-edit' | 'global-view' | 'page' | 'relation-list' | 'relation-create' | 'relation-view' | 'relation-edit' | 'search';
+/**
+ * Slot names a builder needs to resolve for its role. Returned in a
+ * stable order so the builder can pass straight to `resolvePageHooks()`.
+ */
+export declare function pageHooksFor(role: PageRole): readonly RenderHookName[];
+/**
+ * Splice a `RenderHookMap` into a resolved page schema at the
+ * role-specific positions. Returns a new `ElementMeta[]`; the input
+ * isn't mutated.
+ *
+ * Position semantics:
+ *   - `panels::page.start` / `panels::page.end` — top / bottom of the
+ *     returned array (wraps every other slot).
+ *   - `list-records.table.before` / `.after` — immediately around the
+ *     first top-level `'table'` meta. Inserted into the page array as
+ *     siblings of the Table.
+ *   - `list-records.tabs.end` — appended into the first top-level
+ *     `'listTabs'` meta's `children` array.
+ *   - `create-record.form.before` / `.after` and
+ *     `edit-record.form.before` / `.after` — around the first
+ *     top-level `'form'` meta.
+ *   - `view-record.start` / `.end` — wraps the entire page schema
+ *     (same as `page.start` / `page.end` but inside the universal
+ *     bounds — view-record start fires AFTER `page.start` and view-record
+ *     end fires BEFORE `page.end`).
+ *   - `global-search.results.before` / `.after` — wraps the entire
+ *     page schema (search has no canonical inner anchor in v1).
+ */
+export declare function applyPageHooks(schemaData: readonly ElementMeta[], hooks: RenderHookMap | undefined, role: PageRole): ElementMeta[];
+//# sourceMappingURL=applyPageHooks.d.ts.map

package/dist/applyPageHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPageHooks.d.ts","sourceRoot":"","sources":["../src/applyPageHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,aAAa,GACb,aAAa,GACb,MAAM,GACN,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,QAAQ,CAAA;AAQZ;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,cAAc,EAAE,CAoCtE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,WAAW,EAAE,EAClC,KAAK,EAAO,aAAa,GAAG,SAAS,EACrC,IAAI,EAAQ,QAAQ,GACnB,WAAW,EAAE,CA+Df"}

package/dist/applyPageHooks.js

@@ -0,0 +1,149 @@
+/** Universal slots available on every page role. */
+const PAGE_BOUNDS = [
+    'panels::page.start',
+    'panels::page.end',
+];
+/**
+ * Slot names a builder needs to resolve for its role. Returned in a
+ * stable order so the builder can pass straight to `resolvePageHooks()`.
+ */
+export function pageHooksFor(role) {
+    switch (role) {
+        case 'list':
+            return [
+                ...PAGE_BOUNDS,
+                'panels::resource.pages.list-records.table.before',
+                'panels::resource.pages.list-records.table.after',
+                'panels::resource.pages.list-records.tabs.end',
+            ];
+        case 'create':
+            return [
+                ...PAGE_BOUNDS,
+                'panels::resource.pages.create-record.form.before',
+                'panels::resource.pages.create-record.form.after',
+            ];
+        case 'edit':
+            return [
+                ...PAGE_BOUNDS,
+                'panels::resource.pages.edit-record.form.before',
+                'panels::resource.pages.edit-record.form.after',
+            ];
+        case 'view':
+            return [
+                ...PAGE_BOUNDS,
+                'panels::resource.pages.view-record.start',
+                'panels::resource.pages.view-record.end',
+            ];
+        case 'search':
+            return [
+                ...PAGE_BOUNDS,
+                'panels::global-search.results.before',
+                'panels::global-search.results.after',
+            ];
+        default:
+            return PAGE_BOUNDS;
+    }
+}
+/**
+ * Splice a `RenderHookMap` into a resolved page schema at the
+ * role-specific positions. Returns a new `ElementMeta[]`; the input
+ * isn't mutated.
+ *
+ * Position semantics:
+ *   - `panels::page.start` / `panels::page.end` — top / bottom of the
+ *     returned array (wraps every other slot).
+ *   - `list-records.table.before` / `.after` — immediately around the
+ *     first top-level `'table'` meta. Inserted into the page array as
+ *     siblings of the Table.
+ *   - `list-records.tabs.end` — appended into the first top-level
+ *     `'listTabs'` meta's `children` array.
+ *   - `create-record.form.before` / `.after` and
+ *     `edit-record.form.before` / `.after` — around the first
+ *     top-level `'form'` meta.
+ *   - `view-record.start` / `.end` — wraps the entire page schema
+ *     (same as `page.start` / `page.end` but inside the universal
+ *     bounds — view-record start fires AFTER `page.start` and view-record
+ *     end fires BEFORE `page.end`).
+ *   - `global-search.results.before` / `.after` — wraps the entire
+ *     page schema (search has no canonical inner anchor in v1).
+ */
+export function applyPageHooks(schemaData, hooks, role) {
+    if (!hooks || Object.keys(hooks).length === 0)
+        return [...schemaData];
+    let result = [...schemaData];
+    // Role-specific anchor splices — run BEFORE the universal page.start/end
+    // wrap so the wrapping happens around them.
+    if (role === 'list') {
+        result = spliceAroundType(result, 'table', hooks['panels::resource.pages.list-records.table.before'], hooks['panels::resource.pages.list-records.table.after']);
+        result = appendIntoChildrenOfType(result, 'listTabs', hooks['panels::resource.pages.list-records.tabs.end']);
+    }
+    if (role === 'create') {
+        result = spliceAroundType(result, 'form', hooks['panels::resource.pages.create-record.form.before'], hooks['panels::resource.pages.create-record.form.after']);
+    }
+    if (role === 'edit') {
+        result = spliceAroundType(result, 'form', hooks['panels::resource.pages.edit-record.form.before'], hooks['panels::resource.pages.edit-record.form.after']);
+    }
+    if (role === 'view') {
+        result = wrap(result, hooks['panels::resource.pages.view-record.start'], hooks['panels::resource.pages.view-record.end']);
+    }
+    if (role === 'search') {
+        result = wrap(result, hooks['panels::global-search.results.before'], hooks['panels::global-search.results.after']);
+    }
+    // Universal page.start / page.end wrap everything else.
+    result = wrap(result, hooks['panels::page.start'], hooks['panels::page.end']);
+    return result;
+}
+/** Insert `before`/`after` immediately around the first top-level meta
+ *  whose `type` matches. No-op when neither slot has content; no-op
+ *  when the type isn't found (the slot's content is dropped — better
+ *  than a confusing trailing splice). */
+function spliceAroundType(metas, type, before, after) {
+    if ((!before || before.length === 0) && (!after || after.length === 0)) {
+        return metas;
+    }
+    const result = [];
+    let inserted = false;
+    for (const m of metas) {
+        if (!inserted && m.type === type) {
+            if (before && before.length > 0)
+                result.push(...before);
+            result.push(m);
+            if (after && after.length > 0)
+                result.push(...after);
+            inserted = true;
+        }
+        else {
+            result.push(m);
+        }
+    }
+    return result;
+}
+/** Append `toAppend` into the first top-level meta whose `type`
+ *  matches, on its `children` array. No-op when the type isn't found. */
+function appendIntoChildrenOfType(metas, type, toAppend) {
+    if (!toAppend || toAppend.length === 0)
+        return metas;
+    let mutated = false;
+    return metas.map(m => {
+        if (!mutated && m.type === type) {
+            mutated = true;
+            return { ...m, children: [...(m.children ?? []), ...toAppend] };
+        }
+        return m;
+    });
+}
+/** Concat `before`/`after` around the array. Cheap shorthand; spreads
+ *  empty / undefined slots without touching the original array's
+ *  identity when both are absent. */
+function wrap(metas, before, after) {
+    const hasBefore = before && before.length > 0;
+    const hasAfter = after && after.length > 0;
+    if (!hasBefore && !hasAfter)
+        return metas;
+    return [
+        ...(hasBefore ? before : []),
+        ...metas,
+        ...(hasAfter ? after : []),
+    ];
+}
+//# sourceMappingURL=applyPageHooks.js.map

package/dist/applyPageHooks.js.map

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