@civitai/blocks-react 0.53.1 → 0.55.0

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.53.1",
+  "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,54 +35,83 @@
     "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",
     "version that exports every symbol this package imports from the peer.",
     "",
-    "🔴 RAISED 0.40.0 -> 0.45.0 when this package began importing two NEW peer VALUE",
-    "symbols -- `boundBlockToParentMessageType` and `OTHER_MESSAGE_TYPE_LABEL`, used by",
-    "`internal/iframeTransport.ts` to bound the `BLOCK_MESSAGE_REJECTED` label. Both",
-    "ship for the first time in the app-sdk minor released alongside this change, so",
-    "0.45.0 is not a margin: it is the first version that has them. Measured against",
-    "the then-latest published 0.44.0 -- which SATISFIED the old range -- both are",
-    "absent from every subpath, and the failure is not a type error: `dist/index.js`",
-    "re-exports `IframeTransport`, so the package's MAIN ENTRY is in the failing module",
-    "graph and the block does not boot at all. Caught by an adversarial audit that",
-    "built the dist and resolved it, not by any gate; the paragraph below says why no",
-    "gate can. Step 4's positive control was run (a symbol that cannot exist reported",
-    "as absent), so the zero for the other symbols is a measurement and not a silent",
-    "pass.",
+    "🔴 RAISED 0.45.0 -> 0.47.0 (THE THIRD TIME THIS CLASS HAS BITTEN: #309, then",
+    "#317 caught it in review, then this) when `internal/mockHost.ts` began importing",
+    "three NEW peer VALUE symbols -- `APP_STORAGE_MAX_BYTES`, `APP_STORAGE_MAX_ROWS`",
+    "and `APP_STORAGE_MAX_VALUE_BYTES`, the App Storage ceilings, which it assigns to",
+    "its mock storage defaults. All three ship for the first time in the app-sdk minor",
+    "released alongside this change.",
+    "",
+    "HOW 0.47.0 WAS DERIVED (computed, not predicted from release ordering):",
+    "  - in-tree `packages/civitai-app-sdk/package.json` is 0.46.0, and 0.46.0 is also",
+    "    `npm view @civitai/app-sdk version` -- the tree is at the last published",
+    "    version, so nothing is mid-flight.",
+    "  - the pending changeset set is exactly ONE file, `.changeset/",
+    "    app-storage-real-ceilings-2026-09-19.md`, declaring `@civitai/app-sdk: minor`;",
+    "    `git ls-tree -r origin/main .changeset/` shows main carries no others.",
+    "  - `pnpm exec changeset status --verbose` on this branch prints",
+    "    `@civitai/app-sdk 0.47.0` (and `@civitai/blocks-react 0.54.0`). That is the",
+    "    tool that will actually run, answering with the number it will actually write.",
     "",
-    "⚠️ 0.45.0 IS A PREDICTION ABOUT RELEASE ORDERING, NOT A MEASURED VERSION. It is",
-    "what the pending minor changeset publishes ONCE THIS BRANCH IS ON TOP OF a main",
-    "where app-sdk is already 0.44.0 and the catalog changeset has been consumed. If",
-    "another minor releases FIRST, the two symbols ship in 0.46.0 while 0.45.0",
-    "publishes WITHOUT them and SATISFIES this range -- #309's shape exactly, the one",
-    "this floor exists to close.",
+    "MEASURED, both directions, against the REAL tarballs (not the workspace copy):",
+    "  - published 0.46.0 -- which the OLD `>=0.45.0` range SATISFIED, installing with",
+    "    no peer warning at all -- does not export any of the three. `node -e` on a",
+    "    scratch `npm i @civitai/app-sdk@0.46.0`:",
+    "      SyntaxError: The requested module '@civitai/app-sdk/blocks'",
+    "        does not provide an export named 'APP_STORAGE_MAX_BYTES'",
+    "    Controls were run BOTH ways before believing that zero: an impossible symbol",
+    "    reported absent (the probe can go red) and `BrowsingLevel`/`SFW_LEVELS`",
+    "    resolved (the probe can see a symbol that IS there).",
+    "  - blast radius is the `./testing` subpath ONLY, and that is measured too, by",
+    "    `pnpm pack`ing this package and importing both entries against 0.46.0:",
+    "    `@civitai/blocks-react` resolved 61 exports fine; `@civitai/blocks-react/",
+    "    testing` threw the SyntaxError above out of `dist/internal/mockHost.js`.",
+    "    `src/testing.tsx` reaches `mockHost`, `src/index.ts` does not -- so the block",
+    "    boots and every dev harness and downstream test suite dies instead.",
+    "  - with the floor at 0.47.0, that same install is refused: npm reports",
+    "    ERESOLVE against `@civitai/app-sdk@0.46.0`.",
     "",
-    "🔴 AND `changeset version` WILL REWRITE THIS RANGE DOWNWARD IF IT RUNS TOO EARLY.",
-    "An earlier revision of this note said onlyUpdatePeerDependentsWhenOutOfRange",
-    "'guarantees changeset version will not correct it'. That is BACKWARDS, and it is",
-    "measured: run on this branch as it stands (app-sdk 0.43.0 in-tree, the catalog",
-    "changeset still present, so app-sdk computes to 0.44.0), `changeset version`",
-    "rewrites `>=0.45.0 <1.0.0` to `>=0.44.0` -- it LOWERS the floor to the exact",
-    "version that lacks the symbols AND drops the upper bound. The flag rewrites a",
-    "peer range precisely when the computed version falls OUT of it. Post-merge it",
-    "computes 0.45.0 and leaves the range alone, which is why this is not a live",
-    "defect -- but never run `changeset version` on this branch before rebasing, and",
-    "re-read the range afterwards rather than trusting the flag to protect it.",
+    "⚠️ THE RESIDUAL RISK IS RELEASE ORDERING, AND IT IS NOT REMOVABLE FROM HERE.",
+    "0.47.0 is the version THIS changeset publishes from THIS base. If another app-sdk",
+    "minor merges and publishes before this PR does, 0.47.0 ships WITHOUT the",
+    "constants, this changeset publishes 0.48.0, and this range admits a broken",
+    "version -- #309's shape exactly. So: RE-RUN `changeset status --verbose` after any",
+    "rebase onto a moved main, and re-read this range. The number here is a",
+    "measurement of a base, and a rebase invalidates the base.",
+    "",
+    "🔴 `changeset version` WILL NOT FIX A STALE FLOOR -- IT IS NOT A BACKSTOP.",
+    "`.changeset/config.json` sets `onlyUpdatePeerDependentsWhenOutOfRange: true`, so a",
+    "peer range is rewritten ONLY when the computed version falls OUT of it. A floor",
+    "that is too LOW is, by construction, still satisfied -- so it is left exactly as",
+    "it is and ships stale. (The flag does bite in the other direction, which an",
+    "earlier note recorded: run before a rebase, when the computed version is BELOW the",
+    "declared floor, it rewrites the range DOWNWARD and drops the upper bound. Both",
+    "readings say the same thing -- never let this number be the flag's problem.)",
     "",
     "🔴 A PEER RANGE IS METADATA AND NOTHING CHECKS IT AGAINST THE CODE. 0.49.0-0.51.0",
     "declared >=0.29.0 while importing `effectiveBrowsingCeiling` (app-sdk 0.39.0) and",
     "the create-post types (0.40.0). The range was SATISFIED, so no install warned;",
     "the failure landed at module evaluation in a consumer's tests, where 27 of 43",
     "test files collected ZERO tests -- 292 tests stopped running and the summary line",
-    "reported no failures. See #309. CI cannot catch this: `pnpm.overrides` maps the",
-    "peer to the workspace copy, so every in-repo typecheck is blind to whatever this",
-    "range says.",
+    "reported no failures. See #309. NO BUILD OR TYPECHECK CAN CATCH THIS:",
+    "`pnpm.overrides` maps the peer to the workspace copy, so every in-repo typecheck,",
+    "test and build resolves the symbol from `packages/civitai-app-sdk` and is",
+    "structurally blind to whatever this range says.",
+    "",
+    "🔴 SINCE #344 ONE GATE DOES SEE PART OF IT: `tests/guards/",
+    "blocks-react-peer-floor.test.mjs` fails when this range admits an app-sdk version",
+    "measured NOT to export the App Storage constants, and when the derivation below",
+    "stops being recorded here. Read its KNOWN LIMITS before relying on it -- CI checks",
+    "out at `fetch-depth: 1` and the guard job has no registry access, so it is",
+    "offline and tree-local: it re-asserts a measurement taken by hand, it does not",
+    "take one. The steps below are still the only way to MAKE the measurement.",
     "",
     "🔴 AND #309'S OWN SUGGESTED FLOOR (>=0.39.0) WAS WRONG. `effectiveBrowsingCeiling`",
     "arrives in 0.39.0, but `BlockCreatePostRequest`, `BlockCreatePostResult`,",
@@ -89,8 +122,10 @@
     "TO RE-DERIVE IT (do this when this package starts importing a new peer symbol):",
     "  1. collect the symbols -- every named `import`/`export … from '@civitai/app-sdk*'`",
     "     clause in src/, plus bare and star forms, which name a SUBPATH and no symbols",
-    "     but still have to resolve. At the time of writing: 62 symbols, 2 subpaths",
-    "     ('/blocks' and '/safe-storage').",
+    "     but still have to resolve. Measured at #344: 64 distinct symbols over 2",
+    "     subpaths ('/blocks' and '/safe-storage'), counting unique names across every",
+    "     named import clause in src/**/*.ts{,x}. An earlier derivation recorded 62;",
+    "     re-count rather than trusting either figure.",
     "  2. in a scratch dir OUTSIDE this workspace (pnpm would resolve the peer to the",
     "     workspace copy and measure nothing), `npm i @civitai/app-sdk@<version>` and",
     "     typecheck a file importing all of them -- each in the POSITION it is imported",
@@ -107,7 +142,7 @@
     "the tool was the expensive half."
   ],
   "peerDependencies": {
-    "@civitai/app-sdk": ">=0.45.0 <1.0.0",
+    "@civitai/app-sdk": ">=0.47.0 <1.0.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
@@ -122,7 +157,7 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.9.2",
     "vitest": "^4.1.11",
-    "@civitai/app-sdk": "^0.46.0"
+    "@civitai/app-sdk": "^0.48.0"
   },
   "publishConfig": {
     "access": "public"