@playcraft/cli 0.1.66 → 0.1.68

package/templates/preview-runtime/v1/README.md

@@ -96,6 +96,18 @@ The report also records raw hashes of actual workspace module inputs and known c
 
 The platform embeds its immutable build profile after checking the report. The runtime reads the exact host origin and binding from platform context, validates the build profile, and then completes a real versioned handshake. A build report never declares live capability.
 
+## Declarative level editor
+
+`runtime.mjs` also exports `connectLevelEditorRuntime` and `readLevelEditorPreviewContext`. The level-editor protocol has its own message namespace and does not require registering level arrays as primitive parameter fields. A project can support parameters, level editing, or both.
+
+Declare `levelEditor: {version: 1, definition: '<actual-definition-path>'}` beside `previewRuntime`. The definition's `preview.entry` and `preview.adapter` name real development files. A level-only project can omit `parameters`; retain the actual `previewRuntime` entry and build settings. Invoke the build through the platform so its context comes from current source files, rather than constructing a profile manually.
+
+`readLevelEditorPreviewContext()` returns `{binding, parentOrigin}` from the immutable build stamp and authorized host context. Pass those to `connectLevelEditorRuntime({...context, commands: [<actual-command-identifiers>], adapter})`. The adapter implements `enterEdit(context)`, `loadLevel(context)`, `afterRender(context)` and `dispose()`. Each load context contains the author `documents`, stable `selection`, `draftRevision`, `mode` and abort `signal`.
+
+Use the production game's real resolver and level loading in those callbacks. Keep authored initial data separate from playtest state; stop obsolete instances and wait for a real frame before acknowledging application. Declaring a command or returning from an empty callback does not establish that the game consumed the data. The platform separately records saved data, successful build, capability handshake and applied snapshots.
+
+The checked development build receives `script#playcraft-level-editor-profile` containing the actual editor identity and execution contract. A historical build retains its own contract and cannot receive edits for changed game code. Ordinary data edits can reuse a compatible build; changes to code or integration need a new development build. Keep the development entry, runtime and profile outside production output using the guard below.
+
 ## Independent production build
 
 Keep the original production entry and output under `dist/`. Never import the preview entry or runtime from production.

package/templates/preview-runtime/v1/build-preview.mjs

@@ -1182,11 +1182,19 @@ async function buildWorkspacePreview({ entry, config, mountId = "game", root = p
   const entryPath = await inside(root, entry);
   const configPath = config ? await inside(root, config) : false;
   if (!/^[A-Za-z][A-Za-z0-9_-]{0,63}$/.test(mountId)) throw new Error("preview_runtime_mount_invalid");
-  const schemaPath = await inside(root, manifest.parameters?.schemaPath);
-  const dataPath = await inside(root, manifest.parameters?.dataPath);
-  const schema = await readFile(schemaPath);
-  const data = await readFile(dataPath);
-  if (hash(schema) !== context.binding.schemaVersion || hash(data) !== context.baseline.dataHash)
+  const parameterFiles = manifest.parameters?.schemaPath && manifest.parameters?.dataPath;
+  if (!parameterFiles && !context.levelEditor) throw new Error("preview_runtime_source_missing");
+  const schemaPath = parameterFiles ? await inside(root, manifest.parameters.schemaPath) : void 0;
+  const dataPath = parameterFiles ? await inside(root, manifest.parameters.dataPath) : void 0;
+  const schema = schemaPath ? await readFile(schemaPath) : void 0;
+  const data = dataPath ? await readFile(dataPath) : void 0;
+  const schemaHash = schema ? hash(schema) : context.levelEditor.schemaHash;
+  const dataHash = data ? hash(data) : context.levelEditor.dataHash;
+  if (schemaHash !== context.binding.schemaVersion || dataHash !== context.baseline.dataHash)
+    throw new Error("preview_runtime_source_changed");
+  const levelInputs = context.levelEditor?.inputs ?? [];
+  if (context.levelEditor && (!Array.isArray(levelInputs) || !levelInputs.length)) throw new Error("preview_runtime_level_inputs_missing");
+  for (const input of levelInputs) if (hash(await readFile(await inside(root, input.path))) !== input.sha256)
     throw new Error("preview_runtime_source_changed");
   const sdkPath = await realpath(path.join(sdkDirectory, "runtime.mjs"));
   const sdkRelativePath = slash(path.relative(root, sdkPath));
@@ -1239,6 +1247,7 @@ async function buildWorkspacePreview({ entry, config, mountId = "game", root = p
     path.join(root, "package.json"),
     schemaPath,
     dataPath,
+    ...levelInputs.map((input2) => path.join(root, input2.path)),
     path.join(root, ".playcraft/workspace.json"),
     ...["pnpm-lock.yaml", "package-lock.json", "yarn.lock"].map((name) => path.join(root, name))
   ])
@@ -1290,14 +1299,14 @@ async function buildWorkspacePreview({ entry, config, mountId = "game", root = p
     throw new Error("preview_runtime_external_resource");
   const css = outputs.filter((output) => output.type === "asset").map((output) => typeof output.source === "string" ? output.source : Buffer.from(output.source).toString()).join("\n");
   const html = '<!doctype html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>PlayCraft preview</title><style>' + css.replace(/<\/style/gi, "<\\/style") + '</style></head><body><div id="' + mountId + '"></div><script type="module">' + chunks[0].code.replace(/<\/script/gi, "<\\/script") + "</script></body></html>";
-  if (hash(await readFile(schemaPath)) !== hash(schema) || hash(await readFile(dataPath)) !== hash(data) || hash(await readFile(await inside(root, ".playcraft/workspace.json"))) !== hash(manifestBytes) || hash(await readFile(sdkPath)) !== hash(sdkBytes)) throw new Error("preview_runtime_source_changed");
+  if (schemaPath && hash(await readFile(schemaPath)) !== hash(schema) || dataPath && hash(await readFile(dataPath)) !== hash(data) || hash(await readFile(await inside(root, ".playcraft/workspace.json"))) !== hash(manifestBytes) || hash(await readFile(sdkPath)) !== hash(sdkBytes)) throw new Error("preview_runtime_source_changed");
   const report = {
     target: "editor-static",
     buildId: context.buildId,
     htmlDigest: hash(html),
-    schemaDigest: hash(schema),
+    schemaDigest: schemaHash,
     sourceFingerprint: context.sourceFingerprint,
-    dataHash: hash(data),
+    dataHash,
     dataRevision: context.baseline.dataRevision,
     schemaRevision: context.baseline.schemaRevision,
     moduleIds,

package/templates/preview-runtime/v1/manifest.json

@@ -3,13 +3,16 @@
   "sdkVersion": "0.0.1",
   "protocolVersion": 1,
   "files": {
-    "build-preview.mjs": "2bd512675d829cc07ceddcb58365a6f74d36ff93690f8d72f4bbaa1d45511c91",
-    "README.md": "907bb956f939b3d957ba83789e6131b2f4366fb22a239acda776df4ed22b7db2",
-    "release-guard.mjs": "0c33d1559c68844f3760c3e754ee36ca70dc27151ef6f7ad62f29f95239679cc",
-    "runtime.d.mts": "a366552166a4a93103306997058951416740eaf6d6f3d0a34854386b4f1e02f5",
-    "runtime.d.ts": "a366552166a4a93103306997058951416740eaf6d6f3d0a34854386b4f1e02f5",
-    "runtime.mjs": "700c6cb0859ef4b4390d7a1dae41f7e8fa7be7c8dad90b5b48a7e7ee5f90a6a1",
+    "build-preview.mjs": "c72ab758e39bb419cc194dce1ee711bd6f9bfda322e15198d4657d61742af386",
+    "README.md": "61a4dcf4dc5b6ae4000578cb2d369bb5f6a999c30e1c9c2dac44e3035bcd0a4b",
+    "release-guard.mjs": "728ac088f8d885a50a1c9bcdddad724fa80afd06e66a6dd3658756034e563055",
+    "runtime.d.mts": "a90c69a8b72105e8dc8fe0b3bcd272f038ed255f7daf5ec6c1aefc293a1e84b2",
+    "runtime.d.ts": "a90c69a8b72105e8dc8fe0b3bcd272f038ed255f7daf5ec6c1aefc293a1e84b2",
+    "runtime.mjs": "50dc53ff94effedf10903df708c1ecdb51bd8145a5a6ec1eac9449cad7424a24",
     "types/adapters.d.ts": "f5e70c4bb9043de1c590eada14266f613286360c809faf26680b0bbbd1cc7b2c",
+    "types/host.d.ts": "9ea867d5485a66aba7da86ea7e5583bca6b9a7a89618afd0eb70ace58e06faf9",
+    "types/index.d.ts": "210d24a767f260bc8944d917b50dae1357cba31b8b5d499bea7bcc99b1051e6c",
+    "types/level-editor.d.ts": "7f1a8c348e23b186c1f64e4f38fcb08fa663b0cfc2655a4acb86c640e0172a72",
     "types/preview.d.ts": "db2e7eb1fa3406ca53fc7c3a4352da061c05af714ead978111ab5118de58db32",
     "types/protocol.d.ts": "b298d1d35d6e261bbf6a0500f9029f38cad1532bb46475566180b3b92833c507",
     "types/runtime.d.ts": "f52d08d7b53ff84394381f9d1741a624142f75fac468abf9a5029e98fe172ca4"

package/templates/preview-runtime/v1/release-guard.mjs

@@ -4,7 +4,7 @@ import path from 'node:path';
 
 const slash = value => value.replaceAll('\\', '/').replaceAll('\0', '').split('?')[0];
 const hash = value => createHash('sha256').update(value).digest('hex');
-const marker = /runtime\.parameters\.|playcraft-preview-storage:|__playcraft_preview_context__/i;
+const marker = /runtime\.(?:parameters|levelEditor|level-editor)\.|playcraft-preview-storage:|__playcraft_(?:preview|level_editor)_context__|playcraft-level-editor-profile/i;
 /** A production-only Vite module boundary, separate from the development preview builder. */
 export function previewRuntimeReleaseGuard({ root = process.cwd(), previewEntries = [], reportPath = '.playcraft-editor-preview/release-report.json' } = {}) {
   root = path.resolve(root);

package/templates/preview-runtime/v1/runtime.d.mts

@@ -1,3 +1 @@
-export { connectPreviewRuntime, readWorkspacePreviewContext, ResourceLoadError } from './types/preview.js';
-export type * from './types/adapters.js';
-export type * from './types/protocol.js';
+export * from './types/index.js';

package/templates/preview-runtime/v1/runtime.d.ts

@@ -1,3 +1 @@
-export { connectPreviewRuntime, readWorkspacePreviewContext, ResourceLoadError } from './types/preview.js';
-export type * from './types/adapters.js';
-export type * from './types/protocol.js';
+export * from './types/index.js';