@notionhq/custom-blocks 0.0.58

package/dist/react/NotionCustomBlock.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { NotInIframeError } from "../index.js";
+import { DebugMessageLog } from "./DebugMessageLog.js";
+import { seedStandalonePreviewState } from "./standalonePreview.js";
+import { useCustomBlockAutoResize } from "./useCustomBlockAutoResize.js";
+import { useCustomBlockInit } from "./useCustomBlockInit.js";
+import { useCustomBlockHost } from "./useHostState.js";
+import "./NotionCustomBlock.css";
+/**
+ * Top-level wrapper that runs the SDK ↔ host handshake and gates `children`
+ * until it resolves. Passes `timeoutMs` straight through to
+ * {@link initCustomBlock}.
+ *
+ * Templates that prefer not to write a `Root` gating component (or top-level
+ * `await`) can mount their app entirely inside this provider:
+ *
+ * ```tsx
+ * ReactDOM.createRoot(root).render(
+ *   <NotionCustomBlock>
+ *     <App />
+ *   </NotionCustomBlock>,
+ * )
+ * ```
+ *
+ * Inside `children`, every SDK hook is guaranteed to return a populated
+ * value. Outside the provider (or during the loading window), they throw.
+ */
+export function NotionCustomBlock({ children, timeoutMs, fallback = null, errorFallback, autoResize = true, }) {
+    const init = useCustomBlockInit({ timeoutMs });
+    useCustomBlockAutoResize({ enabled: autoResize });
+    const isStandalone = init.error instanceof NotInIframeError;
+    const host = useCustomBlockHost();
+    const [debugOpen, setDebugOpen] = useState(false);
+    useEffect(() => {
+        const onKeyDown = (e) => {
+            if (e.key === "\\") {
+                setDebugOpen(prev => !prev);
+            }
+        };
+        window.addEventListener("keydown", onKeyDown);
+        return () => window.removeEventListener("keydown", onKeyDown);
+    }, []);
+    useEffect(() => {
+        if (!isStandalone) {
+            return;
+        }
+        console.warn(`[notion-custom-sdk] ${init.error?.message}`);
+        seedStandalonePreviewState();
+    }, [isStandalone, init.error]);
+    if (debugOpen) {
+        return _jsx(DebugMessageLog, {});
+    }
+    if (init.error && !isStandalone) {
+        if (errorFallback === undefined) {
+            return _jsx(DefaultInitErrorFallback, { error: init.error });
+        }
+        return (_jsx(_Fragment, { children: typeof errorFallback === "function"
+                ? errorFallback(init.error)
+                : errorFallback }));
+    }
+    if (isStandalone) {
+        // Wait for the effect to seed placeholder host state; otherwise hooks
+        // in `children` would throw.
+        if (host.status !== "initialized") {
+            return _jsx(_Fragment, { children: fallback });
+        }
+        return (_jsxs(_Fragment, { children: [_jsx("div", { role: "status", className: "ncblock-standalone-banner", children: "Notion host not detected \u2014 running in standalone preview. SDK hooks return placeholder values until embedded in Notion." }), children] }));
+    }
+    if (!init.isLoaded) {
+        return _jsx(_Fragment, { children: fallback });
+    }
+    return _jsx(_Fragment, { children: children });
+}
+// TODO(custom-blocks): Align the styling of this with the host-side error states.
+function DefaultInitErrorFallback({ error }) {
+    useEffect(() => {
+        console.warn(`[notion-custom-sdk] Custom block init failed: ${error.message}`);
+    }, [error]);
+    return (_jsx("div", { role: "alert", className: "ncblock-default-init-error", children: _jsxs("div", { className: "ncblock-default-init-error__card", children: [_jsx("div", { className: "ncblock-default-init-error__eyebrow", children: "Custom block" }), _jsx("h2", { className: "ncblock-default-init-error__title", children: "Couldn't connect to Notion" }), _jsx("p", { className: "ncblock-default-init-error__body", children: "This custom block loaded, but the setup handshake didn't finish. Try again from Notion. If this keeps happening, check the browser console for SDK details." }), _jsxs("details", { className: "ncblock-default-init-error__details", children: [_jsx("summary", { children: "Developer details" }), _jsx("pre", { className: "ncblock-default-init-error__pre", children: error.message })] })] }) }));
+}

package/dist/react/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * React entrypoint for `@notionhq/custom-blocks/react`.
+ *
+ * Exposes only the React surface — components and hooks. Framework-neutral
+ * values and types (clients, manifest/data-source types, etc.) live on the
+ * `@notionhq/custom-blocks` entrypoint and are intentionally NOT re-exported
+ * here, so the two public surfaces stay disjoint.
+ */
+export { NotionCustomBlock, type NotionCustomBlockProps, } from "./NotionCustomBlock.js";
+export { useCustomBlockAutoResize } from "./useCustomBlockAutoResize.js";
+export { type CustomBlockInitFailure, type UseCustomBlockInitResult, useCustomBlockInit, } from "./useCustomBlockInit.js";
+export { useDataSource } from "./useDataSource.js";
+export { useBlockId, useCurrentUser, useManifest, usePage, useParent, useTheme, } from "./useRuntimeState.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,iBAAiB,EACjB,KAAK,sBAAsB,GAC3B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,kBAAkB,GAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EACN,UAAU,EACV,cAAc,EACd,WAAW,EACX,OAAO,EACP,SAAS,EACT,QAAQ,GACR,MAAM,sBAAsB,CAAA"}

package/dist/react/index.js

@@ -0,0 +1,13 @@
+/**
+ * React entrypoint for `@notionhq/custom-blocks/react`.
+ *
+ * Exposes only the React surface — components and hooks. Framework-neutral
+ * values and types (clients, manifest/data-source types, etc.) live on the
+ * `@notionhq/custom-blocks` entrypoint and are intentionally NOT re-exported
+ * here, so the two public surfaces stay disjoint.
+ */
+export { NotionCustomBlock, } from "./NotionCustomBlock.js";
+export { useCustomBlockAutoResize } from "./useCustomBlockAutoResize.js";
+export { useCustomBlockInit, } from "./useCustomBlockInit.js";
+export { useDataSource } from "./useDataSource.js";
+export { useBlockId, useCurrentUser, useManifest, usePage, useParent, useTheme, } from "./useRuntimeState.js";

package/dist/react/standalonePreview.d.ts

@@ -0,0 +1,2 @@
+export declare function seedStandalonePreviewState(): void;
+//# sourceMappingURL=standalonePreview.d.ts.map

package/dist/react/standalonePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalonePreview.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/standalonePreview.ts"],"names":[],"mappings":"AAOA,wBAAgB,0BAA0B,SAoBzC"}

package/dist/react/standalonePreview.js

@@ -0,0 +1,26 @@
+import * as v from "valibot";
+import { notionBlockIdSchema, notionPageIdSchema } from "../bridge/ids.js";
+import { customBlockHost } from "../bridge/sandboxClient.js";
+const previewBlockId = v.parse(notionBlockIdSchema, "");
+const previewPageId = v.parse(notionPageIdSchema, "");
+export function seedStandalonePreviewState() {
+    customBlockHost.setMockState({
+        type: "init",
+        status: "success",
+        theme: "light",
+        blockId: previewBlockId,
+        parent: { type: "page_id", page_id: previewPageId },
+        page: { id: previewPageId },
+        dataSources: { bindings: {} },
+        currentUser: {
+            object: "user",
+            id: "",
+            name: "Preview User",
+            avatar_url: null,
+            type: "person",
+            person: {
+                email: "preview@example.com",
+            },
+        },
+    });
+}

package/dist/react/useCustomBlockAutoResize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Measures the sandbox's `#root` element and posts `resize` messages so the host iframe
+ * matches the block's border-box height. Unchanged values are deduped.
+ *
+ * `<NotionCustomBlock>` calls this hook for you by default — only reach for it directly
+ * when you need to drive `enabled` yourself (e.g. behind a debug toggle). In that case,
+ * pass `autoResize={false}` to the provider to avoid running it twice. For full-bleed
+ * views that should fill their slot, pass `autoResize={false}` and skip the hook.
+ *
+ * @example
+ * <NotionCustomBlock autoResize={false}>
+ *   <App />
+ * </NotionCustomBlock>
+ *
+ * function App() {
+ *   const [enabled, setEnabled] = useState(true)
+ *   useCustomBlockAutoResize({ enabled })
+ *   return <div>…</div>
+ * }
+ */
+export declare function useCustomBlockAutoResize(args?: {
+    /**
+     * Whether or not the hook is enabled. To disable this behavior, pass `false`. This is
+     * provided as an argument to allow for conditional disabling of the hook.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+}): void;
+//# sourceMappingURL=useCustomBlockAutoResize.d.ts.map

package/dist/react/useCustomBlockAutoResize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCustomBlockAutoResize.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/useCustomBlockAutoResize.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,GAAE;IACL;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACZ,GACJ,IAAI,CAYN"}

package/dist/react/useCustomBlockAutoResize.js

@@ -0,0 +1,35 @@
+import { useEffect } from "react";
+import { customBlock } from "../index.js";
+/**
+ * Measures the sandbox's `#root` element and posts `resize` messages so the host iframe
+ * matches the block's border-box height. Unchanged values are deduped.
+ *
+ * `<NotionCustomBlock>` calls this hook for you by default — only reach for it directly
+ * when you need to drive `enabled` yourself (e.g. behind a debug toggle). In that case,
+ * pass `autoResize={false}` to the provider to avoid running it twice. For full-bleed
+ * views that should fill their slot, pass `autoResize={false}` and skip the hook.
+ *
+ * @example
+ * <NotionCustomBlock autoResize={false}>
+ *   <App />
+ * </NotionCustomBlock>
+ *
+ * function App() {
+ *   const [enabled, setEnabled] = useState(true)
+ *   useCustomBlockAutoResize({ enabled })
+ *   return <div>…</div>
+ * }
+ */
+export function useCustomBlockAutoResize(args = {}) {
+    const { enabled = true } = args;
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        if (typeof window === "undefined") {
+            return;
+        }
+        const target = document.getElementById("root");
+        return customBlock.autoResize({ target });
+    }, [enabled]);
+}

package/dist/react/useCustomBlockInit.d.ts

@@ -0,0 +1,43 @@
+import { CustomBlockInitError } from "../bridge/messages/init.js";
+import { type CustomBlockInitial, type InitCustomBlockOptions, NotInIframeError } from "../init.js";
+export type CustomBlockInitFailure = CustomBlockInitError | NotInIframeError;
+/**
+ * Discriminated state returned by {@link useCustomBlockInit}.
+ *
+ * Branch on `isLoaded`/`error`:
+ * - `{ isLoaded: false, error: undefined }` — handshake in progress.
+ * - `{ isLoaded: false, error: CustomBlockInitFailure }` — handshake failed (most commonly a
+ *   `CustomBlockInitError` with code `init_timeout` because the host never sent `init`).
+ * - `{ isLoaded: true, initial }` — handshake complete; safe to render
+ *   children that call `useTheme`, `useBlockId`, etc.
+ */
+export type UseCustomBlockInitResult = {
+    isLoaded: false;
+    error: undefined;
+} | {
+    isLoaded: false;
+    error: CustomBlockInitFailure;
+} | {
+    isLoaded: true;
+    error: undefined;
+    initial: CustomBlockInitial;
+};
+/**
+ * React wrapper around {@link initCustomBlock}. Kicks off the SDK ↔ host
+ * handshake on mount and returns a discriminated state object so the rest of
+ * the tree can render inside the `isLoaded === true` branch (where every
+ * other SDK hook is guaranteed to return a populated value).
+ *
+ * Idempotent — multiple components can call this; they share the same
+ * underlying handshake promise.
+ *
+ * @example
+ * function Root() {
+ *   const init = useCustomBlockInit()
+ *   if (init.error) return <p role="alert">Init failed: {init.error.message}</p>
+ *   if (!init.isLoaded) return null
+ *   return <App />
+ * }
+ */
+export declare function useCustomBlockInit(opts?: InitCustomBlockOptions): UseCustomBlockInitResult;
+//# sourceMappingURL=useCustomBlockInit.d.ts.map

package/dist/react/useCustomBlockInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCustomBlockInit.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/useCustomBlockInit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE3B,gBAAgB,EAChB,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG,gBAAgB,CAAA;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GACjC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,CAAC,EAAE,sBAAsB,GAC3B,wBAAwB,CA8B1B"}

package/dist/react/useCustomBlockInit.js

@@ -0,0 +1,60 @@
+import { useEffect, useState } from "react";
+import { CustomBlockInitError } from "../bridge/messages/init.js";
+import { initCustomBlock, NotInIframeError, } from "../init.js";
+/**
+ * React wrapper around {@link initCustomBlock}. Kicks off the SDK ↔ host
+ * handshake on mount and returns a discriminated state object so the rest of
+ * the tree can render inside the `isLoaded === true` branch (where every
+ * other SDK hook is guaranteed to return a populated value).
+ *
+ * Idempotent — multiple components can call this; they share the same
+ * underlying handshake promise.
+ *
+ * @example
+ * function Root() {
+ *   const init = useCustomBlockInit()
+ *   if (init.error) return <p role="alert">Init failed: {init.error.message}</p>
+ *   if (!init.isLoaded) return null
+ *   return <App />
+ * }
+ */
+export function useCustomBlockInit(opts) {
+    const [state, setState] = useState({
+        isLoaded: false,
+        error: undefined,
+    });
+    useEffect(() => {
+        let cancelled = false;
+        initCustomBlock(opts).then(initial => {
+            if (!cancelled) {
+                setState({ isLoaded: true, error: undefined, initial });
+            }
+        }, err => {
+            if (!cancelled) {
+                setState({
+                    isLoaded: false,
+                    error: normalizeInitError(err),
+                });
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+        // `initCustomBlock` caches its result, so options after the first call
+        // are ignored — re-running on opts changes would be misleading.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return state;
+}
+function normalizeInitError(error) {
+    if (error instanceof CustomBlockInitError ||
+        error instanceof NotInIframeError) {
+        return error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return new CustomBlockInitError({
+        code: "unknown_error",
+        message,
+        isRetryable: false,
+    });
+}

package/dist/react/useDataSource.d.ts

@@ -0,0 +1,13 @@
+import type { UseDataSourceOptions, UseDataSourceResult } from "../types.js";
+/**
+ * Reads from the data source mapped to the given semantic `key`.
+ *
+ * @param key - The semantic data-source key the block is wired to (e.g. `"people"`).
+ * @param options - Optional live snapshot options. `limit` defaults to 20 and
+ *   is capped at 999.
+ *
+ * @example
+ * const { items, isLoading, hasMore, error } = useDataSource("default", { limit: 25 })
+ */
+export declare function useDataSource(key: string, options?: UseDataSourceOptions): UseDataSourceResult;
+//# sourceMappingURL=useDataSource.d.ts.map

package/dist/react/useDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataSource.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/useDataSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAG5E;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,oBAAoB,GAC5B,mBAAmB,CA4BrB"}

package/dist/react/useDataSource.js

@@ -0,0 +1,37 @@
+import { useEffect } from "react";
+import { customBlockDataSources } from "../bridge/sandboxClient.js";
+import { useCustomBlockHost } from "./useHostState.js";
+/**
+ * Reads from the data source mapped to the given semantic `key`.
+ *
+ * @param key - The semantic data-source key the block is wired to (e.g. `"people"`).
+ * @param options - Optional live snapshot options. `limit` defaults to 20 and
+ *   is capped at 999.
+ *
+ * @example
+ * const { items, isLoading, hasMore, error } = useDataSource("default", { limit: 25 })
+ */
+export function useDataSource(key, options) {
+    const host = useCustomBlockHost();
+    const limit = options?.limit;
+    const matchingDataSource = host.status === "initialized"
+        ? host.dataSources.find(dataSource => dataSource.key === key)
+        : undefined;
+    const isInitialized = host.status === "initialized";
+    useEffect(() => {
+        if (!isInitialized) {
+            return;
+        }
+        customBlockDataSources.query(key, { limit });
+    }, [matchingDataSource, isInitialized, key, limit]);
+    const view = customBlockDataSources.getView(host, key);
+    return {
+        items: view.items,
+        collectionSchema: view.collectionSchema,
+        propertySchemasById: view.propertySchemasById,
+        propertySchemasByKey: view.propertySchemasByKey,
+        isLoading: view.isLoading,
+        hasMore: view.hasMore,
+        error: view.error,
+    };
+}

package/dist/react/useHostState.d.ts

@@ -0,0 +1,2 @@
+export declare function useCustomBlockHost(): import("../bridge/hostState.js").CustomBlockHostState;
+//# sourceMappingURL=useHostState.d.ts.map

package/dist/react/useHostState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHostState.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/useHostState.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,0DAKjC"}

package/dist/react/useHostState.js

@@ -0,0 +1,5 @@
+import { useSyncExternalStore } from "react";
+import { customBlockHost } from "../bridge/sandboxClient.js";
+export function useCustomBlockHost() {
+    return useSyncExternalStore(customBlockHost.subscribe, customBlockHost.getState);
+}

package/dist/react/useRuntimeState.d.ts

@@ -0,0 +1,66 @@
+import type { NotionBlockId } from "../bridge/ids.js";
+import type { CustomBlockManifest } from "../bridge/manifest.js";
+import type { CustomBlockPage } from "../bridge/pages/page.js";
+import type { NotionParent } from "../bridge/parent.js";
+import type { NotionTheme } from "../bridge/theme.js";
+import type { NotionUser } from "../bridge/users/user.js";
+/**
+ * Returns this custom block's ID. This is stable throughout the block's lifetime.
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const blockId = useBlockId()
+ */
+export declare function useBlockId(): NotionBlockId;
+/**
+ * Returns the block's parent in the document tree. Re-renders when the host sends
+ * a parent location update (e.g. the block moves into a different container).
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const parent = useParent()
+ */
+export declare function useParent(): NotionParent;
+/**
+ * Returns the nearest enclosing page ancestor. Re-renders when the host sends
+ * a page location update.
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const page = usePage()
+ */
+export declare function usePage(): CustomBlockPage;
+/**
+ * Returns the host's current theme. Re-renders on every `themeChanged` message from the host.
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const theme = useTheme()
+ */
+export declare function useTheme(): NotionTheme;
+/**
+ * Returns the viewing user's Notion profile. Re-renders whenever the host sends a
+ * `currentUserChanged` message.
+ *
+ * Throws if called before `initCustomBlock` has resolved. `await` it before mounting.
+ *
+ * @example
+ * const me = useCurrentUser()
+ * console.log(me.id, me.name, me.person.email)
+ */
+export declare function useCurrentUser(): NotionUser;
+/**
+ * Returns the author-declared manifest loaded from `custom_blocks.json` — the semantic
+ * data-source keys plus their declared `name`, `description`, and property declarations.
+ * `null` when the block ships no manifest.
+ *
+ * This is the configuration the block declared, not host-resolved bindings: use
+ * `useDataSource(key)` for rows and resolved schema. Handy for enumerating the declared
+ * data-source keys (e.g. picking a default key, or rendering a key switcher).
+ */
+export declare function useManifest(): CustomBlockManifest | null;
+//# sourceMappingURL=useRuntimeState.d.ts.map

package/dist/react/useRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuntimeState.d.ts","sourceRoot":"","sources":["../../../../../../../../Users/nsarkar/work/custom-blocks/sdk/src/react/useRuntimeState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGzD;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAExC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,IAAI,eAAe,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,WAAW,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAE3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,mBAAmB,GAAG,IAAI,CAExD"}

package/dist/react/useRuntimeState.js

@@ -0,0 +1,73 @@
+import { useSyncExternalStore } from "react";
+import { customBlock } from "../customBlock.js";
+/**
+ * Returns this custom block's ID. This is stable throughout the block's lifetime.
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const blockId = useBlockId()
+ */
+export function useBlockId() {
+    return useSyncExternalStore(customBlock.subscribe, customBlock.getBlockId);
+}
+/**
+ * Returns the block's parent in the document tree. Re-renders when the host sends
+ * a parent location update (e.g. the block moves into a different container).
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const parent = useParent()
+ */
+export function useParent() {
+    return useSyncExternalStore(customBlock.subscribe, customBlock.getParent);
+}
+/**
+ * Returns the nearest enclosing page ancestor. Re-renders when the host sends
+ * a page location update.
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const page = usePage()
+ */
+export function usePage() {
+    return useSyncExternalStore(customBlock.subscribe, customBlock.getPage);
+}
+/**
+ * Returns the host's current theme. Re-renders on every `themeChanged` message from the host.
+ *
+ * Throws if called before `initCustomBlock` has resolved.
+ *
+ * @example
+ * const theme = useTheme()
+ */
+export function useTheme() {
+    return useSyncExternalStore(customBlock.subscribe, customBlock.getTheme);
+}
+/**
+ * Returns the viewing user's Notion profile. Re-renders whenever the host sends a
+ * `currentUserChanged` message.
+ *
+ * Throws if called before `initCustomBlock` has resolved. `await` it before mounting.
+ *
+ * @example
+ * const me = useCurrentUser()
+ * console.log(me.id, me.name, me.person.email)
+ */
+export function useCurrentUser() {
+    return useSyncExternalStore(customBlock.subscribe, customBlock.getCurrentUser);
+}
+/**
+ * Returns the author-declared manifest loaded from `custom_blocks.json` — the semantic
+ * data-source keys plus their declared `name`, `description`, and property declarations.
+ * `null` when the block ships no manifest.
+ *
+ * This is the configuration the block declared, not host-resolved bindings: use
+ * `useDataSource(key)` for rows and resolved schema. Handy for enumerating the declared
+ * data-source keys (e.g. picking a default key, or rendering a key switcher).
+ */
+export function useManifest() {
+    return useSyncExternalStore(customBlock.subscribe, customBlock.getManifest);
+}