@pagehub/sdk 0.1.0

package/dist/registry/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @pagehub/sdk — registry barrel.
+ *
+ * Single entry point for the command / menu / slot / keybinding / context
+ * registries plus the React provider, hooks, and SlotRenderer.
+ */
+export { createCommandsRegistry } from './commands';
+export type { CommandsRegistry } from './commands';
+export { createMenusRegistry } from './menus';
+export type { MenusRegistry } from './menus';
+export { createSlotsRegistry } from './slots';
+export type { SlotsRegistry } from './slots';
+export { createKeybindingsRegistry, parseKey } from './keybindings';
+export type { KeybindingsRegistry, ParsedKey } from './keybindings';
+export { createContextRegistry, DEFAULT_CONTEXT } from './context';
+export type { ContextRegistry } from './context';
+export { RegistriesProvider, useRegistries, useRegistriesSafe } from './provider';
+export type { RegistriesBundle } from './provider';
+export { SlotRenderer } from './SlotRenderer';
+export type { SlotRendererProps } from './SlotRenderer';
+export { useCommandContext, useMenuItems, useSlot, useSlotList, } from './hooks';
+export { useOverlay } from './hooks/useOverlay';
+export type { UseOverlayArgs } from './hooks/useOverlay';
+export { deriveSelectionContext } from './selectionContext';
+export type { DerivedSelectionContext } from './selectionContext';
+export { BUILTIN_COMMANDS } from './builtins/commands';
+export { BUILTIN_SLOTS } from './builtins/slots';
+export { BUILTIN_KEYBINDINGS } from './builtins/keybindings';
+export type { CommandDef, CommandContext, CommandRunContext, CommandSelectionContext, CommandParentContext, CommandTiptapContext, CommandOverlayContext, CommandClipboardContext, MenuItem, MenuLocation, ResolvedMenuItem, KeybindingDef, SlotDef, SlotContribution, SlotCardinality, SlotId, BuiltinSlotId, ResolvedContribution, } from './types';
+/**
+ * Creates the five registries and pre-registers all builtin commands,
+ * slots, menus, and keybindings. The host (SDK boot) calls this once.
+ */
+export declare function createRegistriesBundle(): {
+    context: import('./context').ContextRegistry;
+    commands: import('./commands').CommandsRegistry;
+    menus: import('./menus').MenusRegistry;
+    slots: import('./slots').SlotsRegistry;
+    keybindings: import('./keybindings').KeybindingsRegistry;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,YAAY,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAcjB;;;GAGG;AACH,wBAAgB,sBAAsB;;;;;;EAarC"}

package/dist/registry/keybindings.d.ts

@@ -0,0 +1,26 @@
+import { CommandContext, KeybindingDef } from './types';
+import { ContextRegistry } from './context';
+export interface KeybindingsRegistry {
+    register: <Args = unknown>(def: KeybindingDef<Args>) => void;
+    unregister: (command: string, key?: string) => void;
+    list: () => KeybindingDef[];
+    /** Given a key event, returns the highest-priority matching binding (or null). */
+    match: (event: KeyboardEvent, ctx?: CommandContext) => KeybindingDef | null;
+    subscribe: (listener: () => void) => () => void;
+}
+export interface KeybindingsRegistryDeps {
+    context: ContextRegistry;
+}
+export interface ParsedKey {
+    meta: boolean;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    /** Either "mod" (cmd OR ctrl) was specified — match either. */
+    mod: boolean;
+    /** The "main" key — `event.key` value to match against (case-insensitive for letters). */
+    key: string;
+}
+export declare function parseKey(spec: string): ParsedKey;
+export declare function createKeybindingsRegistry(deps: KeybindingsRegistryDeps): KeybindingsRegistry;
+//# sourceMappingURL=keybindings.d.ts.map

package/dist/registry/keybindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.d.ts","sourceRoot":"","sources":["../../src/registry/keybindings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC7D,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,MAAM,aAAa,EAAE,CAAC;IAC5B,kFAAkF;IAClF,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,cAAc,KAAK,aAAa,GAAG,IAAI,CAAC;IAC5E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAmCD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,GAAG,EAAE,OAAO,CAAC;IACb,0FAA0F;IAC1F,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA8BhD;AAoBD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,uBAAuB,GAC5B,mBAAmB,CAqFrB"}

package/dist/registry/keybindings.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keybindings.test.d.ts.map

package/dist/registry/keybindings.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.test.d.ts","sourceRoot":"","sources":["../../src/registry/keybindings.test.ts"],"names":[],"mappings":""}

package/dist/registry/mediaBackref.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Media Manager backref — module-level handle to the live media manager's
+ * `selectAllVisible` / `handleDeleteSelected` callbacks plus current
+ * selectionCount. Captured by the active `useMediaManager` instance via
+ * `useRegisterMediaContext` so the registry-dispatched commands
+ * (`ph.media.selectAll`, `ph.media.deleteSelected`) can reach them without
+ * routing every chord through component props.
+ *
+ * Same shape as `editorBackref.ts` / `tiptapBackref.ts` — the registry never
+ * imports React; one module ref + a tiny hook on the surface side.
+ */
+export interface MediaBackref {
+    selectAllVisible: () => void;
+    handleDeleteSelected: () => void;
+}
+export declare function setMediaBackref(ref: MediaBackref | null): void;
+export declare function getMediaBackref(): MediaBackref | null;
+//# sourceMappingURL=mediaBackref.d.ts.map

package/dist/registry/mediaBackref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaBackref.d.ts","sourceRoot":"","sources":["../../src/registry/mediaBackref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAClC;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE9D;AAED,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD"}

package/dist/registry/menus.d.ts

@@ -0,0 +1,18 @@
+import { CommandContext, MenuItem, MenuLocation, ResolvedMenuItem } from './types';
+import { CommandsRegistry } from './commands';
+import { ContextRegistry } from './context';
+export interface MenusRegistry {
+    contribute: <Args = unknown>(location: MenuLocation, items: MenuItem<Args>[]) => void;
+    remove: (location: MenuLocation, commandId: string) => void;
+    /** Resolved, sorted, when-filtered items for a location. */
+    items: (location: MenuLocation, ctx?: CommandContext) => ResolvedMenuItem[];
+    /** Raw (unresolved) contributions — useful for tests and debugging. */
+    raw: (location: MenuLocation) => MenuItem[];
+    subscribe: (listener: () => void) => () => void;
+}
+export interface MenusRegistryDeps {
+    commands: CommandsRegistry;
+    context: ContextRegistry;
+}
+export declare function createMenusRegistry(deps: MenusRegistryDeps): MenusRegistry;
+//# sourceMappingURL=menus.d.ts.map

package/dist/registry/menus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menus.d.ts","sourceRoot":"","sources":["../../src/registry/menus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,CAAC,IAAI,GAAG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC;IACtF,MAAM,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,4DAA4D;IAC5D,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,cAAc,KAAK,gBAAgB,EAAE,CAAC;IAC5E,uEAAuE;IACvE,GAAG,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,QAAQ,EAAE,CAAC;IAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;CAC1B;AA8BD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAgI1E"}

package/dist/registry/menus.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=menus.test.d.ts.map

package/dist/registry/menus.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menus.test.d.ts","sourceRoot":"","sources":["../../src/registry/menus.test.ts"],"names":[],"mappings":""}

package/dist/registry/mouseOverTracker.d.ts

@@ -0,0 +1,8 @@
+import { ContextRegistry } from './context';
+export interface MountMouseOverTrackerOptions {
+    context: ContextRegistry;
+    /** Document to track. Defaults to the global `document` in browsers. */
+    doc?: Document | null;
+}
+export declare function mountMouseOverTracker(opts: MountMouseOverTrackerOptions): () => void;
+//# sourceMappingURL=mouseOverTracker.d.ts.map

package/dist/registry/mouseOverTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouseOverTracker.d.ts","sourceRoot":"","sources":["../../src/registry/mouseOverTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAgBjD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,eAAe,CAAC;IACzB,wEAAwE;IACxE,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,4BAA4B,GACjC,MAAM,IAAI,CAqDZ"}

package/dist/registry/overlayStack.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Editor overlay stack — module-level LIFO of dismissable surfaces.
+ *
+ * Mirrors the shape of `_shownStack` in `packages/sdk/src/utils/state/stateRegistry.ts`
+ * (visitor-facing show-hide stack for published-site modals) but lives in the
+ * editor-registry namespace. The two stacks are intentionally separate:
+ *
+ *  - `utils/state/stateRegistry.ts` owns runtime visitor modals authored via
+ *    show-hide actions on published sites.
+ *  - This file owns editor chrome overlays — settings dialogs, popovers,
+ *    confirm prompts, the tiptap context menu, etc.
+ *
+ * The ⌘`ph.overlay.dismissTop` command and the `overlay.stackDepth` /
+ * `overlay.topId` context keys read from THIS stack.
+ *
+ * Each surface registers via `pushOverlay({ id, dismiss })` when it opens and
+ * `popOverlay(id)` when it closes (or on unmount). The dispatcher's Escape
+ * binding pops the top entry and calls its `dismiss` callback.
+ *
+ * Re-entry safety: pushing an id that's already on the stack moves it to the
+ * top (matches the visitor stack semantics — last-shown wins). Popping an
+ * unknown id is a no-op.
+ */
+export interface OverlayEntry {
+    id: string;
+    dismiss: () => void;
+}
+type StackListener = () => void;
+/**
+ * Push (or re-push) an overlay onto the stack. If `id` already exists, its
+ * entry is removed and re-added at the top so dispatch order matches the
+ * latest interaction.
+ */
+export declare function pushOverlay(entry: OverlayEntry): void;
+/**
+ * Remove an overlay by id. Safe to call with an id that isn't on the stack.
+ */
+export declare function popOverlay(id: string): void;
+/** Read the id of the top entry, or null when the stack is empty. */
+export declare function getTopOverlayId(): string | null;
+/** Read the current stack depth. */
+export declare function getOverlayDepth(): number;
+/**
+ * Pop the top entry and invoke its dismiss callback. Returns true when an
+ * entry was popped, false when the stack was empty. The command runner uses
+ * this to drive `ph.overlay.dismissTop`.
+ */
+export declare function dismissTopOverlay(): boolean;
+/**
+ * Subscribe to stack changes (push / pop / clear). Returns unsubscribe.
+ * `useRegisterOverlayContext()` uses this to keep `overlay.{stackDepth,topId}`
+ * in sync with the live stack.
+ */
+export declare function subscribeOverlayStack(listener: StackListener): () => void;
+/** Test helper — clear all entries. Do not call from production code. */
+export declare function _resetOverlayStackForTests(): void;
+export {};
+//# sourceMappingURL=overlayStack.d.ts.map

package/dist/registry/overlayStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayStack.d.ts","sourceRoot":"","sources":["../../src/registry/overlayStack.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,KAAK,aAAa,GAAG,MAAM,IAAI,CAAC;AAehC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAMrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM3C;AAED,qEAAqE;AACrE,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAG/C;AAED,oCAAoC;AACpC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAU3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAKzE;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD"}

package/dist/registry/overlayStack.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=overlayStack.test.d.ts.map

package/dist/registry/overlayStack.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayStack.test.d.ts","sourceRoot":"","sources":["../../src/registry/overlayStack.test.ts"],"names":[],"mappings":""}

package/dist/registry/provider.d.ts

@@ -0,0 +1,23 @@
+import { default as React } from 'react';
+import { CommandsRegistry } from './commands';
+import { MenusRegistry } from './menus';
+import { SlotsRegistry } from './slots';
+import { KeybindingsRegistry } from './keybindings';
+import { ContextRegistry } from './context';
+export interface RegistriesBundle {
+    commands: CommandsRegistry;
+    menus: MenusRegistry;
+    slots: SlotsRegistry;
+    keybindings: KeybindingsRegistry;
+    context: ContextRegistry;
+    /** Monotonic tick — incremented on any registry change. Useful for `useSyncExternalStore` getSnapshot. */
+    tick: number;
+}
+export declare function RegistriesProvider(props: {
+    registries: Omit<RegistriesBundle, "tick">;
+    children?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useRegistries(): RegistriesBundle;
+/** Returns the registries or null if no provider is mounted. */
+export declare function useRegistriesSafe(): RegistriesBundle | null;
+//# sourceMappingURL=provider.d.ts.map

package/dist/registry/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/registry/provider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAA0E,MAAM,OAAO,CAAC;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,0GAA0G;IAC1G,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,2CAoCA;AAED,wBAAgB,aAAa,IAAI,gBAAgB,CAShD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,IAAI,gBAAgB,GAAG,IAAI,CAE3D"}

package/dist/registry/sectionsBackref.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sections-settings modal backref — module handle to the live quick-look
+ * toggle on `CategoryDetailView`. Lets the registry-dispatched Space chord
+ * (`ph.sections.toggleQuickLook`) drive it without reaching through React.
+ *
+ * Same shape as editorBackref / mediaBackref / annotationBackref.
+ */
+export interface SectionsBackref {
+    toggleQuickLook: () => void;
+}
+export declare function setSectionsBackref(ref: SectionsBackref | null): void;
+export declare function getSectionsBackref(): SectionsBackref | null;
+//# sourceMappingURL=sectionsBackref.d.ts.map

package/dist/registry/sectionsBackref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sectionsBackref.d.ts","sourceRoot":"","sources":["../../src/registry/sectionsBackref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAEpE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D"}

package/dist/registry/selectionContext.d.ts

@@ -0,0 +1,28 @@
+import { CommandSelectionContext, CommandParentContext, CommandClipboardContext } from './types';
+export interface DerivedSelectionContext {
+    selection: CommandSelectionContext;
+    parent: CommandParentContext;
+    clipboard: CommandClipboardContext;
+    /** Sibling-move enablement (matches `useToolboxMenuModel.canMoveUp/Down`). */
+    "siblingMove.canMoveUp": boolean;
+    "siblingMove.canMoveDown": boolean;
+    /** True when no existing saved-component already wraps this node. */
+    canMakeSavedComponent: boolean;
+    /** Convenience flag carried for menu-time gates. */
+    hasPageIsolation: boolean;
+}
+interface DeriveOptions {
+    /** List of saved components — used to compute `canMakeSavedComponent`. */
+    components?: Array<{
+        rootNodeId?: string;
+    }> | null;
+    /** Value of IsolateAtom — null/empty when no page is isolated. */
+    pageIsolation?: string | null;
+}
+/**
+ * Derive the selection-context snapshot for the currently selected node.
+ * Pass `query=null` or `selectionId=null` for an empty snapshot.
+ */
+export declare function deriveSelectionContext(query: any, selectionId: string | null | undefined, opts?: DeriveOptions): DerivedSelectionContext;
+export {};
+//# sourceMappingURL=selectionContext.d.ts.map

package/dist/registry/selectionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionContext.d.ts","sourceRoot":"","sources":["../../src/registry/selectionContext.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAQjB,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,uBAAuB,CAAC;IACnC,8EAA8E;IAC9E,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;IACnC,qEAAqE;IACrE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,UAAU,aAAa;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACnD,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAaD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,GAAG,EACV,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,GAAE,aAAkB,GACvB,uBAAuB,CA+GzB"}

package/dist/registry/sidebarBackref.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sidebar (settings panel) backref — module handle to the live
+ * `toggleSearch` callback on `ToolbarWrapper`. Lets the registry-dispatched
+ * ⌘F chord (`ph.sidebar.search`) open / close the floating settings-search
+ * popup without prop drilling.
+ */
+export interface SidebarBackref {
+    toggleSearch: () => void;
+}
+export declare function setSidebarBackref(ref: SidebarBackref | null): void;
+export declare function getSidebarBackref(): SidebarBackref | null;
+//# sourceMappingURL=sidebarBackref.d.ts.map

package/dist/registry/sidebarBackref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebarBackref.d.ts","sourceRoot":"","sources":["../../src/registry/sidebarBackref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAElE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD"}

package/dist/registry/slots.d.ts

@@ -0,0 +1,19 @@
+import { ResolvedContribution, SlotContribution, SlotDef } from './types';
+import { ContextRegistry } from './context';
+export interface SlotsRegistry {
+    register: (def: SlotDef) => void;
+    contribute: <Ctx = unknown>(c: SlotContribution<Ctx>) => void;
+    /** Remove all contributions to `slotId`. If `key` given, remove only that one. */
+    remove: (slotId: string, key?: unknown) => void;
+    /** Resolve contributions for `slotId` given the slot's context. */
+    resolve: <Ctx = unknown>(slotId: string, ctx?: Ctx) => ResolvedContribution<Ctx>[];
+    /** Read the registered slot definition. */
+    getDef: (slotId: string) => SlotDef | undefined;
+    list: () => SlotDef[];
+    subscribe: (listener: () => void) => () => void;
+}
+export interface SlotsRegistryDeps {
+    context: ContextRegistry;
+}
+export declare function createSlotsRegistry(deps: SlotsRegistryDeps): SlotsRegistry;
+//# sourceMappingURL=slots.d.ts.map

package/dist/registry/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/registry/slots.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,OAAO,EACR,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,UAAU,EAAE,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAC9D,kFAAkF;IAClF,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,mEAAmE;IACnE,OAAO,EAAE,CAAC,GAAG,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;IACnF,2CAA2C;IAC3C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAChD,IAAI,EAAE,MAAM,OAAO,EAAE,CAAC;IACtB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAkBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CA2I1E"}

package/dist/registry/slots.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=slots.test.d.ts.map

package/dist/registry/slots.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.test.d.ts","sourceRoot":"","sources":["../../src/registry/slots.test.ts"],"names":[],"mappings":""}

package/dist/registry/stubTypes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Forward-declared registry interfaces, referenced by `PageHubInstance`.
+ *
+ * Kept structural (loose `any`) and dependency-free so `types/` can reference
+ * the registries without importing the value-side `./registry` modules — that
+ * would introduce a cycle. The concrete registry types live in
+ * `registry/types.ts`; these are deliberately the loose public-instance shape.
+ */
+export interface PageHubCommandsRegistryStub {
+    register: (def: any) => void;
+    unregister: (id: string) => void;
+    execute: (id: string, args?: any, options?: any) => Promise<void>;
+    list: () => any[];
+    get: (id: string) => any;
+    isVisible: (id: string, args?: any) => boolean;
+    isEnabled: (id: string, args?: any) => boolean;
+    subscribe: (listener: () => void) => () => void;
+}
+export interface PageHubMenusRegistryStub {
+    contribute: (location: string, items: any[]) => void;
+    remove: (location: string, commandId: string) => void;
+    items: (location: string, ctx?: any) => any[];
+    raw: (location: string) => any[];
+    subscribe: (listener: () => void) => () => void;
+}
+export interface PageHubSlotsRegistryStub {
+    register: (def: any) => void;
+    contribute: (c: any) => void;
+    remove: (slotId: string, key?: any) => void;
+    resolve: (slotId: string, ctx?: any) => any[];
+    getDef: (slotId: string) => any;
+    list: () => any[];
+    subscribe: (listener: () => void) => () => void;
+}
+export interface PageHubKeybindingsRegistryStub {
+    register: (def: any) => void;
+    unregister: (command: string, key?: string) => void;
+    list: () => any[];
+    match: (event: KeyboardEvent, ctx?: any) => any;
+    subscribe: (listener: () => void) => () => void;
+}
+export interface PageHubContextRegistryStub {
+    setCommandContext: (patch: any) => void;
+    set: (key: string, value: unknown) => void;
+    unset: (key: string) => void;
+    getSnapshot: () => any;
+    subscribe: (listener: () => void) => () => void;
+}
+//# sourceMappingURL=stubTypes.d.ts.map

package/dist/registry/stubTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubTypes.d.ts","sourceRoot":"","sources":["../../src/registry/stubTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC;IAClB,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,GAAG,CAAC;IACzB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAC/C,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACrD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;IAC9C,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;IACjC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7B,UAAU,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;IAC9C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,GAAG,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC;IAClB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7B,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC;IAChD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACxC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,CAAC;IACvB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD"}

package/dist/registry/tiptapBackref.d.ts

@@ -0,0 +1,10 @@
+import { Editor } from '@tiptap/core';
+export declare function setActiveTiptapEditor(editor: Editor | null): void;
+/**
+ * Clear ONLY if the currently-active editor is `editor`. Used in `onBlur` and
+ * unmount paths so a stale blur doesn't wipe a newer focus registration.
+ */
+export declare function clearActiveTiptapEditorIf(editor: Editor): void;
+export declare function getActiveTiptapEditor(): Editor | null;
+export declare function subscribeActiveTiptapEditor(listener: () => void): () => void;
+//# sourceMappingURL=tiptapBackref.d.ts.map

package/dist/registry/tiptapBackref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiptapBackref.d.ts","sourceRoot":"","sources":["../../src/registry/tiptapBackref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAgB3C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIjE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK9D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK5E"}

package/dist/registry/types.d.ts

@@ -0,0 +1,182 @@
+import { ReactNode } from 'react';
+import { useEditorReturnType } from '@craftjs/core';
+import { PageHubFeatures } from '../types';
+/** The CraftJS `query` object exposed by `useEditor()`. */
+export type EditorQuery = useEditorReturnType["query"];
+/** The CraftJS `actions` object exposed by `useEditor()` (private internals
+ *  filtered out by craft itself). */
+export type EditorActions = useEditorReturnType["actions"];
+export interface CommandSelectionContext {
+    id: string | null;
+    type: string | null;
+    isCanvas: boolean;
+    isDeletable: boolean;
+    isLinked: boolean;
+    canDelete: boolean;
+}
+export interface CommandParentContext {
+    id: string | null;
+    displayName: string | null;
+}
+export interface CommandTiptapContext {
+    active: boolean;
+    selectionEmpty: boolean;
+    richTextMode: "full" | "inline";
+    isActive: (name: string, attrs?: unknown) => boolean;
+    can: () => unknown;
+    /** Currently-open inline panel (font / link / more / null). */
+    activePanel: string | null;
+}
+export interface CommandOverlayContext {
+    stackDepth: number;
+    topId: string | null;
+}
+export interface CommandClipboardContext {
+    hasNode: boolean;
+    hasClasses: boolean;
+}
+/**
+ * Inputs for `when` and `enablement` predicates. Materialized via the
+ * context registry — both SDK-derived (selection, history, mode, …) and
+ * host-set arbitrary keys.
+ */
+export interface CommandContext {
+    selection: CommandSelectionContext;
+    parent: CommandParentContext;
+    canUndo: boolean;
+    canRedo: boolean;
+    mode: "editor" | "preview";
+    viewMode: "page" | "canvas";
+    features: Partial<Required<PageHubFeatures>> | Required<PageHubFeatures>;
+    isAiEnabled: boolean;
+    tiptap: CommandTiptapContext;
+    overlay: CommandOverlayContext;
+    clipboard: CommandClipboardContext;
+    mouseOver: "canvas" | "sidebar" | "topbar" | "modal" | null;
+    /** Host- or surface-set arbitrary context keys. */
+    [hostKey: string]: unknown;
+}
+/**
+ * Context passed into `run`. Adds craft `query`, `actions`, and the trigger
+ * source so commands can branch on how they were invoked.
+ */
+export interface CommandRunContext extends CommandContext {
+    query: EditorQuery;
+    actions: EditorActions;
+    trigger: "menu" | "palette" | "keybinding" | "api" | "host";
+}
+export interface CommandDef<Args = void> {
+    id: string;
+    title: string | ((ctx: CommandContext, args?: Args) => string);
+    category?: "Edit" | "View" | "File" | "Format" | "Insert" | "Tools" | "Preferences" | "AI" | "Text" | string;
+    icon?: ReactNode | ((ctx: CommandContext) => ReactNode);
+    /** Hard visibility gate — falsy hides the command from menus / palette / dispatch. */
+    when?: (ctx: CommandContext, args?: Args) => boolean;
+    /** Soft enablement — command is visible but disabled when false. */
+    enablement?: (ctx: CommandContext, args?: Args) => boolean;
+    /** Hide from the command palette even when visible elsewhere (e.g. selection-context-only). */
+    paletteHide?: boolean;
+    /**
+     * Sentinel: command body is a placeholder (logs a warning). The keybinding
+     * dispatcher skips `preventDefault()` when the matched command is stubbed,
+     * so existing real handlers keep owning the chord during the Phase 2
+     * migration. Phase 2 deletes the duplicates and clears this flag.
+     */
+    stub?: boolean;
+    run: (ctx: CommandRunContext, args?: Args) => void | Promise<void>;
+}
+/**
+ * Menu locations recognized by `useMenuItems(location)` consumers.
+ *
+ * Most locations are populated by `BUILTIN_MENUS` entries. Two are reserved
+ * for host contributions only — built-ins intentionally don't populate them:
+ *
+ *  - `node/breadcrumb` — breadcrumb crumbs are data-driven (ancestor IDs
+ *    from the live selection array), not static contributions. Reserved
+ *    so hosts can append actions to a node's crumb without forking the
+ *    breadcrumb component.
+ *  - `empty-state/cta` — empty-state CTAs are intentionally bespoke layout
+ *    (large cards with copy + illustrations), not generic menu rendering.
+ *    Reserved so hosts can register additional CTAs without re-skinning
+ *    the empty-state component.
+ *
+ * Removing either id from the union is a breaking change for hosts that
+ * have already wired contributions against it.
+ */
+export type MenuLocation = "topbar" | "navmenu/header" | "navmenu/settings" | "navmenu/view" | "navmenu/tools" | "navmenu/preferences" | "canvas/context" | "canvas/chip" | "node/breadcrumb" | "tiptap/inline" | "tiptap/inline/font-panel" | "tiptap/inline/link-panel" | "tiptap/inline/more-panel" | "tiptap/inline/text-color-panel" | "tiptap/inline/highlight-panel" | "tiptap/inline/context-menu" | "sidebar/tabs" | "empty-state/cta" | "palette" | (string & {});
+export interface MenuItem<Args = unknown> {
+    command: string;
+    args?: Args;
+    /** "groupName@order" — group ordering parsed at resolve time. */
+    group?: string;
+    iconOverride?: ReactNode | ((ctx: CommandContext) => ReactNode);
+    titleOverride?: string | ((ctx: CommandContext) => string);
+    /** Per-location additional gate; AND'd with command.when. */
+    when?: (ctx: CommandContext) => boolean;
+}
+export interface ResolvedMenuItem<Args = unknown> {
+    command: string;
+    args?: Args;
+    group: string;
+    groupOrder: number;
+    /** Resolved title (after titleOverride + dynamic title fn). */
+    title: string;
+    /** Resolved icon. */
+    icon: ReactNode | null;
+    category?: string;
+    enabled: boolean;
+    paletteHide: boolean;
+    /** The underlying command def for downstream consumers that want it. */
+    def: CommandDef<Args>;
+}
+export interface KeybindingDef<Args = unknown> {
+    command: string;
+    /** "cmd+z" | "shift+cmd+m" | "mod+z" | "backspace" | "escape" | "tab" | "space" | "+" | "-" | "0" */
+    key: string;
+    args?: Args;
+    when?: (ctx: CommandContext) => boolean;
+    /** Higher wins on conflict. Defaults to 0 (canvas/editor layer). */
+    priority?: number;
+}
+export type SlotCardinality = "single" | "list";
+/**
+ * Built-in slot ids the SDK pre-registers via `BUILTIN_SLOTS`. Keep in lock-step
+ * with `registry/builtins/slots.ts` — that file is the runtime source of truth;
+ * this union exists so `sdk.slots.contribute({ slot: "…" })` autocompletes.
+ *
+ * Hosts may also register their own slots and contribute against them — the
+ * `(string & {})` escape hatch on `SlotId` preserves arbitrary strings while
+ * keeping the autocomplete for the builtin ids.
+ */
+export type BuiltinSlotId = "toolbox/ai-button" | "tiptap/inline-copy-assistant" | "settings/ai-button" | "node/data-source-section" | "node/ai-generate-button" | "node/ai-context-button" | "node/ai-context-editor" | "empty-state/ai-card" | "navmenu/ai-row" | "navmenu/header-items" | "import-export/handoff-extras" | "media-edit/ai-actions" | "page-settings/extra-tabs";
+/** A slot id — one of the builtins or a host-registered custom id. */
+export type SlotId = BuiltinSlotId | (string & {});
+export interface SlotDef {
+    id: SlotId;
+    cardinality: SlotCardinality;
+    /** Documents the context shape passed to renderers; for docs only. */
+    contextShape?: string;
+    /** Default priority used when a contribution omits one (single-cardinality). */
+    defaultPriority?: number;
+}
+export interface SlotContribution<Ctx = unknown> {
+    slot: SlotId;
+    render: (ctx: Ctx) => ReactNode;
+    /** Higher wins for single-cardinality. */
+    priority?: number;
+    /** "groupName@order" — ordering for list-cardinality slots. */
+    group?: string;
+    /** Optional per-contribution gate. Args: slot ctx, command ctx. */
+    when?: (ctx: Ctx, app: CommandContext) => boolean;
+    /** Opaque key — pass to `slots.remove(id, key)` to remove this specific contribution. */
+    key?: unknown;
+}
+export interface ResolvedContribution<Ctx = unknown> {
+    slot: string;
+    render: (ctx: Ctx) => ReactNode;
+    priority: number;
+    group: string;
+    groupOrder: number;
+    key?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

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