@kubohiroya/turbowarp-asset-cache 0.1.0 → 0.2.1

package/README.md

@@ -4,13 +4,6 @@ A browser-local image, audio, and runtime-text asset cache for TurboWarp project
 
 Asset Cache intentionally keeps the legacy `isLoaded` and cache lifecycle semantics. It is not a general server object store: every block is marked `server.supported: false` in the format 2 manifest. Use [`@kubohiroya/turbowarp-kvs`](https://github.com/kubohiroya/turbowarp-kvs) for portable namespace/key persistence and server lowering.
 
-`@kubohiroya/turbowarp-asset-manager` is deprecated. Composition consumers can replace its import
-path with `@kubohiroya/turbowarp-asset-cache/composition` for asset registration, rendering,
-playback, DOM image resources, and verified remote-cache APIs. Import binary object, bundle, and
-session-backing APIs directly from `@kubohiroya/turbowarp-kvs`. Standalone projects must also
-replace the extension ID `kubohiroyaassetmanager` with `kubohiroyaassetcache`; published historical
-SB3 artifacts should remain pinned to their original extension.
-
 ## User Guide
 
 For setup, safety notes, recipes, and the illustrated block guide, see the [English user guide](https://kubohiroya.github.io/turbowarp-asset-cache/) or [Japanese user guide](https://kubohiroya.github.io/turbowarp-asset-cache/ja/).
@@ -48,13 +41,13 @@ The built JavaScript file is committed to this repository so users do not need t
 The versioned npm package contains the same reviewed build:
 
 ```bash
-pnpm add --save-exact @kubohiroya/turbowarp-asset-cache@0.1.0
+pnpm add --save-exact @kubohiroya/turbowarp-asset-cache@0.2.1
 ```
 
 Load `node_modules/@kubohiroya/turbowarp-asset-cache/dist/asset-cache.js`, or use the version-pinned CDN URL:
 
 ```text
-https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.1.0/dist/asset-cache.js
+https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.2.1/dist/asset-cache.js
 ```
 
 ## Quick Start

package/dist/types/server-manifest.d.ts

@@ -1,16 +1,13 @@
 import { type ExtensionManifest, type ExtensionManifestBlock } from '@kubohiroya/turbowarp-extension-manifest';
-export interface AssetCacheManifestBlock extends ExtensionManifestBlock {
-    resultType: 'boolean' | 'string' | 'void';
-    effect: 'control' | 'pure' | 'storage-write';
-    immutable: boolean;
-    errors: string[];
-    server: {
-        supported: false;
-    };
-}
-export interface AssetCacheManifest extends Omit<ExtensionManifest, 'formatVersion' | 'blocks'> {
-    formatVersion: 2;
-    blocks: AssetCacheManifestBlock[];
-}
-export declare function createAssetCacheManifest(id: string, definitions: unknown): AssetCacheManifest;
+/** The format version 2 fields, which the package models as optional on a block. */
+export type AssetCacheBlockMetadata = Required<Pick<ExtensionManifestBlock, 'effect' | 'errors' | 'immutable' | 'resultType' | 'server'>>;
+/**
+ * Derives this extension's format version 2 metadata from its block definitions.
+ *
+ * The contract itself — which fields exist and what values they may take — belongs to
+ * @kubohiroya/turbowarp-extension-manifest. Only the policy is local: which of these blocks writes
+ * to the asset store, and which merely reports.
+ */
+export declare function assetCacheBlockMetadata(definitions: unknown): Record<string, AssetCacheBlockMetadata>;
+export declare function createAssetCacheManifest(id: string, definitions: unknown): ExtensionManifest;
 export declare function serializeAssetCacheManifest(id: string, definitions: unknown): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-asset-cache",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "A browser-local image, audio, and runtime-text asset cache for TurboWarp projects.",
   "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
   "type": "module",
@@ -60,8 +60,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
+    "@kubohiroya/turbowarp-extension-manifest": "0.3.0",
     "@kubohiroya/turbowarp-named-data": "0.1.0",
-    "@kubohiroya/turbowarp-extension-manifest": "0.2.0",
     "@kubohiroya/vite-plugin-turbowarp-extension": "0.4.0",
     "@types/node": "^22.20.1",
     "@xmldom/xmldom": "0.9.11",
@@ -73,7 +73,7 @@
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
-    "@kubohiroya/turbowarp-named-data": "^0.1.0"
+    "@kubohiroya/turbowarp-named-data": ">=0.1.0 <1"
   },
   "keywords": [
     "turbowarp",