@pilotiq/pilotiq 0.4.0 → 0.6.0

package/dist/schema/SlotComponent.d.ts

@@ -0,0 +1,49 @@
+import { Element } from './Element.js';
+/**
+ * Escape-hatch schema element that hands rendering off to a user-supplied
+ * React component registered via `registerSlotComponents()`. Distinct from
+ * `ComponentEntry` (which is record-bound and label-shelled for infolists)
+ * and from `View` (which is widget-shaped with `getData`/polling). Use for
+ * plugin-contributed UI that needs to mount inline at any schema position
+ * — toolbars, header chips, sidebar contributions, anywhere `Action` /
+ * `ActionGroup` would otherwise live.
+ *
+ * Wire shape ships only the registered name + a serialisable `props` bag.
+ * The `_components.ts` build-time manifest doesn't see runtime-registered
+ * components (they live in plugin packages, not `cfg.resources / globals
+ * / pages` statics), so the lookup happens at render via the runtime
+ * registry — same model as `registerEntryComponents` and
+ * `registerWidgetComponents`.
+ *
+ * @example
+ *   // bootstrap/providers.ts
+ *   registerSlotComponents({ BookmarkButton })
+ *
+ *   // A plugin / app contributes the chip into the resource-edit header:
+ *   panel.renderHook(
+ *     'panels::resource.pages.edit-record.header.actions.before',
+ *     (ctx) => [
+ *       SlotComponent.make('BookmarkButton').props({
+ *         basePath: ctx.basePath,
+ *         resourceSlug: ctx.resource?.getSlug(),
+ *         recordId: ctx.recordId,
+ *       }),
+ *     ],
+ *   )
+ */
+export declare class SlotComponent extends Element {
+    protected _componentName: string;
+    protected _props?: Record<string, unknown>;
+    protected constructor(componentName: string);
+    static make(componentName: string): SlotComponent;
+    /**
+     * Static props passed verbatim to the registered component. Must be
+     * JSON-serialisable — they ride through `viewProps` to the client.
+     * Successive calls merge shallowly with the previous bag.
+     */
+    props(props: Record<string, unknown>): this;
+    getComponentName(): string;
+    getType(): string;
+    toMeta(): Record<string, unknown>;
+}
+//# sourceMappingURL=SlotComponent.d.ts.map

package/dist/schema/SlotComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotComponent.d.ts","sourceRoot":"","sources":["../../src/schema/SlotComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAA;IAChC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE1C,SAAS,aAAa,aAAa,EAAE,MAAM;IAK3C,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa;IAIjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3C,gBAAgB,IAAI,MAAM;IAIjB,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3C"}

package/dist/schema/SlotComponent.js

@@ -0,0 +1,65 @@
+import { Element } from './Element.js';
+/**
+ * Escape-hatch schema element that hands rendering off to a user-supplied
+ * React component registered via `registerSlotComponents()`. Distinct from
+ * `ComponentEntry` (which is record-bound and label-shelled for infolists)
+ * and from `View` (which is widget-shaped with `getData`/polling). Use for
+ * plugin-contributed UI that needs to mount inline at any schema position
+ * — toolbars, header chips, sidebar contributions, anywhere `Action` /
+ * `ActionGroup` would otherwise live.
+ *
+ * Wire shape ships only the registered name + a serialisable `props` bag.
+ * The `_components.ts` build-time manifest doesn't see runtime-registered
+ * components (they live in plugin packages, not `cfg.resources / globals
+ * / pages` statics), so the lookup happens at render via the runtime
+ * registry — same model as `registerEntryComponents` and
+ * `registerWidgetComponents`.
+ *
+ * @example
+ *   // bootstrap/providers.ts
+ *   registerSlotComponents({ BookmarkButton })
+ *
+ *   // A plugin / app contributes the chip into the resource-edit header:
+ *   panel.renderHook(
+ *     'panels::resource.pages.edit-record.header.actions.before',
+ *     (ctx) => [
+ *       SlotComponent.make('BookmarkButton').props({
+ *         basePath: ctx.basePath,
+ *         resourceSlug: ctx.resource?.getSlug(),
+ *         recordId: ctx.recordId,
+ *       }),
+ *     ],
+ *   )
+ */
+export class SlotComponent extends Element {
+    _componentName;
+    _props;
+    constructor(componentName) {
+        super();
+        this._componentName = componentName;
+    }
+    static make(componentName) {
+        return new SlotComponent(componentName);
+    }
+    /**
+     * Static props passed verbatim to the registered component. Must be
+     * JSON-serialisable — they ride through `viewProps` to the client.
+     * Successive calls merge shallowly with the previous bag.
+     */
+    props(props) {
+        this._props = { ...(this._props ?? {}), ...props };
+        return this;
+    }
+    getComponentName() {
+        return this._componentName;
+    }
+    getType() { return 'slotComponent'; }
+    toMeta() {
+        return {
+            type: 'slotComponent',
+            component: this._componentName,
+            ...(this._props ? { props: this._props } : {}),
+        };
+    }
+}
+//# sourceMappingURL=SlotComponent.js.map

package/dist/schema/SlotComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotComponent.js","sourceRoot":"","sources":["../../src/schema/SlotComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO;IAC9B,cAAc,CAAQ;IACtB,MAAM,CAA0B;IAE1C,YAAsB,aAAqB;QACzC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,cAAc,GAAG,aAAa,CAAA;IACrC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,aAAqB;QAC/B,OAAO,IAAI,aAAa,CAAC,aAAa,CAAC,CAAA;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAA8B;QAClC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAA;QAClD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEQ,OAAO,KAAa,OAAO,eAAe,CAAA,CAAC,CAAC;IAE5C,MAAM;QACb,OAAO;YACL,IAAI,EAAE,eAAwB;YAC9B,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAA;IACH,CAAC;CACF"}

package/dist/schema/Wizard.d.ts

@@ -1,4 +1,20 @@
 import { Element } from './Element.js';
+/**
+ * Context handed to `Step.beforeValidation` / `afterValidation` hooks.
+ * Mirrors the shape used by Form lifecycle hooks (record + user; values
+ * are passed positionally so handlers can mutate them in place).
+ */
+export interface StepValidationContext {
+    record?: unknown;
+    user?: unknown;
+}
+/**
+ * Hook signature for `Step.beforeValidation` / `afterValidation`.
+ * Throwing aborts the wizard advance with a 422 stamped under the
+ * reserved `_step` error key — surface a user-facing message via the
+ * thrown Error's `.message`.
+ */
+export type StepValidationHook = (values: Record<string, unknown>, ctx: StepValidationContext) => void | Promise<void>;
 /**
  * Single step inside a `Wizard`. Holds a label, optional icon/description,
  * and a list of child Elements. Children resolve unconditionally on every
@@ -9,6 +25,8 @@ export declare class Step extends Element {
     private _label;
     private _icon?;
     private _description?;
+    private _beforeValidation?;
+    private _afterValidation?;
     private constructor();
     static make(label: string): Step;
     /** Icon shown next to the step label (registry key). */
@@ -17,6 +35,25 @@ export declare class Step extends Element {
     description(d: string): this;
     /** Set the step's children. Any Element type is accepted. */
     schema(elements: Element[]): this;
+    /**
+     * Runs on the server BEFORE the step's fields are validated when the
+     * user clicks Next. Use to mutate `values` in place (e.g. stamp a
+     * computed field needed by validators) or run an async availability
+     * check that should block advance. Throw an Error to halt — the
+     * thrown message lands under the reserved `_step` key in the 422
+     * response so the renderer can show it next to the Next button.
+     */
+    beforeValidation(fn: StepValidationHook): this;
+    /**
+     * Runs on the server AFTER the step's validators pass and before the
+     * 200 advance response. Use for cross-field invariants, side-effects
+     * that should fire only on confirmed advance, or computed-field stamps
+     * that downstream steps will read. Throw to halt — same `_step` key
+     * convention as `beforeValidation`.
+     */
+    afterValidation(fn: StepValidationHook): this;
+    getBeforeValidation(): StepValidationHook | undefined;
+    getAfterValidation(): StepValidationHook | undefined;
     getType(): string;
     toMeta(): Record<string, unknown>;
 }

package/dist/schema/Wizard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Wizard.d.ts","sourceRoot":"","sources":["../../src/schema/Wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;GAKG;AACH,qBAAa,IAAK,SAAQ,OAAO;IAIX,OAAO,CAAC,MAAM;IAHlC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAC,CAAQ;IAE7B,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAExB,+EAA+E;IAC/E,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE5B,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjC,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,QAAQ,CAAO;IAEvB,OAAO;IAEP,MAAM,CAAC,IAAI,IAAI,MAAM;IAIrB,8EAA8E;IAC9E,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAK1B;;;;;OAKG;IACH,SAAS,CAAC,CAAC,UAAO,GAAG,IAAI;IAEzB,qCAAqC;IACrC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAEzB,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}
+{"version":3,"file":"Wizard.d.ts","sourceRoot":"","sources":["../../src/schema/Wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAI,OAAO,CAAA;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAK,qBAAqB,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB;;;;;GAKG;AACH,qBAAa,IAAK,SAAQ,OAAO;IAMX,OAAO,CAAC,MAAM;IALlC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAC,CAAQ;IAC7B,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,gBAAgB,CAAC,CAAqB;IAE9C,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAExB,+EAA+E;IAC/E,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE5B,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAKjC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAE9C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAE7C,mBAAmB,IAAI,kBAAkB,GAAG,SAAS;IACrD,kBAAkB,IAAK,kBAAkB,GAAG,SAAS;IAErD,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,QAAQ,CAAO;IAEvB,OAAO;IAEP,MAAM,CAAC,IAAI,IAAI,MAAM;IAIrB,8EAA8E;IAC9E,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAK1B;;;;;OAKG;IACH,SAAS,CAAC,CAAC,UAAO,GAAG,IAAI;IAEzB,qCAAqC;IACrC,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAEzB,OAAO,IAAI,MAAM;IAEjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC"}

package/dist/schema/Wizard.js

@@ -9,6 +9,8 @@ export class Step extends Element {
     _label;
     _icon;
     _description;
+    _beforeValidation;
+    _afterValidation;
     constructor(_label) {
         super();
         this._label = _label;
@@ -25,6 +27,25 @@ export class Step extends Element {
         this._children = elements;
         return this;
     }
+    /**
+     * Runs on the server BEFORE the step's fields are validated when the
+     * user clicks Next. Use to mutate `values` in place (e.g. stamp a
+     * computed field needed by validators) or run an async availability
+     * check that should block advance. Throw an Error to halt — the
+     * thrown message lands under the reserved `_step` key in the 422
+     * response so the renderer can show it next to the Next button.
+     */
+    beforeValidation(fn) { this._beforeValidation = fn; return this; }
+    /**
+     * Runs on the server AFTER the step's validators pass and before the
+     * 200 advance response. Use for cross-field invariants, side-effects
+     * that should fire only on confirmed advance, or computed-field stamps
+     * that downstream steps will read. Throw to halt — same `_step` key
+     * convention as `beforeValidation`.
+     */
+    afterValidation(fn) { this._afterValidation = fn; return this; }
+    getBeforeValidation() { return this._beforeValidation; }
+    getAfterValidation() { return this._afterValidation; }
     getType() { return 'step'; }
     toMeta() {
         return {

package/dist/schema/Wizard.js.map

@@ -1 +1 @@
-{"version":3,"file":"Wizard.js","sourceRoot":"","sources":["../../src/schema/Wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,OAAO,IAAK,SAAQ,OAAO;IAIH;IAHpB,KAAK,CAAS;IACd,YAAY,CAAS;IAE7B,YAA4B,MAAc;QACxC,KAAK,EAAE,CAAA;QADmB,WAAM,GAAN,MAAM,CAAQ;IAE1C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,IAAY,IAAU,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE3D,+EAA+E;IAC/E,WAAW,CAAC,CAAS,IAAU,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEnE,6DAA6D;IAC7D,MAAM,CAAC,QAAmB;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAa,OAAO,MAAM,CAAA,CAAC,CAAC;IAEnC,MAAM;QACJ,OAAO;YACL,IAAI,EAAG,MAAe;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAQ,CAAC,CAAC,EAAE,IAAI,EAAS,IAAI,CAAC,KAAK,EAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAA;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,MAAO,SAAQ,OAAO;IACzB,UAAU,GAAG,KAAK,CAAA;IAClB,YAAY,GAAG,CAAC,CAAA;IAChB,QAAQ,GAAG,IAAI,CAAA;IAEvB,gBAAwB,KAAK,EAAE,CAAA,CAAC,CAAC;IAEjC,MAAM,CAAC,IAAI;QACT,OAAO,IAAI,MAAM,EAAE,CAAA;IACrB,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,CAAC,GAAG,IAAI,IAAU,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE9D,qCAAqC;IACrC,WAAW,CAAC,CAAS,IAAU,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,OAAO,CAAC,CAAU,IAAU,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAE5D,OAAO,KAAa,OAAO,QAAQ,CAAA,CAAC,CAAC;IAErC,MAAM;QACJ,OAAO;YACL,IAAI,EAAS,QAAiB;YAC9B,SAAS,EAAI,IAAI,CAAC,UAAU;YAC5B,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAM,IAAI,CAAC,QAAQ;SAC3B,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"Wizard.js","sourceRoot":"","sources":["../../src/schema/Wizard.ts"],"names":[],"mappings":"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"}

package/dist/schema/index.d.ts

@@ -22,5 +22,6 @@ export { Group } from './Group.js';
 export { Fieldset } from './Fieldset.js';
 export { Split, type SplitFrom } from './Split.js';
 export { Wizard, Step } from './Wizard.js';
+export { SlotComponent } from './SlotComponent.js';
 export { resolveSchema, registerResolver, type SchemaDefinition, type SchemaContext, type RenderContext, type RenderMode, type ElementResolver, } from './resolveSchema.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAI,KAAK,YAAY,EAAE,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAI,KAAK,YAAY,EAAE,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAI,KAAK,YAAY,EAAE,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAI,KAAK,YAAY,EAAE,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAA"}

package/dist/schema/index.js

@@ -22,5 +22,6 @@ export { Group } from './Group.js';
 export { Fieldset } from './Fieldset.js';
 export { Split } from './Split.js';
 export { Wizard, Step } from './Wizard.js';
+export { SlotComponent } from './SlotComponent.js';
 export { resolveSchema, registerResolver, } from './resolveSchema.js';
 //# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GAKR,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,IAAI,EAAkD,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAuB,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAmB,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,QAAQ,EAA0B,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAuB,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAuB,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EACL,aAAa,EACb,gBAAgB,GAMjB,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GAKR,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,IAAI,EAAkD,MAAM,WAAW,CAAA;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAuB,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAmB,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,QAAQ,EAA0B,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAuB,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAuB,MAAQ,cAAc,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EACL,aAAa,EACb,gBAAgB,GAMjB,MAAM,oBAAoB,CAAA"}

package/dist/slot-components/index.d.ts

@@ -0,0 +1,2 @@
+export { registerSlotComponents, getSlotComponent, type SlotComponent, type SlotComponentProps, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/slot-components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/slot-components/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA"}

package/dist/slot-components/index.js

@@ -0,0 +1,6 @@
+// Slot-component runtime registry — opt-in component registration for
+// `SlotComponent` schema elements. Imported by panel `bootstrap/providers.ts`
+// or by a plugin's `register(panel)` step (e.g. `@pilotiq-pro/ai`'s
+// resource-header agents dropdown).
+export { registerSlotComponents, getSlotComponent, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/slot-components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/slot-components/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,8EAA8E;AAC9E,oEAAoE;AACpE,oCAAoC;AACpC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GAGjB,MAAM,eAAe,CAAA"}

package/dist/slot-components/registry.d.ts

@@ -0,0 +1,41 @@
+import type { ComponentType } from 'react';
+/**
+ * Render-time component registry for `SlotComponent` schema elements.
+ * Mirrors the widget / entry registry pattern: users register components
+ * by name in their app's `bootstrap/providers.ts` (or via a plugin's
+ * `register(panel)` hook), the `SlotComponent` ships the registered name
+ * on the wire (`{ component: 'BookmarkButton' }`), and the renderer
+ * looks up the actual component at render through `getSlotComponent()`.
+ *
+ * Why a runtime registry rather than the build-time `_components.ts`
+ * manifest the icon system uses: slot components typically live in plugin
+ * packages or app-level bootstrap files, not on Resource / Global / Page
+ * top-level statics, so the existing manifest walker doesn't see them. A
+ * runtime register-by-name keeps the wire compact and mirrors the
+ * `registerWidgetComponents / registerEntryComponents` precedent.
+ *
+ * @example
+ *   // bootstrap/providers.ts
+ *   import { registerSlotComponents } from '@pilotiq/pilotiq/slot-components'
+ *   import { BookmarkButton } from '#components/BookmarkButton.js'
+ *   registerSlotComponents({ BookmarkButton })
+ *
+ *   // Then a render-hook contribution (or any schema slot) can reference it:
+ *   panel.renderHook(
+ *     'panels::resource.pages.edit-record.header.actions.before',
+ *     () => [SlotComponent.make('BookmarkButton').props({ … })],
+ *   )
+ */
+/**
+ * Props handed to every registered slot component. The schema-side
+ * `SlotComponent.props({...})` setter ships through verbatim — pack
+ * everything the component needs into that bag (basePath, recordId,
+ * pre-resolved agent metas, etc).
+ */
+export type SlotComponentProps = Record<string, unknown>;
+export type SlotComponent = ComponentType<SlotComponentProps>;
+export declare function registerSlotComponents(map: Record<string, SlotComponent>): void;
+export declare function getSlotComponent(name: string): SlotComponent | undefined;
+/** Test-only: clear the registry. Not exported from the public entry. */
+export declare function _resetSlotComponentRegistryForTests(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/slot-components/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/slot-components/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACxD,MAAM,MAAM,aAAa,GAAQ,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAIlE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAK/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAExE;AAED,yEAAyE;AACzE,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}

package/dist/slot-components/registry.js

@@ -0,0 +1,17 @@
+const registry = {};
+export function registerSlotComponents(map) {
+    for (const key of Object.keys(map)) {
+        const c = map[key];
+        if (c)
+            registry[key] = c;
+    }
+}
+export function getSlotComponent(name) {
+    return registry[name];
+}
+/** Test-only: clear the registry. Not exported from the public entry. */
+export function _resetSlotComponentRegistryForTests() {
+    for (const key of Object.keys(registry))
+        delete registry[key];
+}
+//# sourceMappingURL=registry.js.map

package/dist/slot-components/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/slot-components/registry.ts"],"names":[],"mappings":"AAuCA,MAAM,QAAQ,GAAkC,EAAE,CAAA;AAElD,MAAM,UAAU,sBAAsB,CAAC,GAAkC;IACvE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QAClB,IAAI,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mCAAmC;IACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilotiq/pilotiq",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "View-based admin panel for RudderJS",
   "license": "MIT",
   "repository": {
@@ -50,6 +50,10 @@
       "import": "./dist/entries/index.js",
       "types": "./dist/entries/index.d.ts"
     },
+    "./slot-components": {
+      "import": "./dist/slot-components/index.js",
+      "types": "./dist/slot-components/index.d.ts"
+    },
     "./richtext": {
       "import": "./dist/richtext/index.js",
       "types": "./dist/richtext/index.d.ts"

package/src/Column.test.ts

@@ -137,4 +137,27 @@ describe('Column', () => {
       assert.equal(typeof col.getRecordUrlHandler(), 'function')
     })
   })
+
+  describe('beforeStateUpdated / afterStateUpdated accessors', () => {
+    it('return undefined when no hooks are set', () => {
+      const col = Column.make('title')
+      assert.equal(col.getBeforeStateUpdated(), undefined)
+      assert.equal(col.getAfterStateUpdated(),  undefined)
+    })
+
+    it('return the registered hook function', () => {
+      const before = async () => {}
+      const after  = () => {}
+      const col = Column.make('title').beforeStateUpdated(before).afterStateUpdated(after)
+      assert.equal(col.getBeforeStateUpdated(), before)
+      assert.equal(col.getAfterStateUpdated(),  after)
+    })
+
+    it('hooks are not serialized into the wire shape', () => {
+      const col = Column.make('title').beforeStateUpdated(() => {}).afterStateUpdated(() => {})
+      const meta = col.toMeta()
+      assert.equal((meta as Record<string, unknown>)['beforeStateUpdated'], undefined)
+      assert.equal((meta as Record<string, unknown>)['afterStateUpdated'],  undefined)
+    })
+  })
 })

package/src/Column.ts

@@ -25,6 +25,23 @@ export type ColumnType =
  * inside `loadTableRecords` so the renderer just reads the result. */
 export type ColumnDisabledFn = (record: Record<string, unknown>) => boolean
 
+/** Context handed to `Column.beforeStateUpdated / afterStateUpdated`
+ *  hooks on editable cell columns. `record` is the row as loaded
+ *  *before* the update; `user` is the resolved panel user. */
+export interface CellStateHookContext {
+  record: Record<string, unknown>
+  user?:  unknown
+}
+
+/** Hook signature for `Column.beforeStateUpdated / afterStateUpdated`.
+ *  Return value is ignored — these are side-effect hooks. Throw an
+ *  Error to halt the PATCH; the thrown message lands under `errors._cell`
+ *  in the 422 response so the renderer can surface it next to the cell. */
+export type CellStateHook = (
+  value: unknown,
+  ctx:   CellStateHookContext,
+) => void | Promise<void>
+
 /** SelectColumn option shape — mirrors `SelectField`'s static option form. */
 export interface ColumnSelectOption {
   value: string
@@ -214,6 +231,8 @@ export class Column extends Element {
   protected _confirm?: string
   protected _staticDisabled = false
   protected _disabledFn?: ColumnDisabledFn
+  protected _beforeStateUpdated?: CellStateHook
+  protected _afterStateUpdated?:  CellStateHook
 
   protected constructor(name: string) {
     super()
@@ -448,6 +467,31 @@ export class Column extends Element {
    */
   confirm(message: string): this { this._confirm = message; return this }
 
+  /**
+   * Run a hook on the server BEFORE the editable cell's value is written
+   * to the database. Receives the coerced + validated value plus the
+   * current row as `{ record, user }`. Use for cross-cell invariants,
+   * audit-log writes that must precede the update, or async availability
+   * checks that the schema-level validators don't cover. Throw an Error
+   * to halt — the thrown message lands under the reserved `_cell` error
+   * key in the 422 response.
+   */
+  beforeStateUpdated(fn: CellStateHook): this { this._beforeStateUpdated = fn; return this }
+
+  /**
+   * Run a hook on the server AFTER the editable cell's value is written
+   * to the database. Same context shape as `beforeStateUpdated`. Use for
+   * notifications, broadcast events, or follow-up writes that should
+   * fire only on a confirmed save. Throwing here returns 422 with the
+   * message under `_cell` — the row is already updated, so prefer
+   * surfacing the error and letting the user retry rather than rolling
+   * back manually.
+   */
+  afterStateUpdated(fn: CellStateHook): this { this._afterStateUpdated = fn; return this }
+
+  getBeforeStateUpdated(): CellStateHook | undefined { return this._beforeStateUpdated }
+  getAfterStateUpdated():  CellStateHook | undefined { return this._afterStateUpdated }
+
   /**
    * Render the inline-edit control disabled. Pass `true` (or call with no
    * args) for static disable; pass a `(record) => boolean` predicate for

package/src/RenderHook.ts

@@ -54,12 +54,20 @@ export type RenderHookName =
   | 'panels::resource.pages.list-records.table.before'
   | 'panels::resource.pages.list-records.table.after'
   | 'panels::resource.pages.list-records.tabs.end'
+  | 'panels::resource.pages.list-records.header.actions.before'
+  | 'panels::resource.pages.list-records.header.actions.after'
   | 'panels::resource.pages.create-record.form.before'
   | 'panels::resource.pages.create-record.form.after'
+  | 'panels::resource.pages.create-record.header.actions.before'
+  | 'panels::resource.pages.create-record.header.actions.after'
   | 'panels::resource.pages.edit-record.form.before'
   | 'panels::resource.pages.edit-record.form.after'
+  | 'panels::resource.pages.edit-record.header.actions.before'
+  | 'panels::resource.pages.edit-record.header.actions.after'
   | 'panels::resource.pages.view-record.start'
   | 'panels::resource.pages.view-record.end'
+  | 'panels::resource.pages.view-record.header.actions.before'
+  | 'panels::resource.pages.view-record.header.actions.after'
   | 'panels::global-search.results.before'
   | 'panels::global-search.results.after'
 
@@ -94,12 +102,20 @@ export const PAGE_HOOK_NAMES = [
   'panels::resource.pages.list-records.table.before',
   'panels::resource.pages.list-records.table.after',
   'panels::resource.pages.list-records.tabs.end',
+  'panels::resource.pages.list-records.header.actions.before',
+  'panels::resource.pages.list-records.header.actions.after',
   'panels::resource.pages.create-record.form.before',
   'panels::resource.pages.create-record.form.after',
+  'panels::resource.pages.create-record.header.actions.before',
+  'panels::resource.pages.create-record.header.actions.after',
   'panels::resource.pages.edit-record.form.before',
   'panels::resource.pages.edit-record.form.after',
+  'panels::resource.pages.edit-record.header.actions.before',
+  'panels::resource.pages.edit-record.header.actions.after',
   'panels::resource.pages.view-record.start',
   'panels::resource.pages.view-record.end',
+  'panels::resource.pages.view-record.header.actions.before',
+  'panels::resource.pages.view-record.header.actions.after',
   'panels::global-search.results.before',
   'panels::global-search.results.after',
 ] as const satisfies readonly RenderHookName[]