@civitai/blocks-react 0.31.0 → 0.32.0

package/README.md

@@ -479,6 +479,47 @@ function MatureSection() {
 }
 ```
 
+## Direct-load fallback ("Open on Civitai")
+
+A block is served from its own origin `<slug>.civit.ai` but is designed to run
+**embedded** in the Civitai host iframe at `civitai.com/apps/run/<slug>`, which
+delivers the runtime context via the `BLOCK_INIT` handshake. If someone opens the
+bare `<slug>.civit.ai` URL **directly** (a shared link, a social crawl), no parent
+ever sends `BLOCK_INIT`, so `ready` never flips and the block hangs on its loading
+spinner forever.
+
+Wrap your app root once in `<BlockGate>` (from `/ui`) to degrade that into a
+branded landing instead:
+
+```tsx
+import { BlockGate } from '@civitai/blocks-react/ui';
+
+// A DIRECT (unembedded) top-level load shows an "Open on Civitai" card linking to
+// civitai.com/apps/run/<slug>. Embedded — and the dev harness, which posts a fake
+// BLOCK_INIT — are a transparent pass-through, so the happy path is unchanged.
+createRoot(container).render(
+  <BlockGate>
+    <App />
+  </BlockGate>,
+);
+```
+
+The trigger is precise: the fallback shows **only** when the block is top-level
+(`window.self === window.top`) **and** no `BLOCK_INIT` arrives within a short
+timeout (`~2s`, override with `<BlockGate timeoutMs={…}>`). Framed blocks never
+trip it; the harness posts `BLOCK_INIT` immediately, so it never trips there
+either. On a non-`*.civit.ai` host (e.g. `localhost` in dev), it shows a neutral
+"waiting for the host" state — never a broken `apps/run/localhost` link.
+
+Building your own landing? The primitives are exported from the package root:
+
+```tsx
+import { useDirectLoad, hostToRunUrl } from '@civitai/blocks-react';
+
+const directLoad = useDirectLoad();            // true iff top-level AND no BLOCK_INIT within the timeout
+const runUrl = hostToRunUrl('my-app.civit.ai'); // 'https://civitai.com/apps/run/my-app' | null (null = not a civit.ai host)
+```
+
 ## The `/ui` subexport
 
 Opinionated components, imported separately so a transport-only block stays lean.

package/dist/hooks/useDirectLoad.d.ts

@@ -0,0 +1,32 @@
+export interface UseDirectLoadOptions {
+    /**
+     * Milliseconds to wait for `BLOCK_INIT` before treating a top-level load as a
+     * direct (unembedded) load. Defaults to {@link DIRECT_LOAD_TIMEOUT_MS}.
+     */
+    timeoutMs?: number;
+}
+/**
+ * Detect a DIRECT (unembedded) top-level load of a block and, after a short
+ * grace period, report it so the SDK can show an "Open on Civitai" fallback
+ * instead of hanging on the perpetual loading state.
+ *
+ * Returns `true` ONLY when BOTH hold:
+ *  1. The block is TOP-LEVEL (`window.self === window.top` — not in the host
+ *     iframe), AND
+ *  2. No `BLOCK_INIT` has landed (`ready` is still `false`) within `timeoutMs`.
+ *
+ * This is precise by construction:
+ *  - An EMBEDDED block (framed) is never top-level → always `false`, even before
+ *    `ready`. The embedded happy path is untouched.
+ *  - The dev harness / `createMockHost` runs the block top-level BUT posts
+ *    `BLOCK_INIT` immediately (a `setTimeout(0)` macrotask), so `ready` flips
+ *    long before `timeoutMs` and the timer is cleared → always `false`. The dev
+ *    flow is untouched.
+ *  - A real direct load (nobody sends `BLOCK_INIT`) stays top-level + not-ready
+ *    past `timeoutMs` → `true`.
+ *
+ * Once `ready` flips it stays authoritative: this can never return `true` while
+ * `ready` is `true`, so a late init can't leave a stuck fallback.
+ */
+export declare function useDirectLoad(options?: UseDirectLoadOptions): boolean;
+//# sourceMappingURL=useDirectLoad.d.ts.map

package/dist/hooks/useDirectLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDirectLoad.d.ts","sourceRoot":"","sources":["../../src/hooks/useDirectLoad.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAerE"}

package/dist/hooks/useDirectLoad.js

@@ -0,0 +1,64 @@
+import { useEffect, useState } from 'react';
+import { DIRECT_LOAD_TIMEOUT_MS } from '../internal/directLoad.js';
+import { useTransportSnapshot } from './useBlockContext.js';
+/**
+ * True iff the current window is the TOP-LEVEL browsing context — i.e. the
+ * block is NOT running inside an iframe.
+ *
+ * Uses the `window.self === window.top` IDENTITY comparison, which is always
+ * safe: it never reads a property off a (potentially cross-origin) parent, so
+ * it cannot throw a SecurityError the way `window.top.location` would. When
+ * embedded in the civitai host, `window.top` is the host's top frame — a
+ * different object — so this is `false`; when loaded directly it is `true`.
+ */
+function isTopLevel() {
+    if (typeof window === 'undefined')
+        return false; // SSR / no DOM → not a direct browser load
+    try {
+        return window.self === window.top;
+    }
+    catch {
+        // Defensive: if some exotic engine throws on the identity read, treat it as
+        // embedded (fail safe — never show the fallback to a genuinely-framed block).
+        return false;
+    }
+}
+/**
+ * Detect a DIRECT (unembedded) top-level load of a block and, after a short
+ * grace period, report it so the SDK can show an "Open on Civitai" fallback
+ * instead of hanging on the perpetual loading state.
+ *
+ * Returns `true` ONLY when BOTH hold:
+ *  1. The block is TOP-LEVEL (`window.self === window.top` — not in the host
+ *     iframe), AND
+ *  2. No `BLOCK_INIT` has landed (`ready` is still `false`) within `timeoutMs`.
+ *
+ * This is precise by construction:
+ *  - An EMBEDDED block (framed) is never top-level → always `false`, even before
+ *    `ready`. The embedded happy path is untouched.
+ *  - The dev harness / `createMockHost` runs the block top-level BUT posts
+ *    `BLOCK_INIT` immediately (a `setTimeout(0)` macrotask), so `ready` flips
+ *    long before `timeoutMs` and the timer is cleared → always `false`. The dev
+ *    flow is untouched.
+ *  - A real direct load (nobody sends `BLOCK_INIT`) stays top-level + not-ready
+ *    past `timeoutMs` → `true`.
+ *
+ * Once `ready` flips it stays authoritative: this can never return `true` while
+ * `ready` is `true`, so a late init can't leave a stuck fallback.
+ */
+export function useDirectLoad(options) {
+    const timeoutMs = options?.timeoutMs ?? DIRECT_LOAD_TIMEOUT_MS;
+    const ready = useTransportSnapshot().ready;
+    // Sampled once per mount — top-level-ness doesn't change during a page's life.
+    const [topLevel] = useState(isTopLevel);
+    const [elapsed, setElapsed] = useState(false);
+    useEffect(() => {
+        // No timer needed when embedded, or once BLOCK_INIT has already landed.
+        if (ready || !topLevel)
+            return;
+        const id = setTimeout(() => setElapsed(true), timeoutMs);
+        return () => clearTimeout(id);
+    }, [ready, topLevel, timeoutMs]);
+    return topLevel && !ready && elapsed;
+}
+//# sourceMappingURL=useDirectLoad.js.map

package/dist/hooks/useDirectLoad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDirectLoad.js","sourceRoot":"","sources":["../../src/hooks/useDirectLoad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAU5D;;;;;;;;;GASG;AACH,SAAS,UAAU;IACjB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC,CAAC,2CAA2C;IAC5F,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,GAAG,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,8EAA8E;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,OAA8B;IAC1D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,sBAAsB,CAAC;IAC/D,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC,KAAK,CAAC;IAC3C,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAU,UAAU,CAAC,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,SAAS,CAAC,GAAG,EAAE;QACb,wEAAwE;QACxE,IAAI,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC/B,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAEjC,OAAO,QAAQ,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -52,6 +52,9 @@ export { useDomainMaturity } from './hooks/useDomainMaturity.js';
 export type { DomainMaturity } from './hooks/useDomainMaturity.js';
 export { SfwGate } from './hooks/SfwGate.js';
 export type { SfwGateProps } from './hooks/SfwGate.js';
+export { useDirectLoad } from './hooks/useDirectLoad.js';
+export type { UseDirectLoadOptions } from './hooks/useDirectLoad.js';
+export { hostToRunUrl, DIRECT_LOAD_TIMEOUT_MS } from './internal/directLoad.js';
 export { useAppStorage } from './hooks/useAppStorage.js';
 export type { AppStorageKeyEntry, AppStorageListResult, AppStorageQuota, UseAppStorage, } from './hooks/useAppStorage.js';
 export { useSharedStorage } from './hooks/useSharedStorage.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -38,6 +38,8 @@ export { useRequestConsent } from './hooks/useRequestConsent.js';
 export { useBlockAnalytics } from './hooks/useBlockAnalytics.js';
 export { useDomainMaturity } from './hooks/useDomainMaturity.js';
 export { SfwGate } from './hooks/SfwGate.js';
+export { useDirectLoad } from './hooks/useDirectLoad.js';
+export { hostToRunUrl, DIRECT_LOAD_TIMEOUT_MS } from './internal/directLoad.js';
 export { useAppStorage } from './hooks/useAppStorage.js';
 export { useSharedStorage } from './hooks/useSharedStorage.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAa3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAa3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/internal/directLoad.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Direct-load (unembedded) detection helpers.
+ *
+ * A block is served from its OWN origin `<slug>.civit.ai` but is designed to
+ * run EMBEDDED inside the civitai.com host iframe at
+ * `civitai.com/apps/run/<slug>`, which delivers the runtime context (viewer,
+ * scoped token, theme) via the postMessage `BLOCK_INIT` handshake. When a block
+ * is opened DIRECTLY — a top-level navigation to its bare `<slug>.civit.ai`
+ * origin (shared link, social crawl, someone pasting the URL) — no parent ever
+ * sends `BLOCK_INIT`, so the block's `ready` gate never flips and it hangs on a
+ * loading spinner forever. These helpers let the SDK degrade that into a
+ * branded "Open on Civitai" landing.
+ *
+ * Pure + framework-agnostic on purpose — {@link hostToRunUrl} is exhaustively
+ * unit-testable, and the React glue (the `useDirectLoad` hook + the
+ * `<BlockGate>` / `<DirectLoadFallback>` UI) builds on it.
+ */
+/**
+ * Default milliseconds to wait for `BLOCK_INIT` before concluding a TOP-LEVEL
+ * load is a direct (unembedded) load and showing the fallback.
+ *
+ * Chosen well ABOVE the dev harness's init latency and below anything a human
+ * would tolerate staring at a spinner. The `createMockHost` / `<Harness>` dev
+ * host posts `BLOCK_INIT` on a `setTimeout(0)` macrotask (see
+ * `mockHost.ts` → `after(0, … BLOCK_INIT …)`), so `ready` flips almost
+ * immediately there and this timeout NEVER elapses in the harness — the
+ * fallback is reserved for the genuine "nobody is ever going to send
+ * BLOCK_INIT" case. Overridable via the hook/component `timeoutMs` prop.
+ */
+export declare const DIRECT_LOAD_TIMEOUT_MS = 2000;
+/** The Civitai host that serves the embedded block run route. */
+export declare const CIVITAI_HOST = "civitai.com";
+/** The deployed-block origin suffix (`<slug>.civit.ai`). */
+export declare const CIVIT_AI_SUFFIX = ".civit.ai";
+/**
+ * Derive the canonical Civitai host route for a block served from a
+ * `<slug>.civit.ai` origin.
+ *
+ * - A deployed block host (`<slug>.civit.ai`) → `https://civitai.com/apps/run/<slug>`,
+ *   where the slug is the FIRST DNS label of the hostname.
+ * - Anything else — `localhost` (dev without the harness), an IP, a bare
+ *   `civit.ai`, or a non-civit.ai host — → `null`. The caller MUST NOT render a
+ *   `civitai.com/apps/run/…` redirect in that case (there is no meaningful
+ *   target — never a broken `apps/run/localhost` link); show a neutral
+ *   "waiting for the host" state instead.
+ *
+ * Case-insensitive (hostnames are), tolerant of a trailing FQDN dot.
+ *
+ * @example hostToRunUrl('model-benchmarking.civit.ai') // 'https://civitai.com/apps/run/model-benchmarking'
+ * @example hostToRunUrl('localhost')                   // null
+ * @example hostToRunUrl('civit.ai')                    // null
+ */
+export declare function hostToRunUrl(hostname: string | null | undefined): string | null;
+//# sourceMappingURL=directLoad.d.ts.map

package/dist/internal/directLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directLoad.d.ts","sourceRoot":"","sources":["../../src/internal/directLoad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,iEAAiE;AACjE,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,eAAe,cAAc,CAAC;AAK3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAgB/E"}

package/dist/internal/directLoad.js

@@ -0,0 +1,76 @@
+/**
+ * Direct-load (unembedded) detection helpers.
+ *
+ * A block is served from its OWN origin `<slug>.civit.ai` but is designed to
+ * run EMBEDDED inside the civitai.com host iframe at
+ * `civitai.com/apps/run/<slug>`, which delivers the runtime context (viewer,
+ * scoped token, theme) via the postMessage `BLOCK_INIT` handshake. When a block
+ * is opened DIRECTLY — a top-level navigation to its bare `<slug>.civit.ai`
+ * origin (shared link, social crawl, someone pasting the URL) — no parent ever
+ * sends `BLOCK_INIT`, so the block's `ready` gate never flips and it hangs on a
+ * loading spinner forever. These helpers let the SDK degrade that into a
+ * branded "Open on Civitai" landing.
+ *
+ * Pure + framework-agnostic on purpose — {@link hostToRunUrl} is exhaustively
+ * unit-testable, and the React glue (the `useDirectLoad` hook + the
+ * `<BlockGate>` / `<DirectLoadFallback>` UI) builds on it.
+ */
+/**
+ * Default milliseconds to wait for `BLOCK_INIT` before concluding a TOP-LEVEL
+ * load is a direct (unembedded) load and showing the fallback.
+ *
+ * Chosen well ABOVE the dev harness's init latency and below anything a human
+ * would tolerate staring at a spinner. The `createMockHost` / `<Harness>` dev
+ * host posts `BLOCK_INIT` on a `setTimeout(0)` macrotask (see
+ * `mockHost.ts` → `after(0, … BLOCK_INIT …)`), so `ready` flips almost
+ * immediately there and this timeout NEVER elapses in the harness — the
+ * fallback is reserved for the genuine "nobody is ever going to send
+ * BLOCK_INIT" case. Overridable via the hook/component `timeoutMs` prop.
+ */
+export const DIRECT_LOAD_TIMEOUT_MS = 2000;
+/** The Civitai host that serves the embedded block run route. */
+export const CIVITAI_HOST = 'civitai.com';
+/** The deployed-block origin suffix (`<slug>.civit.ai`). */
+export const CIVIT_AI_SUFFIX = '.civit.ai';
+/** A single DNS label (the slug), lowercased. */
+const DNS_LABEL = /^[a-z0-9-]+$/;
+/**
+ * Derive the canonical Civitai host route for a block served from a
+ * `<slug>.civit.ai` origin.
+ *
+ * - A deployed block host (`<slug>.civit.ai`) → `https://civitai.com/apps/run/<slug>`,
+ *   where the slug is the FIRST DNS label of the hostname.
+ * - Anything else — `localhost` (dev without the harness), an IP, a bare
+ *   `civit.ai`, or a non-civit.ai host — → `null`. The caller MUST NOT render a
+ *   `civitai.com/apps/run/…` redirect in that case (there is no meaningful
+ *   target — never a broken `apps/run/localhost` link); show a neutral
+ *   "waiting for the host" state instead.
+ *
+ * Case-insensitive (hostnames are), tolerant of a trailing FQDN dot.
+ *
+ * @example hostToRunUrl('model-benchmarking.civit.ai') // 'https://civitai.com/apps/run/model-benchmarking'
+ * @example hostToRunUrl('localhost')                   // null
+ * @example hostToRunUrl('civit.ai')                    // null
+ */
+export function hostToRunUrl(hostname) {
+    if (!hostname)
+        return null;
+    // Normalize: trim, lowercase, strip any trailing FQDN dot(s). The trailing-dot
+    // strip is a manual linear trim rather than a `/\.+$/` regex, which backtracks
+    // O(n^2) on a string of many dots (ReDoS — CodeQL js/polynomial-redos).
+    const normalized = hostname.trim().toLowerCase();
+    let end = normalized.length;
+    while (end > 0 && normalized.charCodeAt(end - 1) === 46 /* '.' */)
+        end -= 1;
+    const host = normalized.slice(0, end);
+    if (!host.endsWith(CIVIT_AI_SUFFIX))
+        return null; // not a deployed block host
+    // The slug is the FIRST DNS label (`<slug>.civit.ai`). Extra labels beyond
+    // the first are ignored — deployed block origins are single-label — but the
+    // first label must be a valid, non-empty DNS label.
+    const slug = host.slice(0, host.length - CIVIT_AI_SUFFIX.length).split('.')[0] ?? '';
+    if (!slug || !DNS_LABEL.test(slug))
+        return null;
+    return `https://${CIVITAI_HOST}/apps/run/${slug}`;
+}
+//# sourceMappingURL=directLoad.js.map

package/dist/internal/directLoad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directLoad.js","sourceRoot":"","sources":["../../src/internal/directLoad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,iDAAiD;AACjD,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,QAAmC;IAC9D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,+EAA+E;IAC/E,+EAA+E;IAC/E,wEAAwE;IACxE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC;IAC5B,OAAO,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS;QAAE,GAAG,IAAI,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAC9E,2EAA2E;IAC3E,4EAA4E;IAC5E,oDAAoD;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrF,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,WAAW,YAAY,aAAa,IAAI,EAAE,CAAC;AACpD,CAAC"}

package/dist/ui/BlockGate.d.ts

@@ -0,0 +1,79 @@
+import { type ReactNode } from 'react';
+/**
+ * Props for {@link DirectLoadFallback}.
+ */
+export interface DirectLoadFallbackProps {
+    /**
+     * Override the hostname used to derive the `civitai.com/apps/run/<slug>` URL.
+     * Defaults to `window.location.hostname`. Primarily a testing seam.
+     */
+    hostname?: string;
+    /**
+     * When set (and a run URL could be derived), auto-navigate the top window to
+     * the run URL after this many milliseconds. OFF by default — a click-to-open
+     * landing is the safe default (no surprise navigation; good for shared links,
+     * social unfurls, and SEO). The visible button is always the primary path.
+     */
+    autoRedirectMs?: number;
+}
+/**
+ * The branded "Open on Civitai" landing shown when a block is loaded DIRECTLY
+ * (top-level at its bare `<slug>.civit.ai` origin) instead of embedded in the
+ * civitai host — the graceful degrade for what would otherwise be a perpetual
+ * loading spinner.
+ *
+ * Two states, chosen from the (overridable) hostname:
+ *  - Deployed block host (`<slug>.civit.ai`): a card with an "Open on Civitai"
+ *    link to `https://civitai.com/apps/run/<slug>` (a real anchor — right/middle
+ *    click, shareable, crawlable). Optional {@link DirectLoadFallbackProps.autoRedirectMs}
+ *    auto-redirect on top of the button.
+ *  - Non-civit.ai host (e.g. `localhost` in dev without the harness): a neutral
+ *    "waiting for the Civitai host" card with a dev hint — NEVER a broken
+ *    `apps/run/localhost` link.
+ *
+ * Theme-aware via `prefers-color-scheme` (there is no host `theme` on a direct
+ * load) and styled with the `/ui` pack's tokens.
+ */
+export declare function DirectLoadFallback({ hostname, autoRedirectMs, }: DirectLoadFallbackProps): React.JSX.Element;
+/**
+ * Props for {@link BlockGate}.
+ */
+export interface BlockGateProps {
+    /** The block app. Rendered whenever the block is NOT a direct (unembedded) load. */
+    children: ReactNode;
+    /**
+     * Milliseconds to wait for `BLOCK_INIT` before treating a top-level load as a
+     * direct load. Forwarded to {@link useDirectLoad}. Defaults to 2000ms.
+     */
+    timeoutMs?: number;
+    /** Override the fallback rendered on a direct load. Defaults to {@link DirectLoadFallback}. */
+    fallback?: ReactNode;
+    /** Forwarded to the default {@link DirectLoadFallback} (testing seam). */
+    hostname?: string;
+    /** Forwarded to the default {@link DirectLoadFallback}. */
+    autoRedirectMs?: number;
+}
+/**
+ * Drop-in wrapper that shows the {@link DirectLoadFallback} when a block is
+ * loaded DIRECTLY (top-level, no `BLOCK_INIT` within the timeout) and otherwise
+ * renders `children` unchanged.
+ *
+ * Wrap your app root once so EVERY SDK-built block degrades gracefully instead
+ * of hanging on a loading spinner when its `<slug>.civit.ai` URL is opened
+ * directly:
+ *
+ * ```tsx
+ * import { BlockGate } from '@civitai/blocks-react/ui';
+ *
+ * createRoot(el).render(
+ *   <BlockGate>
+ *     <App />
+ *   </BlockGate>,
+ * );
+ * ```
+ *
+ * The embedded happy path and the dev harness are untouched — see
+ * {@link useDirectLoad} for exactly why the trigger can't fire in either.
+ */
+export declare function BlockGate({ children, timeoutMs, fallback, hostname, autoRedirectMs, }: BlockGateProps): React.JSX.Element;
+//# sourceMappingURL=BlockGate.d.ts.map

package/dist/ui/BlockGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockGate.d.ts","sourceRoot":"","sources":["../../src/ui/BlockGate.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAkD5D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,cAAc,GACf,EAAE,uBAAuB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+D7C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,cAAc,GACf,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpC"}

package/dist/ui/BlockGate.js

@@ -0,0 +1,143 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { hostToRunUrl } from '../internal/directLoad.js';
+import { useDirectLoad } from '../hooks/useDirectLoad.js';
+import { Card } from './Card.js';
+import { Stack } from './Stack.js';
+import { useBlocksStyles } from './styles.js';
+/**
+ * Read the OS/browser color-scheme preference, live.
+ *
+ * A directly-loaded block has NO `BLOCK_INIT`, so there is no host `theme` to
+ * set `data-theme` from (the usual gotcha-#60 path). We fall back to
+ * `prefers-color-scheme` so the fallback card still themes correctly in light
+ * AND dark. Guarded for SSR / engines without `matchMedia`.
+ */
+function usePrefersColorScheme() {
+    const [dark, setDark] = useState(() => {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+            return false;
+        try {
+            return window.matchMedia('(prefers-color-scheme: dark)').matches;
+        }
+        catch {
+            return false;
+        }
+    });
+    useEffect(() => {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+            return;
+        let mql;
+        try {
+            mql = window.matchMedia('(prefers-color-scheme: dark)');
+        }
+        catch {
+            return;
+        }
+        const onChange = (e) => setDark(e.matches);
+        // Modern browsers: addEventListener. Older Safari: addListener.
+        if (typeof mql.addEventListener === 'function') {
+            mql.addEventListener('change', onChange);
+            return () => mql.removeEventListener('change', onChange);
+        }
+        if (typeof mql.addListener === 'function') {
+            mql.addListener(onChange);
+            return () => mql.removeListener(onChange);
+        }
+        return;
+    }, []);
+    return dark ? 'dark' : 'light';
+}
+const wrapperStyle = {
+    minHeight: '100%',
+    minWidth: 0,
+    display: 'flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 24,
+    boxSizing: 'border-box',
+    background: 'var(--ci-color-surface-2)',
+    color: 'var(--ci-color-text)',
+};
+const brandStyle = {
+    fontSize: 12,
+    fontWeight: 700,
+    letterSpacing: '0.08em',
+    textTransform: 'uppercase',
+    color: 'var(--ci-color-primary)',
+};
+const titleStyle = { fontSize: 18, fontWeight: 700 };
+const bodyStyle = {
+    fontSize: 14,
+    lineHeight: 1.5,
+    color: 'var(--ci-color-text-dimmed)',
+};
+/**
+ * The branded "Open on Civitai" landing shown when a block is loaded DIRECTLY
+ * (top-level at its bare `<slug>.civit.ai` origin) instead of embedded in the
+ * civitai host — the graceful degrade for what would otherwise be a perpetual
+ * loading spinner.
+ *
+ * Two states, chosen from the (overridable) hostname:
+ *  - Deployed block host (`<slug>.civit.ai`): a card with an "Open on Civitai"
+ *    link to `https://civitai.com/apps/run/<slug>` (a real anchor — right/middle
+ *    click, shareable, crawlable). Optional {@link DirectLoadFallbackProps.autoRedirectMs}
+ *    auto-redirect on top of the button.
+ *  - Non-civit.ai host (e.g. `localhost` in dev without the harness): a neutral
+ *    "waiting for the Civitai host" card with a dev hint — NEVER a broken
+ *    `apps/run/localhost` link.
+ *
+ * Theme-aware via `prefers-color-scheme` (there is no host `theme` on a direct
+ * load) and styled with the `/ui` pack's tokens.
+ */
+export function DirectLoadFallback({ hostname, autoRedirectMs, }) {
+    useBlocksStyles();
+    const theme = usePrefersColorScheme();
+    const resolvedHost = hostname ?? (typeof window !== 'undefined' ? window.location?.hostname : undefined);
+    const runUrl = hostToRunUrl(resolvedHost);
+    useEffect(() => {
+        if (!runUrl || autoRedirectMs == null || typeof window === 'undefined')
+            return;
+        const id = setTimeout(() => {
+            try {
+                // Navigate the TOP frame (equals self on a direct load; correct either way).
+                (window.top ?? window).location.href = runUrl;
+            }
+            catch {
+                window.location.href = runUrl;
+            }
+        }, autoRedirectMs);
+        return () => clearTimeout(id);
+    }, [runUrl, autoRedirectMs]);
+    return (_jsx("div", { "data-theme": theme, "data-civitai-block-direct-load": "true", style: wrapperStyle, children: _jsx(Card, { withBorder: true, padding: "lg", style: { maxWidth: 420, width: '100%', textAlign: 'center' }, children: _jsxs(Stack, { gap: 12, align: "center", children: [_jsx("span", { style: brandStyle, children: "Civitai App" }), runUrl ? (_jsxs(_Fragment, { children: [_jsx("strong", { style: titleStyle, children: "Open this app on Civitai" }), _jsx("span", { style: bodyStyle, children: "This is a Civitai App. It runs inside Civitai, where you can sign in and use it." }), _jsx("a", { "data-civitai-ui": "button", "data-variant": "filled", "data-size": "lg", "data-full-width": "true", "data-civitai-block-open-on-civitai": "true", href: runUrl, target: "_top", rel: "noopener", children: "Open on Civitai" })] })) : (_jsxs(_Fragment, { children: [_jsx("strong", { style: titleStyle, children: "Waiting for the Civitai host\u2026" }), _jsx("span", { style: bodyStyle, role: "status", children: "This is a Civitai App. It\u2019s meant to run inside the Civitai host. In local development, load it through the block dev harness." })] }))] }) }) }));
+}
+/**
+ * Drop-in wrapper that shows the {@link DirectLoadFallback} when a block is
+ * loaded DIRECTLY (top-level, no `BLOCK_INIT` within the timeout) and otherwise
+ * renders `children` unchanged.
+ *
+ * Wrap your app root once so EVERY SDK-built block degrades gracefully instead
+ * of hanging on a loading spinner when its `<slug>.civit.ai` URL is opened
+ * directly:
+ *
+ * ```tsx
+ * import { BlockGate } from '@civitai/blocks-react/ui';
+ *
+ * createRoot(el).render(
+ *   <BlockGate>
+ *     <App />
+ *   </BlockGate>,
+ * );
+ * ```
+ *
+ * The embedded happy path and the dev harness are untouched — see
+ * {@link useDirectLoad} for exactly why the trigger can't fire in either.
+ */
+export function BlockGate({ children, timeoutMs, fallback, hostname, autoRedirectMs, }) {
+    const directLoad = useDirectLoad({ timeoutMs });
+    if (directLoad) {
+        return (_jsx(_Fragment, { children: fallback ?? _jsx(DirectLoadFallback, { hostname: hostname, autoRedirectMs: autoRedirectMs }) }));
+    }
+    return _jsx(_Fragment, { children: children });
+}
+//# sourceMappingURL=BlockGate.js.map

package/dist/ui/BlockGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockGate.js","sourceRoot":"","sources":["../../src/ui/BlockGate.tsx"],"names":[],"mappings":"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"}

package/dist/ui/index.d.ts

@@ -17,6 +17,8 @@
  */
 export { SettingsForm, SettingsFormError, isFieldVisible } from './SettingsForm.js';
 export type { SettingsFormProps } from './SettingsForm.js';
+export { BlockGate, DirectLoadFallback } from './BlockGate.js';
+export type { BlockGateProps, DirectLoadFallbackProps } from './BlockGate.js';
 export { injectBlocksStyles, useBlocksStyles, BLOCKS_UI_STYLES, } from './styles.js';
 export { Button } from './Button.js';
 export type { ButtonProps, ButtonVariant, ButtonSize } from './Button.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAK3D,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/ui/index.js

@@ -17,6 +17,10 @@
  */
 // W3 — manifest-driven settings form (host-themed native controls).
 export { SettingsForm, SettingsFormError, isFieldVisible } from './SettingsForm.js';
+// Direct-load (unembedded) fallback — the branded "Open on Civitai" landing
+// that replaces the perpetual loading spinner when a block's <slug>.civit.ai
+// URL is opened top-level instead of embedded in the Civitai host.
+export { BlockGate, DirectLoadFallback } from './BlockGate.js';
 // W6 — runtime style injection.
 export { injectBlocksStyles, useBlocksStyles, BLOCKS_UI_STYLES, } from './styles.js';
 // W6 — component pack.

package/dist/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oEAAoE;AACpE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGpF,gCAAgC;AAChC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oEAAoE;AACpE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGpF,4EAA4E;AAC5E,6EAA6E;AAC7E,mEAAmE;AACnE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG/D,gCAAgC;AAChC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@civitai/blocks-react",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "React hooks and iframe transport for Civitai Apps. Pairs with @civitai/app-sdk/blocks.",
   "license": "MIT",
   "type": "module",
@@ -43,7 +43,7 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.9.2",
     "vitest": "^4.1.7",
-    "@civitai/app-sdk": "^0.25.0"
+    "@civitai/app-sdk": "^0.25.1"
   },
   "publishConfig": {
     "access": "public"