@pagehub/sdk 0.1.0

package/dist/core/store.d.ts

@@ -0,0 +1,39 @@
+import { default as React } from 'react';
+export type ViewMode = "mobile" | "desktop" | "tablet" | "sm" | "md" | "lg" | "xl" | "2xl";
+export interface EditorStoreValue {
+    /** Current responsive viewport */
+    view: ViewMode;
+    setView: (view: ViewMode) => void;
+    /** Preview mode (hides editor chrome) */
+    preview: boolean;
+    setPreview: (preview: boolean) => void;
+    /** Isolated page ID (if a specific page is focused) */
+    isolate: string;
+    setIsolate: (id: string) => void;
+    /** Current page settings from onLoad */
+    settings: Record<string, any>;
+    setSettings: (settings: Record<string, any>) => void;
+}
+/**
+ * Hook to access the SDK editor store.
+ * Drop-in replacement for `useRecoilValue(ViewAtom)` etc.
+ */
+export declare function useEditorStore(): EditorStoreValue;
+/**
+ * Convenience hooks that mirror the Recoil atom interface.
+ * These allow us to do a simple find-and-replace in extracted components:
+ *
+ *   BEFORE: const view = useRecoilValue(ViewAtom);
+ *   AFTER:  const view = useView();
+ */
+export declare function useView(): ViewMode;
+export declare function usePreview(): boolean;
+export declare function useIsolate(): string;
+interface EditorStoreProviderProps {
+    children?: React.ReactNode;
+    initialView?: ViewMode;
+    initialPreview?: boolean;
+}
+export declare function EditorStoreProvider({ children, initialView, initialPreview, }: EditorStoreProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAwE,MAAM,OAAO,CAAC;AAG7F,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAElC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAEvC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CACtD;AAID;;;GAGG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAMjD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,IAAI,QAAQ,CAElC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,WAAuB,EACvB,cAAsB,GACvB,EAAE,wBAAwB,2CA8B1B"}

package/dist/core/tailwindBrowser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Runtime Tailwind CSS v4 compiler for standalone SDK usage.
+ *
+ * When the SDK runs outside the Next.js app (demo, viewer, 3rd-party embeds),
+ * there's no build-time Tailwind pipeline to generate CSS for dynamic classes
+ * like `bg-primary` or `px-container-x`.
+ *
+ * This module injects @tailwindcss/browser — a v4 runtime compiler that watches
+ * the DOM via MutationObserver and generates CSS on the fly for any Tailwind
+ * classes it finds in `class` attributes. It also injects a <style type="text/tailwindcss">
+ * block with the SDK's theme tokens so the compiler knows the design system.
+ *
+ * IMPORTANT: The browser runtime outputs CSS inside @layer blocks. Layered CSS
+ * always loses to unlayered CSS (host page resets, etc.). We observe the runtime's
+ * output <style> tag and strip @layer wrappers — same approach as the SDK's
+ * build-time postcss-unwrap-layers.cjs plugin.
+ */
+/**
+ * Inject the Tailwind v4 browser runtime into the page.
+ *
+ * Safe to call multiple times — only injects once.
+ * Should be called early (before React renders) so the MutationObserver
+ * is ready to pick up classes as components mount.
+ */
+export declare function injectTailwindBrowser(): void;
+/**
+ * Remove the Tailwind browser runtime (for cleanup/destroy).
+ */
+export declare function removeTailwindBrowser(): void;
+//# sourceMappingURL=tailwindBrowser.d.ts.map

package/dist/core/tailwindBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindBrowser.d.ts","sourceRoot":"","sources":["../../src/core/tailwindBrowser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAiCH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAwE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAkB5C"}

package/dist/core/theme.d.ts

@@ -0,0 +1,4 @@
+import { PageHubTheme } from '../types';
+export declare function injectTheme(container: HTMLElement, theme: Required<PageHubTheme>): void;
+export declare function removeTheme(container: HTMLElement): void;
+//# sourceMappingURL=theme.d.ts.map

package/dist/core/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/core/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,wBAAgB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAmCvF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAIxD"}

package/dist/core/themeInline.generated.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Source: packages/sdk/src/utils/design/tokenSource.ts
+ * Emitter: packages/sdk/src/utils/design/emitBrowserThemeCss.ts
+ * Generator: scripts/generate-theme-css.mjs (runs in prebuild)
+ */
+export declare const THEME_INLINE_CSS = "\n@custom-variant dark (&:is(.dark *):not(#viewport:not(.dark) *));\n\n@theme inline {\n  /* DaisyUI 5 canonical tokens */\n  --color-primary: var(--primary);\n  --color-primary-content: var(--primary-content);\n  --color-secondary: var(--secondary);\n  --color-secondary-content: var(--secondary-content);\n  --color-accent: var(--accent);\n  --color-accent-content: var(--accent-content);\n  --color-neutral: var(--neutral);\n  --color-neutral-content: var(--neutral-content);\n  --color-base-100: var(--base-100);\n  --color-base-200: var(--base-200);\n  --color-base-300: var(--base-300);\n  --color-base-content: var(--base-content);\n  --color-error: var(--error);\n  --color-error-content: var(--error-content);\n  --color-info: var(--info);\n  --color-info-content: var(--info-content);\n  --color-success: var(--success);\n  --color-success-content: var(--success-content);\n  --color-warning: var(--warning);\n  --color-warning-content: var(--warning-content);\n  --color-border: var(--base-300);\n  --color-input: var(--base-300);\n  --color-ring: var(--ring);\n  --color-sidebar-foreground: var(--sidebar-foreground);\n  --color-sidebar-border: var(--sidebar-border);\n\n  --font-sans: var(--sans-font-family, var(--font-sans)), sans-serif;\n  --font-serif: var(--serif-font-family, var(--font-serif)), serif;\n  --font-mono: var(--mono-font-family, var(--font-mono)), monospace;\n  --font-heading: var(--heading-font-family), sans-serif;\n  --font-body: var(--body-font-family), sans-serif;\n  --font-accent: var(--accent-font-family), sans-serif;\n\n  /* Spatial scale: py-space-xl, gap-space-md, px-space-sm, etc. */\n  --spacing-space-xs: var(--space-xs);\n  --spacing-space-sm: var(--space-sm);\n  --spacing-space-md: var(--space-md);\n  --spacing-space-lg: var(--space-lg);\n  --spacing-space-xl: var(--space-xl);\n  --spacing-container-x: var(--container-padding-x);\n  --spacing-container-y: var(--container-padding-y);\n  --spacing-section: var(--section-gap);\n  --spacing-container: var(--container-gap);\n  --max-width-page: var(--content-width);\n\n  /* Radius */\n  --radius-box: var(--radius-box);\n  --radius-field: var(--radius-field);\n  --radius-selector: var(--radius-selector);\n  --radius-full: var(--radius-full, 9999px);\n  --radius-sm: calc(var(--radius) - 4px);\n  --radius-md: calc(var(--radius) - 2px);\n  --radius-lg: var(--radius);\n  --radius-xl: calc(var(--radius) + 4px);\n  --radius-2xl: calc(var(--radius) + 8px);\n  --radius-3xl: calc(var(--radius) + 16px);\n\n  /* CSS Animation Presets \u2014 keep in sync with packages/sdk/src/css/styles.css */\n  --animate-css-fade-in: css-fade-in 0.6s ease-out both;\n  --animate-css-fade-up: css-fade-up 0.6s ease-out both;\n  --animate-css-fade-down: css-fade-down 0.6s ease-out both;\n  --animate-css-fade-left: css-fade-left 0.6s ease-out both;\n  --animate-css-fade-right: css-fade-right 0.6s ease-out both;\n  --animate-css-scale-up: css-scale-up 0.5s ease-out both;\n  --animate-css-blur-in: css-blur-in 0.7s ease-out both;\n  --animate-css-slide-up: css-slide-up 0.5s cubic-bezier(0.25, 0.46, 0.45, 0.94) both;\n  --animate-css-flip-in: css-flip-in 0.6s ease-out both;\n  --animate-css-spring: css-spring 0.5s cubic-bezier(0.175, 0.885, 0.32, 1.275) both;\n  --animate-css-bounce-in: css-bounce-in 0.6s cubic-bezier(0.175, 0.885, 0.32, 1.275) both;\n  --animate-css-thud-in: css-thud-in 0.55s cubic-bezier(0.22, 1, 0.36, 1) both;\n  --animate-css-tile-flip: css-tile-flip 0.48s cubic-bezier(0.22, 1, 0.36, 1) both;\n  --animate-css-spin: css-spin 2s linear infinite;\n  --animate-css-pulse: css-pulse 2s ease-in-out infinite;\n  --animate-css-wiggle: css-wiggle 1s ease-in-out infinite;\n  --animate-css-marquee: css-marquee 40s linear infinite;\n  --animate-css-marquee-slow: css-marquee 60s linear infinite;\n}\n";
+//# sourceMappingURL=themeInline.generated.d.ts.map

package/dist/core/themeInline.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeInline.generated.d.ts","sourceRoot":"","sources":["../../src/core/themeInline.generated.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB,suHAAiuH,CAAC"}

package/dist/core/tiptapExtensions/VariableNode.d.ts

@@ -0,0 +1,60 @@
+import { Node } from '@tiptap/core';
+export interface VariableNodeOptions {
+    /**
+     * Callback to get available variables for suggestions.
+     */
+    getVariables: () => {
+        id: string;
+        label: string;
+        group?: string;
+    }[];
+    /**
+     * Called when the suggestion popup should open/close/update.
+     */
+    onSuggestion?: (props: SuggestionProps | null) => void;
+    /**
+     * Resolves a variable ID to its display text (e.g. "company.name" -> "Acme Inc.")
+     */
+    resolveVariable?: (id: string) => string;
+    /**
+     * Returns the anchor map for the owning Craft Text node — lets chips like
+     * `state.{{anchor.chat}}:assistantName` resolve in the editor preview.
+     */
+    getAnchors?: () => Readonly<Record<string, string>>;
+}
+export interface SuggestionProps {
+    query: string;
+    items: {
+        id: string;
+        label: string;
+        group?: string;
+    }[];
+    command: (item: {
+        id: string;
+        label: string;
+        group?: string;
+    }) => void;
+    clientRect: (() => DOMRect | null) | null;
+    decorationId: string | null;
+}
+/**
+ * Custom TipTap Node extension for template variables.
+ *
+ * - Renders as normal-looking text with a subtle variable indicator icon
+ * - Atomic (selected/deleted as a whole unit)
+ * - Double-click reveals the variable name in a popover
+ * - Serializes to <span data-variable="company.name"> in HTML
+ * - Typing {{ triggers autocomplete suggestion popup
+ */
+export declare const VariableNode: Node<VariableNodeOptions, any>;
+/**
+ * Preprocesses HTML content to convert raw {{variable}} text into
+ * <span data-variable="variable"> nodes that TipTap can parse. Authors paste
+ * raw `{{...}}` from anywhere — this wraps them so TipTap renders them as
+ * variable chips instead of literal braces.
+ *
+ * Already-wrapped spans are left untouched.
+ * Skips wrapping inside HTML attribute values (href, src, etc.).
+ */
+export declare function preprocessVariables(html: string): string;
+//# sourceMappingURL=VariableNode.d.ts.map

package/dist/core/tiptapExtensions/VariableNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableNode.d.ts","sourceRoot":"","sources":["../../../src/core/tiptapExtensions/VariableNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,cAAc,CAAC;AAMrD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,EAAE,MAAM;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpE;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE,UAAU,EAAE,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,gCAsLvB,CAAC;AAyGH;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBxD"}

package/dist/core/tiptapExtensions/VariableNodeView.d.ts

@@ -0,0 +1,3 @@
+import { NodeViewProps } from '@tiptap/core';
+export declare function VariableNodeView({ node, editor, getPos, extension, updateAttributes, deleteNode, }: NodeViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=VariableNodeView.d.ts.map

package/dist/core/tiptapExtensions/VariableNodeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableNodeView.d.ts","sourceRoot":"","sources":["../../../src/core/tiptapExtensions/VariableNodeView.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAUlD,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,MAAM,EACN,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,UAAU,GACX,EAAE,aAAa,2CA+If"}

package/dist/core/tiptapExtensions/pagehubTextTiptapExtensions.d.ts

@@ -0,0 +1,10 @@
+import { Extensions } from '@tiptap/core';
+import { SuggestionProps } from './VariableNode';
+/** `inline` = ProseMirror `doc` with `inline*` only — getHTML() has no wrapping `<p>`. */
+export type PagehubTextRichMode = "full" | "inline";
+export declare function getPagehubTextTiptapExtensions(mode: PagehubTextRichMode, onSuggestion: ((props: SuggestionProps | null) => void) | undefined, queryRef: {
+    current: any;
+} | undefined, nodeIdRef?: {
+    current: string | undefined;
+}): Extensions;
+//# sourceMappingURL=pagehubTextTiptapExtensions.d.ts.map

package/dist/core/tiptapExtensions/pagehubTextTiptapExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagehubTextTiptapExtensions.d.ts","sourceRoot":"","sources":["../../../src/core/tiptapExtensions/pagehubTextTiptapExtensions.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1D,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAM1F,0FAA0F;AAC1F,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAiOpD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,EACnE,QAAQ,EAAE;IAAE,OAAO,EAAE,GAAG,CAAA;CAAE,GAAG,SAAS,EACtC,SAAS,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC1C,UAAU,CAuCZ"}

package/dist/define/blocksProvider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Blocks provider — host-injected source for the Blocks panel catalog.
+ *
+ * The Blocks panel (toolbox "Blocks" tab) renders categories + searchable
+ * block templates that can be dragged onto the canvas. Historically the SDK
+ * fetched these directly from `/api/v1/components*` against the host origin,
+ * which only worked when the host was PageHub's own app. Standalone consumers
+ * had no override point.
+ *
+ * Now the SDK consults a registered `BlocksProvider`. Hosts ship whatever
+ * backing store they want — REST API, static JSON, in-memory fixture.
+ *
+ * Default: a HTTP provider that hits `/api/v1/components*` (the PageHub
+ * cloud API) and LZ-decompresses the returned structures. PageHub's own app
+ * works with zero registration. Standalone hosts call
+ * `registerBlocksProvider(...)` with their own implementation before
+ * enabling `features.blocksPanel.enabled`.
+ *
+ * See docs/sdk/host-constraints.md for usage.
+ */
+export interface BlockSubcategory {
+    name: string;
+    count: number;
+}
+export interface BlockCategory {
+    id: string;
+    name: string;
+    total: number;
+    subcategories: BlockSubcategory[];
+    styles: BlockSubcategory[];
+}
+export interface BlockItem {
+    _id: string;
+    slug: string;
+    name: string;
+    category: string;
+    subcategory?: string;
+    styles?: string[];
+    description?: string;
+    /** Structure can be a CraftJS-shaped object or a string the SDK will JSON-parse. */
+    structure: any;
+    modifiers?: Record<string, {
+        name: string;
+        classes: string;
+    }[]>;
+}
+export interface BlocksProviderQuery {
+    /** Restrict to a category (matches `BlockCategory.id`). */
+    category?: string;
+    /** Restrict to a subcategory within the category. */
+    subcategory?: string;
+    /** Restrict to blocks tagged with the given style. */
+    style?: string;
+    /** Full-text search across name / description / etc. */
+    search?: string;
+    /** Cap the result set. Default is provider-defined; the SDK passes 100 or 30. */
+    limit?: number;
+    /** Sort key the provider understands ("name", etc.). */
+    sort?: string;
+    /** When false, providers may return blocks with `structure: undefined` for faster list views.
+     *  Defaults to true — the SDK needs structure for drag-to-canvas. */
+    includeStructure?: boolean;
+}
+export interface BlocksProvider {
+    /** Return the category catalog (no block structures). Called once per editor mount. */
+    listCategories(): Promise<BlockCategory[]>;
+    /** Return blocks matching the query. Structure should be a resolved JSON object. */
+    listBlocks(query: BlocksProviderQuery): Promise<BlockItem[]>;
+}
+export declare function registerBlocksProvider(provider: BlocksProvider): void;
+export declare function resetBlocksProvider(): void;
+/** Returns the registered provider, or the default HTTP provider when none is set. */
+export declare function getBlocksProvider(): BlocksProvider;
+export declare const defaultHttpProvider: BlocksProvider;
+//# sourceMappingURL=blocksProvider.d.ts.map

package/dist/define/blocksProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocksProvider.d.ts","sourceRoot":"","sources":["../../src/define/blocksProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;yEACqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3C,oFAAoF;IACpF,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC9D;AAMD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CASrE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AA4BD,eAAO,MAAM,mBAAmB,EAAE,cAcjC,CAAC"}

package/dist/define/builtins.d.ts

@@ -0,0 +1,3 @@
+/** Built-in component names — derived from `viewerResolver` (single source of truth). Used for collision detection in `defineComponent`. */
+export declare const BUILT_IN_NAMES: Set<string>;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/define/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/define/builtins.ts"],"names":[],"mappings":"AAEA,4IAA4I;AAC5I,eAAO,MAAM,cAAc,aAAuC,CAAC"}

package/dist/define/catalogRegistry.d.ts

@@ -0,0 +1,25 @@
+import { ComponentModifier, ComponentPreset } from './types';
+export type CatalogFilterKind = "preset" | "modifier";
+export type CatalogEntry = ComponentPreset | ComponentModifier;
+export type CatalogFilterPredicate = (entry: CatalogEntry, kind: CatalogFilterKind) => boolean;
+/**
+ * Register (or replace) a per-component filter applied to that component's
+ * presets and modifiers at read time. The predicate returns `true` to keep
+ * the entry, `false` to drop it. Built-in catalogs are unaffected — only
+ * the read result is trimmed.
+ */
+export declare function registerCatalogFilter(componentName: string, predicate: CatalogFilterPredicate): void;
+/** Clear the filter for a component (or all components when omitted). */
+export declare function resetCatalogFilter(componentName?: string): void;
+export declare function getCatalogFilter(componentName: string): CatalogFilterPredicate | undefined;
+/** Register (or replace) the preset list for a component by name. */
+export declare function registerPresets(componentName: string, presets: ComponentPreset[]): void;
+/** Get the preset list for a component. Returns empty array if unregistered.
+ *  Applies the host catalog filter (if any) — returns a fresh array when filtered. */
+export declare function getPresets(componentName: string): ComponentPreset[];
+/** Register (or replace) the modifier list for a component by name. */
+export declare function registerModifiers(componentName: string, modifiers: ComponentModifier[]): void;
+/** Get the modifier list for a component. Returns empty array if unregistered.
+ *  Applies the host catalog filter (if any) — returns a fresh array when filtered. */
+export declare function getModifiers(componentName: string): ComponentModifier[];
+//# sourceMappingURL=catalogRegistry.d.ts.map

package/dist/define/catalogRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogRegistry.d.ts","sourceRoot":"","sources":["../../src/define/catalogRegistry.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAYlE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAC/D,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;AAI/F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,sBAAsB,GAChC,IAAI,CAeN;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAE1F;AAID,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI,CA6BvF;AAED;sFACsF;AACtF,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,EAAE,CAMnE;AAID,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAmC7F;AAED;sFACsF;AACtF,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAMvE"}

package/dist/define/componentAllowlist.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Component allowlist — host-configured filter over the editor's component catalog.
+ *
+ * The inverse of `PageHubFeatures.restrictedComponents` (a deny-list). When an
+ * allowlist is set, the toolbox + AI/MCP integrations should only see the listed
+ * component names. Useful for constrained editor modes (e.g. email) that want to
+ * start from nothing and opt in to a small set.
+ *
+ * See docs/sdk/host-constraints.md.
+ *
+ * Set via `registerComponentAllowlist`; cleared via `resetComponentAllowlist` or
+ * by passing an empty array. Same single-instance contract as the other runtime
+ * registries (apiConfig, cssAllowlist).
+ */
+/**
+ * Restrict the editor's component catalog to the named components. Pass an empty
+ * array (or call `resetComponentAllowlist`) to clear and fall back to no filter.
+ *
+ * Idempotent — last call wins. Built-in components and host-supplied custom
+ * components are filtered against the same name set.
+ */
+export declare function registerComponentAllowlist(names: string[]): void;
+export declare function resetComponentAllowlist(): void;
+/** Returns the current allowlist, or `null` when no filter is active. */
+export declare function getComponentAllowlist(): ReadonlySet<string> | null;
+/**
+ * Check whether a component name passes the current allowlist.
+ * Always returns `true` when no allowlist is set.
+ */
+export declare function isComponentAllowed(name: string): boolean;
+//# sourceMappingURL=componentAllowlist.d.ts.map

package/dist/define/componentAllowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentAllowlist.d.ts","sourceRoot":"","sources":["../../src/define/componentAllowlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAMhE;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/define/context.d.ts

@@ -0,0 +1,14 @@
+import { ResolvedComponentDef } from './types';
+export declare const CustomComponentsContext: import('react').Context<{
+    toolboxCategories: Array<{
+        title: string;
+        content: ResolvedComponentDef[];
+    }>;
+}>;
+export declare const useCustomComponents: () => {
+    toolboxCategories: Array<{
+        title: string;
+        content: ResolvedComponentDef[];
+    }>;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/define/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/define/context.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,uBAAuB;uBACf,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;EACjD,CAAC;AAE9B,eAAO,MAAM,mBAAmB;uBAHX,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;CAGF,CAAC"}

package/dist/define/defineComponent.d.ts

@@ -0,0 +1,15 @@
+import { PageHubComponentDef, ResolvedComponentDef } from './types';
+/**
+ * Define a component for the PageHub editor.
+ *
+ * Returns a frozen descriptor that can be passed to `PageHub.init()`,
+ * `<PageHubEditor>`, `<PageHubViewer>`, or `renderToHTML()` via the
+ * `components` array.
+ *
+ * For built-in SDK components, pass `{ __internal: true }` as the second
+ * argument to skip the built-in name collision check.
+ */
+export declare function defineComponent<P extends Record<string, any> = Record<string, any>>(def: PageHubComponentDef<P>, opts?: {
+    __internal?: boolean;
+}): ResolvedComponentDef<P>;
+//# sourceMappingURL=defineComponent.d.ts.map

package/dist/define/defineComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineComponent.d.ts","sourceRoot":"","sources":["../../src/define/defineComponent.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjF,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC3B,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAqCzB"}

package/dist/define/helpers.d.ts

@@ -0,0 +1,9 @@
+import { ToHTMLFn } from '../utils/staticHtml';
+import { PageHubComponentDef, ResolvedComponentDef } from './types';
+/** "MyRating" → "My Rating" */
+export declare function humanize(name: string): string;
+/** Normalize boolean rules to functions, with per-node permissions override layer. */
+export declare function normalizeRules(rules: PageHubComponentDef["rules"], canvas: boolean): ResolvedComponentDef["rules"];
+/** Build a fallback toHTML when the consumer doesn't provide one */
+export declare function buildFallbackToHTML(canvas: boolean): ToHTMLFn;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/define/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/define/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEzE,+BAA+B;AAC/B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACnC,MAAM,EAAE,OAAO,GACd,oBAAoB,CAAC,OAAO,CAAC,CAuD/B;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAe7D"}

package/dist/define/loadBuiltinCatalogs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Eager-load every built-in component catalog (presets + modifiers) so the
+ * editor can read them via `getPresets(name)` / `getModifiers(name)` after
+ * mount. Each catalog file self-registers at module load via
+ * `registerPresets("X", xPresets)` / `registerModifiers("X", xModifiers)`,
+ * so a side-effect dynamic import is enough.
+ *
+ * Viewer / static-renderer never call this — their bundles drop all preset
+ * code and the registry stays empty there.
+ */
+export declare function loadBuiltinCatalogs(): Promise<void>;
+//# sourceMappingURL=loadBuiltinCatalogs.d.ts.map

package/dist/define/loadBuiltinCatalogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadBuiltinCatalogs.d.ts","sourceRoot":"","sources":["../../src/define/loadBuiltinCatalogs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBzD"}

package/dist/define/processors/forEditor.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+import { ResolvedComponentDef } from '../types';
+/**
+ * Process an array of component definitions for the editor.
+ * Returns a resolver map and toolbox category data.
+ */
+export declare function processForEditor(defs: ResolvedComponentDef[], inspectorToolbar: React.ComponentType, defaultTools?: (canvas: boolean) => React.ReactNode[] | ((props: any) => React.ReactNode[])): {
+    resolver: Record<string, React.ComponentType>;
+    toolboxCategories: Array<{
+        title: string;
+        content: ResolvedComponentDef[];
+    }>;
+};
+//# sourceMappingURL=forEditor.d.ts.map

package/dist/define/processors/forEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forEditor.d.ts","sourceRoot":"","sources":["../../../src/define/processors/forEditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAyIlB;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,oBAAoB,EAAE,EAC5B,gBAAgB,EAAE,KAAK,CAAC,aAAa,EACrC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC,GAC1F;IACD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC9C,iBAAiB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9E,CAmCA"}

package/dist/define/processors/forStatic.d.ts

@@ -0,0 +1,8 @@
+import { ToHTMLFn } from '../../utils/staticHtml';
+import { ResolvedComponentDef } from '../types';
+/**
+ * Process an array of component definitions for the static renderer.
+ * Returns a map of name → toHTML function.
+ */
+export declare function processForStatic(defs: ResolvedComponentDef[]): Record<string, ToHTMLFn>;
+//# sourceMappingURL=forStatic.d.ts.map

package/dist/define/processors/forStatic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forStatic.d.ts","sourceRoot":"","sources":["../../../src/define/processors/forStatic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAMvF"}

package/dist/define/processors/forViewer.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { ResolvedComponentDef } from '../types';
+/**
+ * Process an array of component definitions for the viewer.
+ * Returns a plain resolver map (no .craft, no editor chrome).
+ */
+export declare function processForViewer(defs: ResolvedComponentDef[]): Record<string, React.ComponentType>;
+//# sourceMappingURL=forViewer.d.ts.map

package/dist/define/processors/forViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forViewer.d.ts","sourceRoot":"","sources":["../../../src/define/processors/forViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,oBAAoB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAMrC"}