@pilotiq/pilotiq 0.1.0

package/dist/RelationManager.js

@@ -0,0 +1,342 @@
+/**
+ * Map a raw `parentModel.relations[name].type` string to the
+ * `RelationMode` the manager plumbing dispatches on. Centralizes the
+ * fall-through rules so `routes.ts`, `pageData.ts`, and any future
+ * call sites stay in lockstep:
+ *
+ * - `belongsToMany`             → `'belongsToMany'`
+ * - `morphMany | morphOne`      → `'morphMany'`  (one-row morph still
+ *                                 a many-shape; UI surface identical)
+ * - `morphTo`                   → `'morphTo'`
+ * - `morphToMany`               → `'morphToMany'`   (owning polymorphic
+ *                                 M2M side; pivot-mutation shape)
+ * - `morphedByMany`             → `'morphedByMany'` (inverse polymorphic
+ *                                 M2M side; pivot-mutation shape)
+ * - anything else (hasMany /
+ *   hasOne / belongsTo / unset) → `'hasMany'`    (safe default — no
+ *                                 special action injection)
+ */
+export function normalizeRelationMode(relationType) {
+    if (relationType === 'belongsToMany')
+        return 'belongsToMany';
+    if (relationType === 'morphMany' || relationType === 'morphOne')
+        return 'morphMany';
+    if (relationType === 'morphTo')
+        return 'morphTo';
+    if (relationType === 'morphToMany')
+        return 'morphToMany';
+    if (relationType === 'morphedByMany')
+        return 'morphedByMany';
+    return 'hasMany';
+}
+/**
+ * Plan #11 — RelationManager abstract base class.
+ *
+ * A RelationManager is a parent-scoped projection of a related resource:
+ * given a parent record (e.g. a User) and a relationship key (e.g.
+ * `'posts'`), it renders an embedded table of the related records on
+ * the parent's Edit/View page, with create/edit/delete actions routed
+ * under `${base}/${parentSlug}/:id/${relationship}`.
+ *
+ * Like `Resource`, **all methods are static** — managers are registered
+ * by class via `Resource.relations()`, never instantiated. They mirror
+ * the `Resource` static shape minus URL ownership: a manager has no
+ * `slug` (the relationship name doubles as the URL segment) and no
+ * `pages()` override (the list/create/edit pattern is fixed).
+ *
+ * Authorization runs in two layers per route:
+ * 1. The parent's `R.canEdit(user, parentRecord)` — gates access to
+ *    *any* manager view under that record. ("Can you edit the user?
+ *    Then you can manage their relations.")
+ * 2. The manager's own `M.canViewAny / canView / canCreate / canEdit
+ *    / canDelete` — gates the specific action. Defaults all return
+ *    `true`; the page-data builder additionally defers to the related
+ *    Resource's policy when a Resource is registered for the same
+ *    `M.relationship` model and the manager hasn't overridden the
+ *    predicate.
+ *
+ * Scope (Plan #11): `hasOne`, `hasMany`, `belongsTo` (matches what
+ * `@rudderjs/orm` supports today). `belongsToMany` shipped 2026-05-03
+ * via the M2M follow-up. `morphMany` / `morphOne` / `morphTo` shipped
+ * via the polymorphic follow-up — `morphMany` auto-injects morph
+ * columns on create, `morphTo` requires `static relatedResource` (no
+ * single related model to discover). `morphToMany` (owning side) and
+ * `morphedByMany` (inverse side) shipped 2026-05-04 via the polymorphic
+ * M2M follow-up — both share the `belongsToMany` pivot-mutation shape
+ * (`attach` / `detach` / `sync`); the ORM stamps + filters the
+ * polymorphic discriminator on the shared pivot table automatically.
+ */
+export class RelationManager {
+    /**
+     * Required. The key on the parent's `static relations` map (rudder
+     * ORM convention) that points at the related model. Doubles as the
+     * URL segment under the parent record:
+     * `${base}/${parentSlug}/:id/${relationship}`.
+     *
+     * Reserved tokens that cannot be used: `edit`, `delete`, `_form`,
+     * `_action`, `_search`. Validated at panel boot.
+     */
+    static relationship = '';
+    /** Human-readable plural label for the manager's tab. Falls through
+     * to the related resource's `label`, then to a sentence-cased
+     * relationship name (`'posts' → 'Posts'`). */
+    static label;
+    /** Singular label, e.g. `'Post'`. Falls through to the related
+     * resource's `labelSingular`. */
+    static labelSingular;
+    /** Tab icon. Falls through to the related resource's `icon`. */
+    static icon;
+    /** Attribute used to title each row in the manager's table when no
+     * explicit override is supplied. Falls through to the related
+     * resource's `recordTitleAttribute`, then to the same fallback chain
+     * the resource uses (`name → title → id`). */
+    static recordTitleAttribute;
+    /**
+     * Explicit pointer to the related resource class. Optional — when
+     * unset, pilotiq discovers the related resource via the rudder ORM
+     * convention (`parentModel.relations[relationship].model()` matched
+     * against `cfg.resources[i].model`). Override here when:
+     *   - the parent's ORM doesn't follow the rudder relations convention
+     *   - multiple resources share the same model (e.g. `BlogPostResource`
+     *     and `DraftResource` both backed by `Post`) and auto-discovery
+     *     would be ambiguous
+     *   - the manager projects onto a model that's not registered as a
+     *     standalone Resource (rare — usually you'd just register one)
+     */
+    static relatedResource;
+    /**
+     * Configure the form used by the manager's create + edit pages.
+     * Receives a fresh `Form` instance; return the configured form.
+     * Mirrors `Resource.form(form)`. Lifecycle hooks
+     * (mutateDataBeforeCreate, beforeSave, afterSave, etc.) are set on
+     * the returned `Form` via its builder methods — the page-data
+     * builder stamps the parent context onto the `FormContext` before
+     * invoking dispatch, so user hooks can read `ctx.parent`,
+     * `ctx.parentRecord`, and `ctx.relationship`.
+     *
+     * `ctx` carries the live basePath / parentId / relationship so user
+     * code can template URLs (rare on a form, but symmetric with
+     * `table()`). Overrides may omit it: `static override form(form)
+     * { … }` is legal because TypeScript permits dropping trailing
+     * parameters on overrides.
+     */
+    static form(form, _ctx) { return form; }
+    /**
+     * Configure the table used by the manager's list page. Receives a
+     * fresh `Table` instance; return the configured table. Mirrors
+     * `Resource.table(table)`. The page-data builder auto-wires
+     * `Table.records()` against `parent.related(relationship)` when the
+     * parent's `ModelLike` is set and the table has no explicit
+     * `records()` handler.
+     *
+     * `ctx` carries the live basePath / parentSlug / parentId /
+     * relationship / parentRecord — wire `Action.relationCreate /
+     * relationEdit / relationDelete(M, ctx)` factories into
+     * `headerActions` / `recordActions` to template URLs to the
+     * manager's own create / edit / delete routes. The framework
+     * always passes ctx; overrides that don't need it can drop the
+     * parameter.
+     */
+    static table(table, _ctx) { return table; }
+    /**
+     * Schema for the read-only view page of a child record under this
+     * manager (future surface — Plan #11 doesn't ship a per-child
+     * ViewPage; clicking into a row navigates to the related Resource's
+     * own view URL by default). Override `Table.recordUrl(fn)` on the
+     * manager table to change navigation.
+     */
+    static detail(_record, _parentRecord) { return []; }
+    /**
+     * Phase B nested resources — declare RelationManagers that ride the
+     * URL space *under* this manager's per-child view page:
+     *
+     * ```
+     * /posts/123/comments/456/replies          ← list
+     * /posts/123/comments/456/replies/create   ← create
+     * /posts/123/comments/456/replies/789      ← view
+     * /posts/123/comments/456/replies/789/edit ← edit
+     * ```
+     *
+     * Defaults to `[]`. Subclasses opt in by overriding:
+     *
+     * ```ts
+     * class PostsCommentsManager extends RelationManager {
+     *   static relationship = 'comments'
+     *   static override relations() { return [CommentRepliesManager] }
+     * }
+     * ```
+     *
+     * Auth runs in three layers per nested route: the parent Resource's
+     * `canAccess + canEdit`, this manager's `canView(child, parent)` (the
+     * gate to drill *into* a child), and the leaf manager's `canX(...)`
+     * for the specific scope. Full-chain IDOR is enforced layer-by-layer
+     * in `pageData.relationManagerData`.
+     *
+     * Phase B caps depth at 2; declaring `relations()` on a manager whose
+     * own chain is already 2 deep is rejected at panel boot. Depth-3+ is
+     * Phase D and likely a no-op (Filament stops at 2).
+     */
+    static relations() { return []; }
+    // ─── Authorization predicates ─────────────────────────────────
+    // All async, all default `true`. The page-data builder calls the
+    // parent's `R.canEdit(user, parentRecord)` first as an access gate;
+    // the manager's predicates here scope the individual action.
+    // Override per-manager when the policy needs to differ from the
+    // related resource's defaults.
+    /** Allowed to list the related records under this parent. */
+    static async canViewAny(_user, _parentRecord) { return true; }
+    /** Allowed to view a single related record (read-only). Currently
+     * unused by Plan #11 routes — reserved for the future per-child
+     * ViewPage. */
+    static async canView(_user, _record, _parentRecord) { return true; }
+    /** Allowed to access the create page + invoke the create form. */
+    static async canCreate(_user, _parentRecord) { return true; }
+    /** Allowed to edit a related record. */
+    static async canEdit(_user, _record, _parentRecord) { return true; }
+    /** Allowed to delete a related record. */
+    static async canDelete(_user, _record, _parentRecord) { return true; }
+    /** Plan #13 — allowed to restore a soft-deleted related record. Defaults
+     *  to `true`; override per-manager when restoration policy needs to
+     *  differ from the related Resource's. Only consulted when the related
+     *  Resource has `softDeletes = true`. */
+    static async canRestore(_user, _record, _parentRecord) { return true; }
+    /** Plan #13 — allowed to permanently force-delete a related record.
+     *  Inherits from `canDelete` by default (delegating via `this.canDelete`)
+     *  for fail-closed inheritance: a manager that locks down `canDelete`
+     *  also locks down force-delete unless explicitly relaxed. */
+    static async canForceDelete(user, record, parentRecord) {
+        return this.canDelete(user, record, parentRecord);
+    }
+    /** M2M follow-up — allowed to attach an existing related record to the
+     *  parent (insert a pivot row). Default `true`. No fall-through to the
+     *  related Resource: attaching is a pivot operation, not a record
+     *  creation, so `Resource.canCreate` is the wrong gate. */
+    static async canAttach(_user, _parentRecord) { return true; }
+    /** M2M follow-up — allowed to detach a related record from the parent
+     *  (delete a pivot row, target record stays). Default `true`. No
+     *  fall-through to the related Resource: detaching ≠ deleting. */
+    static async canDetach(_user, _record, _parentRecord) { return true; }
+    // ─── Accessors ────────────────────────────────────────────────
+    /**
+     * Read the relationship key. Throws when the subclass forgot to set
+     * it — better than a confusing 404 at runtime.
+     */
+    static getRelationship() {
+        if (!this.relationship) {
+            throw new Error(`[Pilotiq] ${this.name}: static relationship must be set on a RelationManager subclass.`);
+        }
+        return this.relationship;
+    }
+    /** Tab label, falling back to a sentence-cased relationship name. */
+    static getLabel() {
+        return this.label ?? sentenceCase(this.getRelationship());
+    }
+    /** Singular label, falling back to a single-cased relationship name. */
+    static getLabelSingular() {
+        return this.labelSingular ?? sentenceCase(singularize(this.getRelationship()));
+    }
+    /** Tab icon. Returns the configured icon or `undefined` (renderer
+     * skips the icon slot when absent). */
+    static getIcon() { return this.icon; }
+    /** Record-title attribute, undefined when nothing's been configured
+     * (callers fall back through name/title/id). */
+    static getRecordTitleAttribute() {
+        return this.recordTitleAttribute;
+    }
+}
+/** Reserved URL tokens that a manager's `relationship` cannot collide
+ * with. Validated at panel boot in `PilotiqRegistry.register`. The
+ * soft-delete tokens (`restore`, `force-delete`) entered the set with
+ * Plan #13's relation-manager polish — they're sibling paths to a
+ * resource's `:id/restore` route. The M2M follow-up adds `_attach /
+ * _detach / _bulk-detach` for pivot-row mutations — these need to be
+ * reserved even though they live one segment deeper than the
+ * relationship name (they could otherwise alias a child record id of,
+ * say, `_attach` slipping through the IDOR check). */
+export const RESERVED_RELATIONSHIP_TOKENS = new Set([
+    'edit', 'delete', 'restore', 'force-delete',
+    '_form', '_action', '_search', '_uploads',
+    '_attach', '_detach', '_bulk-detach',
+]);
+/** True when the subclass replaces the inherited base implementation.
+ * Class statics are inherited via the constructor prototype chain, so
+ * an un-overridden subclass returns `RelationManager`'s function by
+ * reference. */
+export function isManagerCanOverridden(M, method) {
+    return M[method]
+        !== RelationManager[method];
+}
+/**
+ * Authorize a manager-scoped action with sensible defaults.
+ *
+ * - If the manager overrode `method`: run that predicate. The manager
+ *   shape carries `parent` (and, for record-scoped methods, `child`)
+ *   so user code can scope per-parent.
+ * - Otherwise, when a related Resource is registered: fall through to
+ *   the Resource's own `canX`. The Resource side doesn't see `parent`
+ *   — that's the trade-off for inheriting Resource-level rules.
+ * - Otherwise: allow.
+ *
+ * Throws are absorbed as `false` (fail-closed), matching the
+ * resource-side `checkPolicy` convention.
+ */
+export async function safeManagerPolicy(M, method, Related, user, parent, child) {
+    const isRecordScoped = method === 'canView' || method === 'canEdit' || method === 'canDelete'
+        || method === 'canRestore' || method === 'canForceDelete'
+        || method === 'canDetach';
+    // M2M follow-up — `canAttach` and `canDetach` are manager-only:
+    // attach/detach are pivot operations, not record operations, so the
+    // related Resource's canCreate/canDelete are the wrong gates. Skip
+    // the Related fall-through for these two and just run the
+    // (potentially default-true) predicate on the manager.
+    const managerOnly = method === 'canAttach' || method === 'canDetach';
+    try {
+        if (isManagerCanOverridden(M, method) || managerOnly) {
+            // Call via M[method] (not an extracted reference) so predicates
+            // that read `this` — e.g. Resource.canForceDelete delegating to
+            // `this.canDelete` — see the right class.
+            const fn = M[method];
+            const result = isRecordScoped ? fn.call(M, user, child, parent) : fn.call(M, user, parent);
+            return Boolean(await result);
+        }
+        // Plan #13 polish — `canForceDelete` defaults to delegating to
+        // `canDelete` (force is "stricter than delete"). When the manager
+        // has overridden `canDelete` but not `canForceDelete`, mirror the
+        // delegation here so the stricter rule propagates. Without this
+        // step we'd fall straight through to Related which loses the
+        // manager-level canDelete restriction.
+        if (method === 'canForceDelete' && isManagerCanOverridden(M, 'canDelete')) {
+            return safeManagerPolicy(M, 'canDelete', Related, user, parent, child);
+        }
+        if (Related) {
+            const fn = Related[method];
+            if (!fn) {
+                // Same delegation on the Related side: missing canForceDelete
+                // falls back to canDelete.
+                if (method === 'canForceDelete' && Related.canDelete) {
+                    const result = Related.canDelete.call(Related, user, child);
+                    return Boolean(await result);
+                }
+                return true;
+            }
+            // Same `this`-preservation rationale as the manager branch above.
+            const result = isRecordScoped ? fn.call(Related, user, child) : fn.call(Related, user);
+            return Boolean(await result);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sentenceCase(s) {
+    if (s.length === 0)
+        return s;
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/** Naive singularization — strips a trailing `s` when present. Users
+ * who want better can set `labelSingular` explicitly. */
+function singularize(s) {
+    return s.endsWith('s') ? s.slice(0, -1) : s;
+}
+//# sourceMappingURL=RelationManager.js.map

package/dist/RelationManager.js.map

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

package/dist/RenderHook.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Render hooks — named slots scattered through the panel chrome where
+ * apps can inject arbitrary `Element[]` (or async resolvers) without
+ * forking AppShell / layouts / page renderers.
+ *
+ * The closed name union is the v1 contract: extending it requires
+ * editing this file. Deliberate — keeps autocomplete useful and prevents
+ * typos from silently no-op'ing. Loosens to a `string` overload only
+ * when a real consumer needs custom names.
+ *
+ * Scope semantics:
+ *   - No scope → runs at every site of the named slot.
+ *   - With scope → at least one of `scope.resource` / `scope.page` /
+ *     `scope.global` must reference-equal the active route's identifier.
+ *
+ * Plan: docs/plans/render-hooks.md
+ */
+import type { Element, ElementMeta } from './schema/Element.js';
+import type { ResourceClass } from './Resource.js';
+import type { GlobalClass } from './Global.js';
+import type { Page } from './Page.js';
+/**
+ * Closed union of every render-hook slot pilotiq's chrome and page-role
+ * renderers mount. Names ported verbatim from Filament's literal hook
+ * names so user docs / community snippets transfer 1:1.
+ */
+export type RenderHookName = 'panels::head.start' | 'panels::head.end' | 'panels::scripts' | 'panels::styles' | 'panels::body.start' | 'panels::body.end' | 'panels::topbar.start' | 'panels::topbar.end' | 'panels::sidebar.start' | 'panels::sidebar.nav.start' | 'panels::sidebar.nav.end' | 'panels::sidebar.footer' | 'panels::user-menu.before' | 'panels::user-menu.after' | 'panels::footer' | 'panels::page.start' | 'panels::page.end' | 'panels::resource.pages.list-records.table.before' | 'panels::resource.pages.list-records.table.after' | 'panels::resource.pages.list-records.tabs.end' | 'panels::resource.pages.create-record.form.before' | 'panels::resource.pages.create-record.form.after' | 'panels::resource.pages.edit-record.form.before' | 'panels::resource.pages.edit-record.form.after' | 'panels::resource.pages.view-record.start' | 'panels::resource.pages.view-record.end' | 'panels::global-search.results.before' | 'panels::global-search.results.after';
+/**
+ * Chrome slots resolved once per `panelInfo()` call and shipped under
+ * `panel.renderHooks`. Page-role hooks ride on the per-builder
+ * `viewProps.renderHooks` slot to keep `panelInfo()`'s payload from
+ * ballooning when only a list-page hook fires.
+ */
+export declare const CHROME_HOOK_NAMES: readonly ["panels::head.start", "panels::head.end", "panels::scripts", "panels::styles", "panels::body.start", "panels::body.end", "panels::topbar.start", "panels::topbar.end", "panels::sidebar.start", "panels::sidebar.nav.start", "panels::sidebar.nav.end", "panels::sidebar.footer", "panels::user-menu.before", "panels::user-menu.after", "panels::footer"];
+/** Page-role slot names that the per-page-role builders own. */
+export declare const PAGE_HOOK_NAMES: readonly ["panels::page.start", "panels::page.end", "panels::resource.pages.list-records.table.before", "panels::resource.pages.list-records.table.after", "panels::resource.pages.list-records.tabs.end", "panels::resource.pages.create-record.form.before", "panels::resource.pages.create-record.form.after", "panels::resource.pages.edit-record.form.before", "panels::resource.pages.edit-record.form.after", "panels::resource.pages.view-record.start", "panels::resource.pages.view-record.end", "panels::global-search.results.before", "panels::global-search.results.after"];
+/**
+ * Context passed to every render-hook callback. `user` is the resolved
+ * `Pilotiq.user(req => …)` return value (or `null`). `resource` /
+ * `page` / `global` carry whichever class is active for the request, so
+ * a generic chrome hook can branch on the route without registering a
+ * scoped hook for every Resource.
+ */
+export interface RenderHookContext {
+    user: unknown;
+    basePath: string;
+    url: string;
+    resource?: ResourceClass;
+    page?: typeof Page;
+    global?: GlobalClass;
+    recordId?: string;
+}
+/** Hook callback. Returns the elements to mount at the slot. */
+export type RenderHookFn = (ctx: RenderHookContext) => Element[] | Promise<Element[]>;
+/**
+ * Filter the slot to only fire when the active route matches one of the
+ * scope keys (OR within the object). Omit to run everywhere.
+ */
+export interface RenderHookScope {
+    resource?: ResourceClass;
+    page?: typeof Page;
+    global?: GlobalClass;
+}
+/** Internal storage shape — one entry per `Pilotiq.renderHook()` call. */
+export interface RenderHookEntry {
+    name: RenderHookName;
+    fn: RenderHookFn;
+    scope?: RenderHookScope;
+}
+/**
+ * Wire shape shipped to the renderer. Sparse — only names that produced
+ * non-empty content land in the map. The renderer mounts a slot at
+ * every supported position; missing keys render nothing.
+ */
+export type RenderHookMap = Partial<Record<RenderHookName, ElementMeta[]>>;
+/**
+ * Resolve a set of render-hook names against the panel's registered
+ * entries. Returns a sparse map — names with no matching entries are
+ * omitted from the result.
+ *
+ * Throwing hooks fail closed: their slot's contribution drops; other
+ * hooks at the same slot still ship. Same posture as `Resource.canAccess`
+ * and `navigationBadge()`.
+ */
+export declare function resolveRenderHooks(entries: readonly RenderHookEntry[], names: readonly RenderHookName[], ctx: RenderHookContext): Promise<RenderHookMap>;
+//# sourceMappingURL=RenderHook.d.ts.map

package/dist/RenderHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderHook.d.ts","sourceRoot":"","sources":["../src/RenderHook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGrC;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAEtB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAEhB,oBAAoB,GACpB,kBAAkB,GAElB,sBAAsB,GACtB,oBAAoB,GAEpB,uBAAuB,GACvB,2BAA2B,GAC3B,yBAAyB,GACzB,wBAAwB,GAExB,0BAA0B,GAC1B,yBAAyB,GAEzB,gBAAgB,GAEhB,oBAAoB,GACpB,kBAAkB,GAClB,kDAAkD,GAClD,iDAAiD,GACjD,8CAA8C,GAC9C,kDAAkD,GAClD,iDAAiD,GACjD,gDAAgD,GAChD,+CAA+C,GAC/C,0CAA0C,GAC1C,wCAAwC,GACxC,sCAAsC,GACtC,qCAAqC,CAAA;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,sWAgBgB,CAAA;AAE9C,gEAAgE;AAChE,eAAO,MAAM,eAAe,2jBAckB,CAAA;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAO,OAAO,CAAA;IAClB,QAAQ,EAAG,MAAM,CAAA;IACjB,GAAG,EAAQ,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,IAAI,CAAC,EAAM,OAAO,IAAI,CAAA;IACtB,MAAM,CAAC,EAAI,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AAErF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,IAAI,CAAC,EAAM,OAAO,IAAI,CAAA;IACtB,MAAM,CAAC,EAAI,WAAW,CAAA;CACvB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAI,cAAc,CAAA;IACtB,EAAE,EAAM,YAAY,CAAA;IACpB,KAAK,CAAC,EAAE,eAAe,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;AAgB1E;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,aAAa,CAAC,CAgDxB"}

package/dist/RenderHook.js

@@ -0,0 +1,116 @@
+import { resolveSchema } from './schema/resolveSchema.js';
+/**
+ * Chrome slots resolved once per `panelInfo()` call and shipped under
+ * `panel.renderHooks`. Page-role hooks ride on the per-builder
+ * `viewProps.renderHooks` slot to keep `panelInfo()`'s payload from
+ * ballooning when only a list-page hook fires.
+ */
+export const CHROME_HOOK_NAMES = [
+    'panels::head.start',
+    'panels::head.end',
+    'panels::scripts',
+    'panels::styles',
+    'panels::body.start',
+    'panels::body.end',
+    'panels::topbar.start',
+    'panels::topbar.end',
+    'panels::sidebar.start',
+    'panels::sidebar.nav.start',
+    'panels::sidebar.nav.end',
+    'panels::sidebar.footer',
+    'panels::user-menu.before',
+    'panels::user-menu.after',
+    'panels::footer',
+];
+/** Page-role slot names that the per-page-role builders own. */
+export const PAGE_HOOK_NAMES = [
+    'panels::page.start',
+    'panels::page.end',
+    'panels::resource.pages.list-records.table.before',
+    'panels::resource.pages.list-records.table.after',
+    'panels::resource.pages.list-records.tabs.end',
+    'panels::resource.pages.create-record.form.before',
+    'panels::resource.pages.create-record.form.after',
+    'panels::resource.pages.edit-record.form.before',
+    'panels::resource.pages.edit-record.form.after',
+    'panels::resource.pages.view-record.start',
+    'panels::resource.pages.view-record.end',
+    'panels::global-search.results.before',
+    'panels::global-search.results.after',
+];
+/**
+ * Decide whether a hook entry should fire for the current context.
+ * Scope is OR'd within the object; an empty / missing scope always
+ * matches.
+ */
+function scopeMatches(entry, ctx) {
+    const scope = entry.scope;
+    if (!scope || (!scope.resource && !scope.page && !scope.global))
+        return true;
+    if (scope.resource && ctx.resource === scope.resource)
+        return true;
+    if (scope.page && ctx.page === scope.page)
+        return true;
+    if (scope.global && ctx.global === scope.global)
+        return true;
+    return false;
+}
+/**
+ * Resolve a set of render-hook names against the panel's registered
+ * entries. Returns a sparse map — names with no matching entries are
+ * omitted from the result.
+ *
+ * Throwing hooks fail closed: their slot's contribution drops; other
+ * hooks at the same slot still ship. Same posture as `Resource.canAccess`
+ * and `navigationBadge()`.
+ */
+export async function resolveRenderHooks(entries, names, ctx) {
+    if (entries.length === 0 || names.length === 0)
+        return {};
+    const wanted = new Set(names);
+    const matching = entries.filter(e => wanted.has(e.name) && scopeMatches(e, ctx));
+    if (matching.length === 0)
+        return {};
+    // Resolve each entry's `fn` in parallel. Errors swallow per-entry —
+    // one flaky hook doesn't blank the page.
+    const resolved = await Promise.all(matching.map(async (entry) => {
+        try {
+            const els = await entry.fn(ctx);
+            return { name: entry.name, els: Array.isArray(els) ? els : [] };
+        }
+        catch (err) {
+            console.warn(`[pilotiq] render hook ${entry.name} threw:`, err);
+            return { name: entry.name, els: [] };
+        }
+    }));
+    // Bucket by name, preserving registration order (matching is in the
+    // order entries were registered; the `filter` above is stable).
+    const buckets = new Map();
+    for (const r of resolved) {
+        if (r.els.length === 0)
+            continue;
+        const cur = buckets.get(r.name);
+        if (cur)
+            cur.push(...r.els);
+        else
+            buckets.set(r.name, [...r.els]);
+    }
+    if (buckets.size === 0)
+        return {};
+    // Walk every bucket through the schema resolver so the wire shape
+    // matches every other Element[] payload — nested visibility, async
+    // toMeta(), etc. all just work. `RenderContext.user` is duck-typed
+    // (`name`/`email`/...); pilotiq treats user as opaque so cast through.
+    const renderCtx = {};
+    if (ctx.user !== null && typeof ctx.user === 'object') {
+        renderCtx.user = ctx.user;
+    }
+    const out = {};
+    await Promise.all([...buckets.entries()].map(async ([name, els]) => {
+        const metas = await resolveSchema(els, renderCtx);
+        if (metas.length > 0)
+            out[name] = metas;
+    }));
+    return out;
+}
+//# sourceMappingURL=RenderHook.js.map

package/dist/RenderHook.js.map

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