npm - @pagehub/sdk - Versions diffs - 0.1.0 - Mend

@pagehub/sdk 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2317) hide show

package/dist/render/static/themeCss.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export declare function generateThemeVars(rootProps: Record<string, any>): string;
+/** `:root { … }` from ROOT/Background theme (palette + styleGuide) for static hand-off zips. */
+export declare function buildRootThemeCss(rootProps: Record<string, any>): string;
+//# sourceMappingURL=themeCss.d.ts.map

package/dist/render/static/themeCss.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"themeCss.d.ts","sourceRoot":"","sources":["../../../src/render/static/themeCss.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAgDxE;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAExE"}

package/dist/render/static/types.d.ts ADDED Viewed

@@ -0,0 +1,111 @@
+import { ResolvedComponentDef } from '../../define/types';
+import { ToHTMLFn } from '../../utils/staticHtml';
+export interface SerializedNode {
+    type: {
+        resolvedName: string;
+    } | string;
+    isCanvas?: boolean;
+    props: Record<string, any>;
+    parent: string | null;
+    nodes: string[];
+    linkedNodes?: Record<string, string>;
+    hidden?: boolean;
+    custom?: Record<string, any>;
+}
+export type SerializedNodes = Record<string, SerializedNode>;
+export interface RenderToHTMLOptions {
+    /** If true (default), content is lz-compressed base64. If false, raw JSON. */
+    compressed?: boolean;
+    /** Viewport: "desktop" includes md: prefixes, "mobile" strips them. Default: "desktop" */
+    view?: "desktop" | "mobile";
+    /** Palette colors. Auto-detected from ROOT if not provided. */
+    palette?: Array<{
+        name: string;
+        color: string;
+    }>;
+    /** Wrap output in a full HTML document. Default: false */
+    document?: boolean;
+    /** Include theme CSS variables in document mode. Default: true */
+    includeThemeVars?: boolean;
+    /** Page title for document mode */
+    title?: string;
+    /** Additional CSS to include */
+    extraCSS?: string;
+    /** Additional HTML for document head */
+    extraHead?: string;
+    /** Extra component toHTML functions — merged into default resolver */
+    resolver?: Record<string, ToHTMLFn>;
+    /** Custom components registered via defineComponent() */
+    components?: ResolvedComponentDef[];
+    /** Replace DaisyUI/spatial classes with pure Tailwind equivalents in output */
+    pureTailwind?: boolean;
+    /** Server-fetched connector data — resolves connector-backed conditions at SSR
+     *  instead of wrapping them for the client-only reveal script. */
+    connectorData?: Record<string, {
+        bindings: Record<string, any[]>;
+    }> | null;
+    /**
+     * Optional request hints from the calling Next.js page. When supplied, the
+     * walker resolves `auth` / `device` / `url-param` conditions at SSR instead
+     * of wrapping the node for the client re-eval script:
+     *  - `isAuthenticated` — cookie-derived (e.g. `ph-customer` presence)
+     *  - `userAgentClass`  — UA-derived viewport class
+     *  - `urlParams`       — parsed query (only meaningful for `getServerSideProps`)
+     * Any field omitted leaves the corresponding condition type indeterminate.
+     */
+    requestContext?: {
+        isAuthenticated?: boolean;
+        userAgentClass?: "mobile" | "tablet" | "desktop";
+        urlParams?: Record<string, string>;
+    };
+    /**
+     * Current request path (e.g. `/static/<siteId>/about` or `/about`). Passed
+     * through to toHTML emitters so `ref:<pageId>` action hrefs prefix correctly
+     * for preview routes (`/static/<id>`, `/view/<id>`, `/build/<id>`). On
+     * custom-domain production hits this is the bare slug path — `resolvePageRef`
+     * only prefixes recognized preview prefixes, so no false prefixing occurs.
+     */
+    currentPath?: string;
+    /**
+     * Emit the vanilla static-publish runtime alongside the document.
+     * Adds a tiny blocking `<head>` cart-bridge script + a main IIFE at the
+     * end of `<body>` that hydrates `data-state-*`, `data-ph-actions`,
+     * `data-ph-map`, forms, connector refetch, and customer-token detection.
+     * Default: false (Wave 4 opt-in).
+     */
+    runtime?: boolean;
+    /** Page id (used by runtime to scope cart localStorage). */
+    pageId?: string;
+}
+export interface RenderToHTMLResult {
+    /** Rendered HTML fragment (or full document if options.document) */
+    html: string;
+    /** All Tailwind classes used, for CSS compilation */
+    classes: string[];
+    /** Google Font URLs needed */
+    fontUrls: string[];
+    /** Script tag for CSS scroll animations (non-empty if ph-anim-scroll classes are used) */
+    scrollObserverScript: string;
+    /** Design system CSS variables (:root block) — palette colors, spacing, fonts */
+    themeCSS: string;
+    /** Per-site breakpoint overrides from ROOT.props.theme.breakpoints (undefined = defaults). */
+    breakpoints?: Record<string, number>;
+    /** SEO metadata extracted from ROOT props */
+    seo: {
+        title: string;
+        description: string;
+        ogImage?: string;
+        /** Raw JSON-LD object (single entry). */
+        jsonLd?: Record<string, unknown>;
+        /** Structured JSON-LD entries from the schema builder. Compiled at emit time. */
+        schema?: unknown[];
+    } | null;
+    /**
+     * Set when the tree cannot be rendered (e.g. missing ROOT). Callers should show this
+     * to users instead of treating render output as valid static HTML.
+     */
+    renderError?: string;
+}
+/** User-facing copy when serialized data has no ROOT / invalid shape (also logged as warning). */
+export declare const RENDER_INVALID_TREE_MESSAGE = "This page could not be turned into static HTML because the document is incomplete or invalid. Your draft can still be saved; try starting from a template or contact support if this keeps happening.";
+//# sourceMappingURL=types.d.ts.map

package/dist/render/static/types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/render/static/walker.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { StaticRenderContext, ToHTMLFn } from '../../utils/staticHtml';
+import { SerializedNode, SerializedNodes } from './types';
+export declare function resolveType(node: SerializedNode): string;
+export declare function renderNode(nodeId: string, nodes: SerializedNodes, resolver: Record<string, ToHTMLFn>, ctx: StaticRenderContext): string;
+//# sourceMappingURL=walker.d.ts.map

package/dist/render/static/walker.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../../../src/render/static/walker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/D,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAGxD;AAkCD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAClC,GAAG,EAAE,mBAAmB,GACvB,MAAM,CA6HR"}

package/dist/sdk-editor-css-stub ADDED Viewed

	@@ -0,0 +1 @@
1	+

package/dist/types/ai.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+export interface PageHubAIConfig {
+    /** Enable AI features (requires PageHub account). Default: false */
+    enabled?: boolean;
+}
+export interface PageHubMediaMetadataSuggestion {
+    title?: string;
+    alt?: string;
+    description?: string;
+}
+export interface PageHubMediaEditAiActionsContext {
+    media: {
+        id: string;
+        type?: "cdn" | "url" | "svg" | "r2";
+        cdnId?: string;
+        metadata?: {
+            title?: string;
+            alt?: string;
+            description?: string;
+            url?: string;
+            svg?: string;
+            size?: number;
+        };
+    };
+    imageUrl?: string;
+    isGenerating: boolean;
+    error: string;
+    designNotes?: string;
+    designTags?: string[];
+    setGenerating: (value: boolean) => void;
+    setError: (value: string) => void;
+    applyMetadata: (metadata: PageHubMediaMetadataSuggestion) => void;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/types/ai.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,WAAW,8BAA8B;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE;YACT,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,aAAa,EAAE,CAAC,QAAQ,EAAE,8BAA8B,KAAK,IAAI,CAAC;CACnE"}

package/dist/types/callbacks.d.ts ADDED Viewed

@@ -0,0 +1,81 @@
+import { PageData } from './page';
+import { SaveMeta, SaveResponse } from './save';
+export interface PageHubCallbacks {
+    /**
+     * Called when the user saves a page.
+     *
+     * Return a `SaveResponse` so the SDK coordinator can resolve the
+     * `instance.save()` promise with a typed result (success / conflict /
+     * failure).
+     */
+    onSave: (pageData: PageData, meta?: SaveMeta) => Promise<SaveResponse> | SaveResponse;
+    /**
+     * Optional: when the save coordinator surfaces a conflict and the caller
+     * picks "Reload", it invokes this to refetch the server's current draft.
+     * Return the deserialised CraftJS node map (raw object — the SDK will
+     * `JSON.stringify` + `actions.deserialize`) plus the new `updatedAt`.
+     * The SDK then retries the save against the fresh `expectedUpdatedAt`.
+     */
+    onConflictReload?: () => Promise<{
+        content: any;
+        updatedAt: string;
+    } | null>;
+    /**
+     * Called when the editor needs to load a page.
+     * The customer fetches from their own database.
+     * Return `null` for a blank canvas.
+     */
+    onLoad: (pageId?: string) => Promise<PageData | null> | PageData | null;
+    /** Emitted on every editor state change (debounced). Useful for auto-save. */
+    onChange?: (pageData: PageData) => void;
+    /**
+     * Fetch a single page shard for lazy loading.
+     * Called when the user switches to a page not yet in the CraftJS tree.
+     * Return compressed assembled content (shared + page), or null if unavailable.
+     * When omitted, SDK assumes all pages are in-tree (standalone mode).
+     */
+    fetchPage?: (pageNodeId: string) => Promise<{
+        content: string;
+    } | null>;
+    /** Called when the user publishes (promotes draft → live). */
+    onPublish?: (pageData: PageData) => Promise<void> | void;
+    /** Called when media needs to be uploaded. Return the public URL. */
+    onMediaUpload?: (file: File) => Promise<string>;
+    /** Called when media should be deleted */
+    onMediaDelete?: (url: string) => Promise<void>;
+    /** Called when a user clicks an "Add to Cart" button. Item is the current repeater item context. */
+    onAddToCart?: (item: Record<string, any>, quantity: number) => void;
+    /**
+     * Fetch page settings (props + metadata) for a page not currently in the CraftJS tree.
+     * Called when opening the page settings modal for an unloaded page shard.
+     * When omitted, settings are only readable for in-tree pages.
+     */
+    fetchPageSettings?: (pageNodeId: string) => Promise<PageSettingsPayload | null>;
+    /**
+     * Save page settings for a page not currently in the CraftJS tree.
+     * Called when committing settings changes for an unloaded page shard.
+     * When omitted, settings are only writable for in-tree pages.
+     */
+    savePageSettings?: (pageNodeId: string, settings: PageSettingsPayload) => Promise<void>;
+    /**
+     * Create a new page in the database (sharding mode).
+     * Called instead of tree-first AddElement when fetchPage is available.
+     */
+    createPage?: (params: {
+        pageNodeId: string;
+        displayName: string;
+        pageSlug?: string;
+        pageTitle?: string;
+        pageDescription?: string;
+    }) => Promise<{
+        nodeId: string;
+    }>;
+}
+/** Shape exchanged between SDK and host for remote page settings. */
+export interface PageSettingsPayload {
+    displayName: string;
+    isHomePage: boolean;
+    is404Page: boolean;
+    props: Record<string, any>;
+}
+//# sourceMappingURL=callbacks.d.ts.map

package/dist/types/callbacks.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../src/types/callbacks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,MAAM,EAAE,CACN,QAAQ,EAAE,QAAQ,EAClB,IAAI,CAAC,EAAE,QAAQ,KACZ,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IAE1C;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE7E;;;;OAIG;IACH,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAExE,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAExC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAExE,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzD,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhD,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,oGAAoG;IACpG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpE;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAEhF;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnC;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B"}

package/dist/types/config.d.ts ADDED Viewed

@@ -0,0 +1,88 @@
+import { ReactNode } from 'react';
+import { PageHubCallbacks } from './callbacks';
+import { PageHubTheme } from './theme';
+import { PageHubFeatures } from './features';
+import { PageHubAIConfig } from './ai';
+import { PageHubLocale } from './locale';
+export interface PageHubConfig {
+    /**
+     * DOM element or CSS selector to mount the editor into (`PageHub.init()` only).
+     * Optional when using the React `<PageHubProvider>` / `<PageHubEditor>` integration.
+     */
+    container?: HTMLElement | string;
+    /** API key for authenticating with PageHub Cloud (optional for self-hosted) */
+    apiKey?: string;
+    /** Customer's integration callbacks */
+    callbacks: PageHubCallbacks;
+    /** Visual theming */
+    theme?: PageHubTheme;
+    /** Feature toggles */
+    features?: PageHubFeatures;
+    /** AI configuration */
+    ai?: PageHubAIConfig;
+    /** Localization */
+    locale?: PageHubLocale;
+    /** Initial page ID to load. If omitted, calls onLoad(undefined) */
+    pageId?: string;
+    /** Start in read-only mode (viewer). Default: false */
+    readOnly?: boolean;
+    /**
+     * Base URL for API calls (e.g. 'https://example.com/api').
+     * Required for features that make server requests (save, AI, media, etc.).
+     */
+    apiBaseUrl?: string;
+    /** CDN configuration for image delivery */
+    cdn?: {
+        /** Cloudflare Images account hash (required for image rendering) */
+        accountHash?: string;
+        /** CDN base URL (e.g. 'https://imagedelivery.net') */
+        baseUrl?: string;
+        /** Image variant. Default: 'public' */
+        variant?: string;
+    };
+    /** Custom components registered via defineComponent() */
+    components?: import('../define/types').ResolvedComponentDef[];
+    /**
+     * Host-rendered docked panel (e.g. AI assistant). Shown when `features.aiGeneration` is true.
+     * The SDK provides layout placement only; all product UI and API calls live in the host.
+     * Use `useSDK()` inside your component if you need the emitter / config.
+     */
+    aiPanel?: ReactNode;
+    /**
+     * Override the toolbox preset list per component. **Replaces** the built-in
+     * list — host wins. Use the `@pagehub/sdk/presets/<component>` sub-path to
+     * compose with built-ins:
+     *
+     * ```ts
+     * import { containerPresets } from "@pagehub/sdk/presets/container";
+     * <PageHubProvider config={{
+     *   presets: { Container: [...containerPresets, mine] },
+     * }}>
+     * ```
+     */
+    presets?: Record<string, import('../define/types').ComponentPreset[]>;
+    /**
+     * Override the modifier list per component. **Replaces** the built-in list.
+     * Compose via `@pagehub/sdk/modifiers/<component>` sub-paths.
+     */
+    modifiers?: Record<string, import('../define/types').ComponentModifier[]>;
+    /**
+     * URL strategy for page navigation in the editor.
+     * When provided, the SDK uses pushState/popstate to manage page URLs
+     * (browser back/forward works). When omitted (standalone SDK),
+     * page switching happens in-memory only.
+     */
+    urlStrategy?: import('../utils/page/pageNavigation').UrlStrategy;
+    /**
+     * Google Fonts picker rails (`popular` / `funky` order) and extra names for API-less fallback.
+     * Omitted → stock `DEFAULT_CURATED_GOOGLE_FONT_FAMILIES` in `utils/fonts/curatedGoogleFontFamilies`.
+     */
+    curatedGoogleFontFamilies?: import('../utils/fonts/curatedGoogleFontFamilies').CuratedGoogleFontFamilies;
+    /**
+     * Responsive preview device frames (dropdown in device mode). Omitted → stock list in
+     * `chrome/viewport/viewportDevicePresets`. Use a non-empty array; `"Custom"` is optional but
+     * keeps the same UX as stock when users edit W×H manually.
+     */
+    viewportDevicePresets?: readonly import('../chrome/viewport/viewportDevicePresets').ViewportDevicePreset[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAEjC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,SAAS,EAAE,gBAAgB,CAAC;IAE5B,qBAAqB;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,uBAAuB;IACvB,EAAE,CAAC,EAAE,eAAe,CAAC;IAErB,mBAAmB;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,GAAG,CAAC,EAAE;QACJ,oEAAoE;QACpE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sDAAsD;QACtD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,uCAAuC;QACvC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;IAE9D;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,iBAAiB,EAAE,eAAe,EAAE,CAAC,CAAC;IAEtE;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,iBAAiB,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,8BAA8B,EAAE,WAAW,CAAC;IAEjE;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,0CAA0C,EAAE,yBAAyB,CAAC;IAEzG;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,SAAS,OAAO,0CAA0C,EAAE,oBAAoB,EAAE,CAAC;CAC5G"}

package/dist/types/events.d.ts ADDED Viewed

@@ -0,0 +1,44 @@
+import { PageData } from './page';
+import { SaveMeta, SaveStatus } from './save';
+import { SaveConflictError } from '../core/saveErrors';
+export type PageHubEvent = "ready" | "save" | "load" | "change" | "publish" | "error" | "modeChange" | "componentSelect" | "componentDeselect" | "unsaved_changes" | "save_status" | "save_conflict" | "saved" | "page_list_invalidated" | "updated_at_changed";
+export interface PageHubEventMap {
+    ready: [];
+    save: [options?: SaveMeta];
+    load: [pageData: PageData];
+    change: [];
+    publish: [pageData: PageData];
+    error: [error: unknown];
+    modeChange: [mode: "editor" | "viewer"];
+    componentSelect: [nodeId: string];
+    componentDeselect: [];
+    /** Emitted when dirty state toggles (editor tracks serialized graph when dirty). */
+    unsaved_changes: [dirty: boolean];
+    /** Save coordinator status taps — drives `<SaveIndicator />` etc. */
+    save_status: [status: SaveStatus];
+    /**
+     * Save coordinator hit a 409 — error carries bound `reload()` /
+     * `override()` retry methods. Modal hook listens for this and offers
+     * the user a choice without dispatching window events.
+     */
+    save_conflict: [error: SaveConflictError];
+    /**
+     * Save succeeded — carries the host's full response payload (e.g. the
+     * persisted page document). Necessary because nested zedux ecosystems
+     * mean a host-side `setSettings` doesn't always reach atom subscribers
+     * mounted inside the SDK's inner `EcosystemProvider`.
+     */
+    saved: [data: any];
+    /**
+     * Page list (page count / display names) is stale; consumers rendering
+     * it should refetch. Fired by `instance.invalidatePageList()`.
+     */
+    page_list_invalidated: [];
+    /**
+     * Server has stamped a fresh `updatedAt` outside the normal save path
+     * (e.g. after a conflict reload, or after the AI agent's MCP write).
+     * Hosts use this to bump their `expectedUpdatedAt` ref.
+     */
+    updated_at_changed: [updatedAt: string];
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,YAAY,GACZ,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,OAAO,GACP,uBAAuB,GACvB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,EAAE,CAAC;IACV,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3B,MAAM,EAAE,EAAE,CAAC;IACX,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACxC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB,EAAE,EAAE,CAAC;IACtB,oFAAoF;IACpF,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClC,qEAAqE;IACrE,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC;;;;OAIG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnB;;;OAGG;IACH,qBAAqB,EAAE,EAAE,CAAC;IAC1B;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;CACzC"}

package/dist/types/features.d.ts ADDED Viewed

@@ -0,0 +1,93 @@
+export interface PageHubFeatures {
+    /** Show/hide the sidebar component panel. Default: true */
+    sidebar?: boolean;
+    /** Show/hide the top toolbar. Default: true */
+    toolbar?: boolean;
+    /** Allow AI-powered generation. Default: false (requires AI API key) */
+    aiGeneration?: boolean;
+    /** Allow custom CSS editing. Default: false */
+    customCSS?: boolean;
+    /** Allow HTML import/export. Default: false */
+    importExport?: boolean;
+    /** Show SEO settings panel. Default: true */
+    seoPanel?: boolean;
+    /**
+     * Show the Page Settings modal (per-page name / slug / SEO meta / access /
+     * code injection). Default: true. Hosts that round-trip page-level state
+     * through their own API (e.g. the Avocado adapter, which uses Avocado's
+     * `update_page_meta` op-driven flow) can hide it so the SDK stops surfacing
+     * an editor the host can't observe. The "Page settings" gear button in the
+     * page selector disappears when false.
+     */
+    pageSettings?: boolean;
+    /**
+     * Show the design-system / theme panel (palette, typography, spacing tokens
+     * editable on ROOT). Default: true. Hosts whose backing model doesn't
+     * represent CraftJS theme state — Avocado's `update_site_config` covers
+     * name/logo/nav only, not palette/fonts — should hide it so silent token
+     * edits don't accumulate on the canvas.
+     */
+    designSystem?: boolean;
+    /**
+     * Show the Media Manager (asset library: upload, browse, edit, AI-describe).
+     * Default: true. Hosts that own asset storage outside PageHub's `/api/media/*`
+     * surface (e.g. Avocado, which has no MediaRecord model) should hide it so
+     * users don't upload into a black hole.
+     */
+    mediaManager?: boolean;
+    /**
+     * Show the Modifiers modal + topbar entry (Tailwind class-toggle catalog).
+     * Default: true. Modifier toggles emit `className` patches; hosts whose
+     * blocks don't accept arbitrary `className` (Avocado's `BlockInstance` schema
+     * doesn't model it) should hide them — toggles would either be silently
+     * rejected by the server or no-op on the renderer.
+     */
+    modifiers?: boolean;
+    /** Allow multi-page sites. Default: true */
+    multiPage?: boolean;
+    /** Allow marking a page as the site custom 404 canvas. Default: true (host can set false for free tier). */
+    custom404Page?: boolean;
+    /** Components to hide from the toolbox. */
+    restrictedComponents?: string[];
+    /** Enable responsive device preview toggle. Default: true */
+    responsivePreview?: boolean;
+    /** Save directly without showing the domain/publish picker. Default: false */
+    directSave?: boolean;
+    /** Show the save/publish button in the top toolbar. Default: true */
+    saveButton?: boolean;
+    /** Show the "Left/Right Settings Panel" toggle in the More menu. Default: true */
+    settingsPanelSwitcher?: boolean;
+    /** Show the "Switch to Dark/Light Theme" toggle in the More menu. Default: true */
+    darkModeSwitcher?: boolean;
+    /**
+     * Blocks panel config. Object (not boolean) so future block-related settings
+     * can land here without another flag rename. Omit to keep stock behavior.
+     * See docs/sdk/host-constraints.md.
+     */
+    blocksPanel?: BlocksPanelFeature;
+    /**
+     * Per-component allowlist of inspector tabs. Omit a component to keep all tabs.
+     * Tab names: "component" | "layout" | "design" | "interactions" | "advanced".
+     * See docs/sdk/host-constraints.md.
+     */
+    inspectorTabs?: Partial<Record<string, InspectorTabName[]>>;
+    /**
+     * Filter classNames + inline style props at the input boundary. Used for
+     * constrained editor modes (e.g. email) where the output can't support all CSS.
+     * See docs/sdk/host-constraints.md.
+     */
+    cssAllowlist?: CssAllowlistFeature;
+}
+/** Inspector tab name — kept as string union here to avoid import cycle with the inspector registry. */
+export type InspectorTabName = "component" | "layout" | "design" | "interactions" | "advanced";
+export interface BlocksPanelFeature {
+    /** Show the Blocks tab in the toolbox. Default: true */
+    enabled?: boolean;
+}
+export interface CssAllowlistFeature {
+    /** A class is allowed if at least one regex matches its full token. */
+    classes?: RegExp[];
+    /** Whitelist of inline style property names (kebab-case as they appear in CSS). */
+    properties?: string[];
+}
+//# sourceMappingURL=features.d.ts.map

package/dist/types/features.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/types/features.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,wGAAwG;AACxG,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,UAAU,CAAC;AAEf,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}

package/dist/types/index.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+/**
+ * @pagehub/sdk — Core type definitions
+ *
+ * These types define the public API surface of the SDK.
+ * Customers implement callbacks; we provide the editor.
+ *
+ * This barrel re-exports the focused submodules so the import path stays
+ * `@pagehub/sdk` / `../types` for every consumer. Concern map:
+ * - page.ts       — PageData, PageSeo
+ * - save.ts       — SaveResult, SaveResponse, SaveMeta, SaveStatus (types)
+ * - callbacks.ts  — PageHubCallbacks, PageSettingsPayload
+ * - theme.ts      — PageHubTheme
+ * - features.ts   — PageHubFeatures + InspectorTabName + Blocks/Css feature shapes
+ * - ai.ts         — PageHubAIConfig + media assistant slot context
+ * - locale.ts     — PageHubLocale
+ * - config.ts     — PageHubConfig
+ * - instance.ts   — PageHubInstance
+ * - events.ts     — PageHubEvent, PageHubEventMap
+ *
+ * Runtime that doesn't belong in a types module lives elsewhere and is
+ * re-exported here for back-compat:
+ * - core/saveErrors.ts     — SaveConflictError / SaveEmptyError / SaveFailedError
+ * - registry/stubTypes.ts  — forward-declared registry stub interfaces
+ */
+export type { PageData, PageSeo } from './page';
+export type { SaveResult, SaveResponse, SaveMeta, SaveStatus } from './save';
+export { SaveConflictError, SaveEmptyError, SaveFailedError } from '../core/saveErrors';
+export type { PageHubCallbacks, PageSettingsPayload } from './callbacks';
+export type { PageHubTheme } from './theme';
+export type { PageHubFeatures, InspectorTabName, BlocksPanelFeature, CssAllowlistFeature, } from './features';
+export type { PageHubAIConfig, PageHubMediaMetadataSuggestion, PageHubMediaEditAiActionsContext, } from './ai';
+export type { PageHubLocale } from './locale';
+export type { PageHubConfig } from './config';
+export type { PageHubCommandsRegistryStub, PageHubMenusRegistryStub, PageHubSlotsRegistryStub, PageHubKeybindingsRegistryStub, PageHubContextRegistryStub, } from '../registry/stubTypes';
+export type { PageHubInstance } from './instance';
+export type { PageHubEvent, PageHubEventMap } from './events';
+export type { PageHubComponentDef, ResolvedComponentDef, PropSchema, ComponentPreset, } from '../define/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,MAAM,CAAC;AACd,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EACV,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM9D,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/types/instance.d.ts ADDED Viewed

@@ -0,0 +1,70 @@
+import { PageData } from './page';
+import { SaveMeta, SaveResult, SaveStatus } from './save';
+import { PageHubTheme } from './theme';
+import { PageHubFeatures } from './features';
+import { PageHubEvent, PageHubEventMap } from './events';
+import { PageHubCommandsRegistryStub, PageHubMenusRegistryStub, PageHubSlotsRegistryStub, PageHubKeybindingsRegistryStub, PageHubContextRegistryStub } from '../registry/stubTypes';
+export interface PageHubInstance {
+    /**
+     * Programmatically save the current editor state. Resolves with the
+     * resulting `{ pageId, updatedAt }` and rejects with a typed error
+     * (`SaveConflictError`, `SaveEmptyError`, or `SaveFailedError`).
+     * Concurrent calls coalesce — the same `Promise<SaveResult>` is returned
+     * to every caller while one save is in flight.
+     */
+    save: (options?: SaveMeta) => Promise<SaveResult>;
+    /** Subscribe to save status (drives the toolbar save indicator). */
+    subscribeStatus: (handler: (status: SaveStatus) => void) => () => void;
+    /**
+     * Tell the SDK that the page list (page count / display names) is stale
+     * and any consumer rendering it should refetch. Used by host-side flows
+     * that mutate pages outside the canvas (rename, delete, settings save).
+     */
+    invalidatePageList: () => void;
+    /** Load a page into the editor */
+    load: (pageId: string) => Promise<void>;
+    /** Get the current page data without saving */
+    getPageData: () => PageData;
+    /** Switch between editor and viewer mode */
+    setReadOnly: (readOnly: boolean) => void;
+    /** Update theme at runtime */
+    setTheme: (theme: Partial<PageHubTheme>) => void;
+    /** Update feature flags at runtime */
+    setFeatures: (features: Partial<PageHubFeatures>) => void;
+    /** Destroy the editor and clean up DOM */
+    destroy: () => void;
+    /** Listen to SDK events */
+    on: <E extends PageHubEvent>(event: E, handler: (...args: PageHubEventMap[E]) => void) => () => void;
+    /** Get the rendered HTML string */
+    getHTML: () => string;
+    /** Serialise the current state to a JSON string (for export) */
+    exportJSON: () => string;
+    /** Import a previously exported JSON string */
+    importJSON: (json: string) => void;
+    /** Render the current editor state to static HTML + CSS class list */
+    exportHTML: (options?: {
+        view?: "desktop" | "mobile";
+        document?: boolean;
+        includeThemeVars?: boolean;
+        title?: string;
+        extraCSS?: string;
+        extraHead?: string;
+    }) => {
+        html: string;
+        classes: string[];
+        fontUrls: string[];
+        scrollObserverScript: string;
+        renderError?: string;
+    };
+    /**
+     * Command / menu / slot / keybinding / context registries.
+     * Phase 1 Wave A — registries are populated with builtin catalogs but
+     * surface migration lands in Phase 2.
+     */
+    commands?: PageHubCommandsRegistryStub;
+    menus?: PageHubMenusRegistryStub;
+    slots?: PageHubSlotsRegistryStub;
+    keybindings?: PageHubKeybindingsRegistryStub;
+    context?: PageHubContextRegistryStub;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/types/instance.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/types/instance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAElD,oEAAoE;IACpE,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAEvE;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAE/B,kCAAkC;IAClC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,+CAA+C;IAC/C,WAAW,EAAE,MAAM,QAAQ,CAAC;IAE5B,4CAA4C;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAEjD,sCAAsC;IACtC,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAE1D,0CAA0C;IAC1C,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB,2BAA2B;IAC3B,EAAE,EAAE,CAAC,CAAC,SAAS,YAAY,EACzB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,KAC3C,MAAM,IAAI,CAAC;IAEhB,mCAAmC;IACnC,OAAO,EAAE,MAAM,MAAM,CAAC;IAEtB,gEAAgE;IAChE,UAAU,EAAE,MAAM,MAAM,CAAC;IAEzB,+CAA+C;IAC/C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,sEAAsE;IACtE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;QACrB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAK;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,WAAW,CAAC,EAAE,8BAA8B,CAAC;IAC7C,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC"}

package/dist/types/locale.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export interface PageHubLocale {
+    /** ISO language code (e.g. 'en', 'fr', 'de') */
+    language?: string;
+    /** Override specific UI strings */
+    strings?: Record<string, string>;
+}
+//# sourceMappingURL=locale.d.ts.map

package/dist/types/locale.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}