@civitai/blocks-react 0.54.0 → 0.55.0

package/README.md

@@ -1196,6 +1196,264 @@ For non-React or advanced use, the transport primitives are exported too:
 `readAllowedOriginsFromEnv`, `getTransport`, and `sendTypedRequest`. Hooks are the
 recommended surface; reach for these only when a hook doesn't fit.
 
+## The `/testing` subexport
+
+`@civitai/blocks-react/testing` is the **host-simulation** entry point: it stands
+in for civitai.com so your block can run in `vitest`/`happy-dom` and in a local
+dev harness. It is a normal, published subpath of a `0.x` package — see
+[Stability](#stability-of-testing) below for exactly what that does and does not
+promise.
+
+**Everything on this subpath is a mock.** No network, no Buzz, no real backend.
+Until `0.55.0` that was not true: `createLiveHost`, which talks to the real
+Civitai backend and spends the token holder's own Buzz, was exported from here
+too, one autocomplete entry from `createMockHost`. It now lives on its own
+subpath — see [The `/live` subexport](#the-live-subexport) below.
+
+### The whole surface
+
+This section is **the one place the surface is written down**, and it is not
+prose: `test/subpathSurfaces.test.ts` parses the two marked regions below and
+fails if they disagree with what `src/testing.tsx` actually exports — in either
+direction. Every other mention of this subpath (module docblock, `AGENTS.md`)
+points here rather than repeating the list, because a second copy is exactly
+what went stale in [#334](https://github.com/civitai/civitai-app-starters/issues/334).
+
+**Values**
+
+<!-- TESTING-SURFACE:VALUES:BEGIN -->
+
+| Export | What it is |
+|---|---|
+| `resetTransport` | Drops the cached singleton transport. Call it in `beforeEach` so each test starts clean. |
+| `createMockHost` | A framework-agnostic fake of the embedding host — answers every `*_RESULT` message, with knobs for generation cost/latency/failure, Buzz balance, app + shared storage, consent, maturity. Returns a `MockHost`; call `.install()` and keep the returned teardown. **No network, no Buzz.** |
+| `readMockHostUrlOptions` | Reads the harness URL toggles (`?viewer` `?consent` `?fail` `?theme` `?pick` `?balance` `?latency` `?seed` …) into a `Partial<MockHostOptions>`. `Harness` applies it for you; call it directly only in a hand-rolled harness. |
+| `Harness` | The React wrapper: installs a `createMockHost` on mount, tears it down on unmount, and renders an optional on-screen outbound-message log. Takes every `MockHostOptions` field plus `applyUrlToggles` and `showLog`. |
+
+<!-- TESTING-SURFACE:VALUES:END -->
+
+**Types** — the transitive closure that makes those values nameable: each is the
+declared type of an option, of a `MockHost` member, or of a property of one of
+those, so you can hoist a sub-object out of an options literal and give it a
+type.
+
+<!-- TESTING-SURFACE:TYPES:BEGIN -->
+
+```text
+CannedPick
+CostSpec
+HarnessProps
+ImageSpec
+MockBuzzBalance
+MockBuzzHandle
+MockBuzzScenario
+MockCannedImageScan
+MockGenerationScenario
+MockHost
+MockHostFailMode
+MockHostOptions
+MockHostScenarioPatch
+MockSharedScenario
+MockSharedSeed
+MockStorageScenario
+```
+
+<!-- TESTING-SURFACE:TYPES:END -->
+
+That is the complete list. Nothing else is exported.
+
+### In a test
+
+```ts
+import {
+  createMockHost,
+  resetTransport,
+  type MockHostOptions,
+  type MockGenerationScenario,
+} from '@civitai/blocks-react/testing';
+
+resetTransport();
+
+// Hoisting a sub-object out of the options literal is why the scenario types
+// are exported.
+const generation: MockGenerationScenario = { costPerGen: 12, latencyMs: 0 };
+const options: MockHostOptions = { viewer: null, failMode: 'some', generation };
+
+const host = createMockHost(options);
+const uninstall = host.install();
+host.setScenario({ failMode: 'none' });   // live-tune mid-test
+uninstall();
+```
+
+### In a dev harness
+
+```tsx
+import { Harness } from '@civitai/blocks-react/testing';
+
+export function DevRoot() {
+  return (
+    <Harness failMode="some" showLog>
+      <App />
+    </Harness>
+  );
+}
+```
+
+`<Harness>` fires host messages from `window.location.origin`, and the transport
+drops inbound messages from origins outside its allowlist — so a dev harness
+must include its own origin, e.g. `VITE_BLOCK_ALLOWED_PARENT_ORIGINS=http://localhost:5173`.
+Otherwise `BLOCK_INIT` never lands.
+
+### Stability of `/testing`
+
+[#334](https://github.com/civitai/civitai-app-starters/issues/334) offered a
+fork: *document the undocumented surface*, **or** *mark the subpath explicitly
+unstable*. This package took the **first** branch, and only the first. The
+section above is that documentation.
+
+Concretely, and with no guarantee beyond what is actually enforced:
+
+- **It is a normal subpath of a `0.x` package**, on the same footing as `.`,
+  `./ui` and `./live` — no stronger, no weaker. Under semver `0.x`, a **minor
+  may break it**. It is not `@internal`, and it is not "unsupported": fleet
+  blocks import it from their dev harnesses and from their test suites.
+- **What is enforced** is that a change to the exported *symbol set* cannot ship
+  silently. `test/subpathSurfaces.test.ts` fails on growth and on shrinkage, and
+  it fails again unless the README section above is updated to match — so any
+  such change is a deliberate edit that a reviewer sees and a changeset names.
+- **What is *not* promised** is the *shape* of the mock-host option and result
+  types. They describe a fake host whose fidelity tracks the real one; a
+  property may be added, tightened or renamed in a minor. The ledger asserts
+  names, not shapes, and deliberately so.
+
+What is *not* listed above is genuinely internal and carries no guarantee. Until
+`0.55.0` this subpath also re-exported 25 symbols with no documentation — the
+catalog client (`fetchCatalog`, `buildCatalogUrl`, `edgeThumb`, `modelToCard`,
+`DEFAULT_LIMIT`, …), the in-harness picker overlay (`openPickerOverlay`),
+`decodeBlockTokenPayload`, `disallowedAccountError`, `mockParentMessage`, and
+the `MockHostProvider` alias — plus `createLiveHost` / `LiveHostOptions`, which
+moved to `./live` rather than disappearing. See the `0.55.0` changelog entry for
+the full list and for the three removals that had a measured fleet consumer. If
+you were importing one of the internal ones, it lives at a path this package
+does not publish — open an issue rather than reaching into `dist/internal/`.
+
+## The `/live` subexport
+
+> ### 🔴 `@civitai/blocks-react/live` spends real Buzz
+>
+> `createLiveHost` forwards the App-Block postMessage protocol to the **real
+> Civitai backend** over a pasted short-lived dev block token —
+> `blocks.submitWorkflow` included — and a successful generation **debits the
+> token holder's own Buzz**. There is no dry-run mode and no confirmation. It
+> exists for one caller: a `pnpm dev:live` harness. **It must never appear in a
+> test suite.** The free one is `createMockHost`, on `./testing`.
+
+### Why it has its own subpath
+
+Until `0.55.0` this code was exported from `./testing`. The argument for moving
+it, in full, is that **a client which spends the caller's money should not be
+reachable through an import path named `testing`** — the import line is the one
+piece of context that travels with every call site, and `…/testing` actively
+asserts the opposite of what this module does. That is
+[#334](https://github.com/civitai/civitai-app-starters/issues/334)'s literal
+closing condition.
+
+Two arguments that were made for this change and **do not hold** — recorded so
+they are not made again:
+
+- **It does not shrink the install.** Measured: **+4,447 B**. See
+  [What the host-simulation subpaths cost you](#what-the-host-simulation-subpaths-cost-you).
+- **It does not close a wrong-autocomplete hazard**, because there was none to
+  close. `createMockHost(options: MockHostOptions = {})` is callable bare;
+  `createLiveHost(options: LiveHostOptions)` takes a **required** argument whose
+  `blockToken` is a **required** short-lived RS256 JWT that a human mints and
+  pastes by hand. `createLiveHost()` and `createLiveHost({})` do not compile, so
+  nobody reaches this module by picking the wrong completion. Earlier revisions
+  of this file, of the changeset, and of #334 called the two signatures
+  "near-identical"; none of them had read the signatures.
+
+### The whole surface
+
+One value and one type. `test/subpathSurfaces.test.ts` pins the runtime export
+set, failing on growth and on shrinkage.
+
+| Export | What it is |
+|---|---|
+| `createLiveHost` | 🔴 **Real backend, real Buzz.** Installs a host that proxies the block's `postMessage` traffic to civitai.com using a dev block token. Returns a handle; call `.install()` and keep the teardown, exactly like `createMockHost`. |
+| `LiveHostOptions` *(type)* | Options for the above. `blockToken` is required; everything else (`backendBaseUrl`, `viewer`, `theme`, `context`, `onOutbound`, …) has a default. |
+
+### In a `dev:live` harness
+
+```ts
+import { createLiveHost, type LiveHostOptions } from '@civitai/blocks-react/live';
+
+// The token is a SHORT-LIVED dev block token pasted into the harness env, never
+// an API key: `POST /api/v1/blocks/dev-token`, ~4h, re-minted by hand.
+const options: LiveHostOptions = {
+  blockToken: devBlockToken,
+  theme: 'dark',
+};
+
+const host = createLiveHost(options);
+const uninstall = host.install();
+```
+
+### Stability of `/live`
+
+The same terms as `./testing`: a normal subpath of a `0.x` package where a minor
+may break it, with the runtime symbol set pinned by
+`test/subpathSurfaces.test.ts` so it cannot change silently.
+
+🔴 One cost worth stating plainly: publishing and documenting this subpath makes
+[#334](https://github.com/civitai/civitai-app-starters/issues/334) **item 3** —
+getting the live-host code out of the tarball entirely — *harder*, not easier.
+`./live` is now a named public entry point, so removing it later is a breaking
+change on a surface consumers pin against, where before it was one export among
+many on a subpath nobody was told to rely on.
+
+## What the host-simulation subpaths cost you
+
+Seven `dist/` modules — 266,790 B of JavaScript plus 77,338 B of `.d.ts` — are
+reachable only from `./testing` and `./live`, and from nothing under `.` or
+`./ui`. Measured by walking the built module graph:
+
+```text
+118,590  dist/internal/mockHost.js        ← ./testing  (createMockHost)
+ 86,688  dist/internal/liveHost.js        ← ./live     (createLiveHost)
+ 29,508  dist/internal/pickerOverlay.js   ← ./live     (via liveHost)
+ 15,351  dist/internal/catalog.js         ← ./live     (via pickerOverlay)
+  9,141  dist/testing.js
+  4,697  dist/internal/consent.js         ← BOTH hosts import it
+  2,815  dist/live.js
+```
+
+**They ship in every install**, production dependency trees included. They are
+tree-shaken out of application *bundles* — no block ships a mock host to a
+browser — so this is `node_modules` weight, not bundle weight.
+
+🔴 **Splitting `createLiveHost` onto its own subpath removed none of this — it
+ADDS 4,447 B of code, and trimming the export list moved nothing either.**
+Measured with `pnpm pack` on both sides of the split, in a detached worktree so
+neither pack is contaminated by the other change in this release: **319 → 323
+entries, 1,590,099 B → 1,597,161 B uncompressed.** The only files that differ are
+
+```text
++6,048  dist/live.*        (new: .js 2,815, .d.ts 2,839, + maps)
+-1,692  dist/testing.*     (the re-export and its docblock leaving)
+   +91  package.json       (the new exports-map key)
++2,615  README.md          (this section)
+```
+
+`liveHost.js`, `pickerOverlay.js` and `catalog.js` do not appear in that diff at
+all — they are byte-identical and still in the tarball. `files` is
+`["dist", "README.md"]` and `tsconfig` compiles all of `src/**/*`, so the
+`exports` map has no bearing whatsoever on tarball contents; it decides only what
+a consumer can *name*.
+**The `/live` split buys safety, not size.** Moving these bytes needs the code
+deleted or published as a second artifact; that is
+[#334](https://github.com/civitai/civitai-app-starters/issues/334) item 3, and it
+is not done here.
+
 ## Examples
 
 Runnable, minimal blocks — one per feature, each with its own README:

package/dist/live.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@civitai/blocks-react/live` — THE REAL BACKEND. THIS SPENDS REAL BUZZ.
+ *
+ * `createLiveHost` forwards the App-Block postMessage protocol to the REAL
+ * Civitai backend over a pasted short-lived dev block token,
+ * `blocks.submitWorkflow` included. A successful generation DEBITS THE TOKEN
+ * HOLDER'S OWN BUZZ. There is no dry-run mode and no confirmation. It exists for
+ * one caller: a `pnpm dev:live` harness. The free one is `createMockHost`, on
+ * `@civitai/blocks-react/testing`.
+ *
+ * WHY ITS OWN SUBPATH (#334): a client that spends the caller's money should not
+ * be reachable through an import path named `testing`. The import line is the
+ * one piece of context that travels with every call site, so it is where the
+ * warning belongs. It does NOT make the package smaller — `files` is
+ * `["dist", "README.md"]` and `tsconfig` compiles the whole source tree, so the
+ * code ships either way.
+ *
+ * Surface, rationale and stability are documented in exactly one place — README
+ * § "The `/live` subexport". Do not restate them here; a second copy is what
+ * went stale and became #334. `test/subpathSurfaces.test.ts` pins this module's
+ * runtime export set.
+ */
+export { createLiveHost, type LiveHostOptions } from './internal/liveHost.js';
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/live.js

@@ -0,0 +1,24 @@
+/**
+ * `@civitai/blocks-react/live` — THE REAL BACKEND. THIS SPENDS REAL BUZZ.
+ *
+ * `createLiveHost` forwards the App-Block postMessage protocol to the REAL
+ * Civitai backend over a pasted short-lived dev block token,
+ * `blocks.submitWorkflow` included. A successful generation DEBITS THE TOKEN
+ * HOLDER'S OWN BUZZ. There is no dry-run mode and no confirmation. It exists for
+ * one caller: a `pnpm dev:live` harness. The free one is `createMockHost`, on
+ * `@civitai/blocks-react/testing`.
+ *
+ * WHY ITS OWN SUBPATH (#334): a client that spends the caller's money should not
+ * be reachable through an import path named `testing`. The import line is the
+ * one piece of context that travels with every call site, so it is where the
+ * warning belongs. It does NOT make the package smaller — `files` is
+ * `["dist", "README.md"]` and `tsconfig` compiles the whole source tree, so the
+ * code ships either way.
+ *
+ * Surface, rationale and stability are documented in exactly one place — README
+ * § "The `/live` subexport". Do not restate them here; a second copy is what
+ * went stale and became #334. `test/subpathSurfaces.test.ts` pins this module's
+ * runtime export set.
+ */
+export { createLiveHost } from './internal/liveHost.js';
+//# sourceMappingURL=live.js.map

package/dist/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAwB,MAAM,wBAAwB,CAAC"}

package/dist/testing.d.ts

@@ -1,32 +1,28 @@
 /**
- * Test-only helpers for `@civitai/blocks-react`. Not part of the runtime
- * surface — block apps should never import from here in production code (the
- * `./testing` subpath keeps accidental prod imports visible in review).
+ * `@civitai/blocks-react/testing` — the HOST-SIMULATION subpath.
  *
- * Exposes:
- *  - `resetTransport` / `mockParentMessage` — low-level test primitives.
- *  - `createMockHost` — a framework-agnostic fake of the civitai.com embedding
- *    host (usable from node/jsdom/happy-dom tests AND a dev harness).
- *  - `<Harness>` / `<MockHostProvider>` — a thin React wrapper that installs a
- *    mock host for local dev, with an optional on-screen message log.
+ * This is NOT "two test helpers". It is the surface a block app's dev harness
+ * and test suite use to stand in for civitai.com: a mock host, a React wrapper
+ * around it, and a transport reset.
  *
- * These replace the ~250-line per-block hand-rolled harness.
+ * EVERYTHING HERE IS A MOCK. No network, no Buzz, no real backend. That is a
+ * property of the subpath, not a claim in a comment: `createLiveHost`, which
+ * spends the token holder's own Buzz, lives at `@civitai/blocks-react/live`
+ * (#334).
+ *
+ * Surface, rationale and stability are documented in exactly one place — README
+ * § "The `/testing` subexport". Do not restate them here; a second copy is what
+ * went stale and became #334. `test/subpathSurfaces.test.ts` pins that ledger to
+ * this module (runtime values and, via the TypeScript checker, types) and to the
+ * README section, failing on growth and on shrinkage alike.
  */
 import { type ReactNode } from 'react';
 import { __resetTransport } from './internal/singleton.js';
 import { type MockHostOptions } from './internal/mockHost.js';
 export { __resetTransport as resetTransport };
-export { createMockHost, readMockHostUrlOptions, disallowedAccountError, type MockHost, type MockHostOptions, type MockHostFailMode, type MockHostScenarioPatch, type MockGenerationScenario, type MockBuzzScenario, type MockBuzzBalance, type MockBuzzHandle, type MockStorageScenario, type MockSharedScenario, type MockSharedSeed, type MockCannedImageScan, type CostSpec, type ImageSpec, type CannedPick, } from './internal/mockHost.js';
-export { createLiveHost, decodeBlockTokenPayload, type LiveHostOptions, } from './internal/liveHost.js';
-export { buildCatalogUrl, fetchCatalog, modelToCard, responseToPage, edgeThumb, cardToCheckpoint, cardToResource, filterCardsByFamily, CATALOG_API_BASE, CATALOG_API_BASE_BLOCKS, DEFAULT_LIMIT, type CatalogQuery, type CatalogCard, type CatalogPage, type CatalogResult, type CatalogModelType, } from './internal/catalog.js';
-export { openPickerOverlay, type PickerOverlayHandle, type PickerSelection, type OpenPickerOptions, } from './internal/pickerOverlay.js';
-/**
- * Builds a `MessageEvent` that mimics a parent-frame postMessage so tests can
- * exercise `IframeTransport.handleMessage` without a real cross-frame setup.
- */
-export declare function mockParentMessage(data: unknown, origin: string): MessageEvent;
+export { createMockHost, readMockHostUrlOptions, type MockHost, type MockHostOptions, type MockHostFailMode, type MockHostScenarioPatch, type MockGenerationScenario, type MockBuzzScenario, type MockBuzzBalance, type MockBuzzHandle, type MockStorageScenario, type MockSharedScenario, type MockSharedSeed, type MockCannedImageScan, type CostSpec, type ImageSpec, type CannedPick, } from './internal/mockHost.js';
 /**
- * Props for the dev `<Harness>` (a.k.a. {@link MockHostProvider}).
+ * Props for the dev {@link Harness}.
  */
 export interface HarnessProps extends MockHostOptions {
     /** The block app to render inside the mocked host. */
@@ -66,6 +62,4 @@ export interface HarnessProps extends MockHostOptions {
  * );
  */
 export declare function Harness({ children, applyUrlToggles, showLog, ...options }: HarnessProps): import("react/jsx-runtime").JSX.Element;
-/** Alias of {@link Harness} — same component, clearer name when used as a context provider. */
-export declare const MockHostProvider: typeof Harness;
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,IAAI,cAAc,EAAE,CAAC;AAE9C,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAE7E;AAOD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,sDAAsD;IACtD,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,eAAsB,EACtB,OAAc,EACd,GAAG,OAAO,EACX,EAAE,YAAY,2CAuEd;AAED,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,gBAAU,CAAC"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,IAAI,cAAc,EAAE,CAAC;AAE9C,OAAO,EACL,cAAc,EACd,sBAAsB,EAKtB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,wBAAwB,CAAC;AAYhC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,sDAAsD;IACtD,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EACR,eAAsB,EACtB,OAAc,EACd,GAAG,OAAO,EACX,EAAE,YAAY,2CAuEd"}

package/dist/testing.js

@@ -1,33 +1,27 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * Test-only helpers for `@civitai/blocks-react`. Not part of the runtime
- * surface — block apps should never import from here in production code (the
- * `./testing` subpath keeps accidental prod imports visible in review).
+ * `@civitai/blocks-react/testing` — the HOST-SIMULATION subpath.
  *
- * Exposes:
- *  - `resetTransport` / `mockParentMessage` — low-level test primitives.
- *  - `createMockHost` — a framework-agnostic fake of the civitai.com embedding
- *    host (usable from node/jsdom/happy-dom tests AND a dev harness).
- *  - `<Harness>` / `<MockHostProvider>` — a thin React wrapper that installs a
- *    mock host for local dev, with an optional on-screen message log.
+ * This is NOT "two test helpers". It is the surface a block app's dev harness
+ * and test suite use to stand in for civitai.com: a mock host, a React wrapper
+ * around it, and a transport reset.
  *
- * These replace the ~250-line per-block hand-rolled harness.
+ * EVERYTHING HERE IS A MOCK. No network, no Buzz, no real backend. That is a
+ * property of the subpath, not a claim in a comment: `createLiveHost`, which
+ * spends the token holder's own Buzz, lives at `@civitai/blocks-react/live`
+ * (#334).
+ *
+ * Surface, rationale and stability are documented in exactly one place — README
+ * § "The `/testing` subexport". Do not restate them here; a second copy is what
+ * went stale and became #334. `test/subpathSurfaces.test.ts` pins that ledger to
+ * this module (runtime values and, via the TypeScript checker, types) and to the
+ * README section, failing on growth and on shrinkage alike.
  */
 import { useEffect, useRef, useState } from 'react';
 import { __resetTransport } from './internal/singleton.js';
 import { createMockHost, readMockHostUrlOptions, } from './internal/mockHost.js';
 export { __resetTransport as resetTransport };
-export { createMockHost, readMockHostUrlOptions, disallowedAccountError, } from './internal/mockHost.js';
-export { createLiveHost, decodeBlockTokenPayload, } from './internal/liveHost.js';
-export { buildCatalogUrl, fetchCatalog, modelToCard, responseToPage, edgeThumb, cardToCheckpoint, cardToResource, filterCardsByFamily, CATALOG_API_BASE, CATALOG_API_BASE_BLOCKS, DEFAULT_LIMIT, } from './internal/catalog.js';
-export { openPickerOverlay, } from './internal/pickerOverlay.js';
-/**
- * Builds a `MessageEvent` that mimics a parent-frame postMessage so tests can
- * exercise `IframeTransport.handleMessage` without a real cross-frame setup.
- */
-export function mockParentMessage(data, origin) {
-    return new MessageEvent('message', { data, origin, source: null });
-}
+export { createMockHost, readMockHostUrlOptions, } from './internal/mockHost.js';
 /**
  * What the harness chrome's `consent=` readout says, from the TWO INDEPENDENT
  * booleans that describe consent in the mock host.
@@ -124,8 +118,6 @@ export function Harness({ children, applyUrlToggles = true, showLog = true, ...o
                                 .map((m, i) => `${i + 1}. ${m.type} ${JSON.stringify(m.payload ?? {})}`)
                                 .join('\n') })] }))] }));
 }
-/** Alias of {@link Harness} — same component, clearer name when used as a context provider. */
-export const MockHostProvider = Harness;
 // Minimal console / terminal aesthetic: dark terminal slab, monospace, a
 // subtle accent top border, dim chrome text with brighter accents for the
 // live readout values. Compact + unobtrusive — shared chrome rendered by

package/dist/testing.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@civitai/blocks-react",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "description": "React hooks and iframe transport for Civitai Apps. Pairs with @civitai/app-sdk/blocks.",
   "license": "MIT",
   "type": "module",
@@ -21,6 +21,10 @@
     "./testing": {
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
+    },
+    "./live": {
+      "types": "./dist/live.d.ts",
+      "import": "./dist/live.js"
     }
   },
   "files": [
@@ -31,8 +35,8 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@civitai/components": "0.4.1",
-    "@civitai/theme": "0.3.1"
+    "@civitai/theme": "0.3.1",
+    "@civitai/components": "0.4.1"
   },
   "comment-peerDependencies": [
     "The @civitai/app-sdk floor is DERIVED, not chosen: it is the lowest published",
@@ -153,7 +157,7 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.9.2",
     "vitest": "^4.1.11",
-    "@civitai/app-sdk": "^0.47.0"
+    "@civitai/app-sdk": "^0.48.0"
   },
   "publishConfig": {
     "access": "public"