@nexart/codemode-sdk 1.8.3 → 1.9.0

package/dist/types/sdk/codemode/attestation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @nexart/codemode-sdk — Attestation Receipt Helpers (v1.9.0)
+ *
+ * Utilities for extracting and inspecting attestation receipts from Code Mode
+ * snapshot bundles.  These are read-only helpers — they never perform network
+ * calls or signature verification.  For full offline verification use
+ * verifyBundleAttestation() from nodeReceipt.ts.
+ *
+ * Recognised bundle layouts:
+ *  A. Top-level envelope  — bundle.receipt + bundle.signature
+ *  B. Nested attestation  — bundle.attestation.receipt + bundle.attestation.signature
+ *  C. Legacy flat fields  — bundle.attestationId (pre-receipt format)
+ */
+import type { CodeAttestationReceipt } from './types.js';
+/**
+ * Extract a normalised CodeAttestationReceipt from any Code Mode bundle.
+ * Returns null when no attestation is present.
+ */
+export declare function getAttestationReceipt(bundle: unknown): CodeAttestationReceipt | null;
+/**
+ * Return true if the bundle carries any form of attestation data.
+ */
+export declare function hasAttestation(bundle: unknown): boolean;
+//# sourceMappingURL=attestation.d.ts.map

package/dist/types/sdk/codemode/attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../../attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA4B,MAAM,YAAY,CAAC;AAEnF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CAqDpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEvD"}

package/dist/types/sdk/codemode/builder-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-manifest.d.ts","sourceRoot":"","sources":["../../../../builder-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAiB9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/types/sdk/codemode/canonicalJson.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @nexart/codemode-sdk — Canonical JSON
+ *
+ * Deterministic, sorted-key JSON serialization used for signing and
+ * verifying attestation receipts. The output is byte-for-byte identical
+ * whether produced in Node.js or a browser.
+ *
+ * Rules:
+ *  - Object keys are sorted lexicographically (Unicode code point order)
+ *  - No trailing commas, no whitespace
+ *  - Arrays preserve insertion order
+ *  - null, boolean, number, string are encoded as standard JSON literals
+ *  - Undefined values and function-valued properties are omitted (same as JSON.stringify)
+ */
+export declare function toCanonicalJson(value: unknown): string;
+//# sourceMappingURL=canonicalJson.d.ts.map

package/dist/types/sdk/codemode/canonicalJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalJson.d.ts","sourceRoot":"","sources":["../../../../canonicalJson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBtD"}

package/dist/{sdk → types/sdk}/codemode/core-index.d.ts

@@ -14,10 +14,14 @@ export { createP5Runtime, injectTimeVariables, createProtocolVAR, VAR_COUNT, VAR
 export { runStaticMode, } from './static-engine';
 export { runLoopMode, cancelLoopMode, } from './loop-engine';
 export { createEngine, } from './engine';
+export { CodeVerifyCode, type CodeVerifyCode as CodeVerifyCodeType, type CodeVerificationResult, type NodeReceiptVerifyResult, type NodeKeysDocument, type SignedAttestationReceipt, type CodeAttestationReceipt, } from './types.js';
+export { verifyNodeReceiptSignature, fetchNodeKeys, selectNodeKey, verifyBundleAttestation, } from './nodeReceipt.js';
+export { getAttestationReceipt, hasAttestation, } from './attestation.js';
+export { toCanonicalJson } from './canonicalJson.js';
 /**
  * SDK Identity — imported from version.ts (single source of truth)
  */
-export declare const SDK_VERSION = "1.8.3";
+export declare const SDK_VERSION = "1.9.0";
 export declare const SDK_NAME = "@nexart/codemode-sdk";
 export { PROTOCOL_VERSION, PROTOCOL_PHASE };
 //# sourceMappingURL=core-index.d.ts.map

package/dist/types/sdk/codemode/core-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-index.d.ts","sourceRoot":"","sources":["../../../../core-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA+B,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG1F,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,OAAO,EACP,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,GACb,MAAM,UAAU,CAAC;AAKlB,OAAO,EACL,cAAc,EACd,KAAK,cAAc,IAAI,kBAAkB,EACzC,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,WAAW,UAAe,CAAC;AACxC,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC"}

package/dist/types/sdk/codemode/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAc,MAAM,SAAS,CAAC;AAKhE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+CzD;AAGD,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/{sdk → types/sdk}/codemode/entry/browser.d.ts

@@ -28,7 +28,7 @@ export { createRuntime, NexArtRuntime, RUNTIME_VERSION, } from '../runtime';
 export type { RuntimeOptions, RuntimeState, NexArtRuntime as NexArtRuntimeType, } from '../runtime';
 export { renderSoundArtViaCodeMode, canRenderViaCodeMode, getCodeModeAvailableStyles, } from '../soundart-engine';
 export type { TweakParams, SoundArtEngineConfig, SoundArtRenderOptions, SoundArtRenderResult, SoundArtMetadata, SoundSnapshot, SoundFeatures, SoundArtSketchName, } from '../soundart-engine';
-export declare const SDK_VERSION = "1.8.3";
+export declare const SDK_VERSION = "1.9.0";
 export declare const SDK_NAME = "@nexart/codemode-sdk";
 export declare const SDK_ENTRY = "browser";
 /**

package/dist/types/sdk/codemode/entry/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../entry/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,YAAY,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAKlB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,OAAO,EACP,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,SAAS,EACT,eAAe,GAChB,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,WAAW,EACX,cAAc,GACf,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,YAAY,GACb,MAAM,WAAW,CAAC;AAKnB,OAAO,EACL,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,IAAI,iBAAiB,GACnC,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAK5B,eAAO,MAAM,WAAW,UAAe,CAAC;AACxC,eAAO,MAAM,QAAQ,yBAAyB,CAAC;AAC/C,eAAO,MAAM,SAAS,YAAY,CAAC;AAEnC;;;;;;;;;;;GAWG"}

package/dist/types/sdk/codemode/entry/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../entry/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,cAAc,WAAW,CAAC;AAK1B,OAAO,EACL,aAAa,GACd,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EACL,eAAe,GAChB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,eAAO,MAAM,SAAS,SAAS,CAAC"}

package/dist/types/sdk/codemode/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EAMtB,MAAM,SAAS,CAAC;AAuNjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAmChC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuCpH"}

package/dist/types/sdk/codemode/execution-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-sandbox.d.ts","sourceRoot":"","sources":["../../../../execution-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAyDH;;GAEG;AACH,eAAO,MAAM,cAAc;6BAvD2B,GAAG,EAAE,KAAK,KAAK;;;;;;mCAAf,GAAG,EAAE,KAAK,KAAK;oCAAf,GAAG,EAAE,KAAK,KAAK;qCAAf,GAAG,EAAE,KAAK,KAAK;sCAAf,GAAG,EAAE,KAAK,KAAK;8CAAf,GAAG,EAAE,KAAK,KAAK;6CAAf,GAAG,EAAE,KAAK,KAAK;8BAAf,GAAG,EAAE,KAAK,KAAK;uCAAf,GAAG,EAAE,KAAK,KAAK;kCAAf,GAAG,EAAE,KAAK,KAAK;;;;;;;;;;;;;qCAAf,GAAG,EAAE,KAAK,KAAK;+BAAf,GAAG,EAAE,KAAK,KAAK;qCAAf,GAAG,EAAE,KAAK,KAAK;;6BAAf,GAAG,EAAE,KAAK,KAAK;6BAAf,GAAG,EAAE,KAAK,KAAK;mCAAf,GAAG,EAAE,KAAK,KAAK;4BAAf,GAAG,EAAE,KAAK,KAAK;wCAAf,GAAG,EAAE,KAAK,KAAK;gCAAf,GAAG,EAAE,KAAK,KAAK;gCAAf,GAAG,EAAE,KAAK,KAAK;iCAAf,GAAG,EAAE,KAAK,KAAK;oCAAf,GAAG,EAAE,KAAK,KAAK;8BAAf,GAAG,EAAE,KAAK,KAAK;8BAAf,GAAG,EAAE,KAAK,KAAK;8BAAf,GAAG,EAAE,KAAK,KAAK;6BAAf,GAAG,EAAE,KAAK,KAAK;iCAAf,GAAG,EAAE,KAAK,KAAK;CAqG3D,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,IAAI,CAU5C;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA8B,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAavF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,MAAM,EAAO,GAC9B,QAAQ,CAiBV;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAC1C,IAAI,CAsBN"}

package/dist/types/sdk/codemode/loop-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-engine.d.ts","sourceRoot":"","sources":["../../../../loop-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAA+B,MAAM,SAAS,CAAC;AAOrF,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Mf"}

package/dist/types/sdk/codemode/nodeReceipt.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @nexart/codemode-sdk — Node Receipt Verification (v1.9.0)
+ *
+ * Offline Ed25519 signature verification for Code Mode attestation receipts.
+ * Browser and Node.js compatible — uses @noble/ed25519 with @noble/hashes/sha2.
+ *
+ * Usage:
+ *   const res = await verifyBundleAttestation(bundle, { nodeUrl });
+ *   console.log(res.ok, res.code);
+ */
+import type { NodeKeysDocument, SignedAttestationReceipt, NodeReceiptVerifyResult } from './types.js';
+/**
+ * Verify an Ed25519 signature over the canonical JSON bytes of a receipt.
+ *
+ * @param params.receipt         - The receipt object that was signed.
+ * @param params.signatureB64Url - Base64url-encoded 64-byte Ed25519 signature.
+ * @param params.key             - Public key in one of: JWK, raw base64url, or SPKI.
+ */
+export declare function verifyNodeReceiptSignature(params: {
+    receipt: SignedAttestationReceipt;
+    signatureB64Url: string;
+    key: {
+        jwk?: NodeKeysDocument['keys'][number]['publicKeyJwk'];
+        spkiB64?: string;
+        rawB64Url?: string;
+    };
+}): Promise<NodeReceiptVerifyResult>;
+/**
+ * Fetch node keys from /.well-known/nexart-node.json on the attestation node.
+ */
+export declare function fetchNodeKeys(nodeUrl: string): Promise<NodeKeysDocument>;
+type SelectKeySuccess = {
+    key: NodeKeysDocument['keys'][number];
+    error?: never;
+};
+type SelectKeyFailure = {
+    error: NodeReceiptVerifyResult;
+    key?: never;
+};
+type SelectKeyResult = SelectKeySuccess | SelectKeyFailure;
+/**
+ * Select the appropriate key from a NodeKeysDocument.
+ *
+ * Priority: explicit kid → activeKid → first key in array.
+ */
+export declare function selectNodeKey(doc: NodeKeysDocument, kid?: string): SelectKeyResult;
+/**
+ * Fully verify a Code Mode bundle's node attestation (offline).
+ *
+ * Steps:
+ *  1. Extract signed receipt + signature from the bundle.
+ *  2. Cross-check receipt.certificateHash === bundle.certificateHash.
+ *  3. Fetch node keys from nodeUrl.
+ *  4. Select the key (by kid, activeKid, or first).
+ *  5. Verify the Ed25519 signature over canonical JSON of the receipt.
+ *
+ * @param bundle   - A Code Mode snapshot bundle (any recognised layout).
+ * @param options  - nodeUrl to fetch keys from; optional kid to select.
+ */
+export declare function verifyBundleAttestation(bundle: unknown, options: {
+    nodeUrl: string;
+    kid?: string;
+}): Promise<NodeReceiptVerifyResult>;
+export {};
+//# sourceMappingURL=nodeReceipt.d.ts.map

package/dist/types/sdk/codemode/nodeReceipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeReceipt.d.ts","sourceRoot":"","sources":["../../../../nodeReceipt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAsBtG;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,wBAAwB,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE;QACH,GAAG,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QACvD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA0EnC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe9E;AAED,KAAK,gBAAgB,GAAG;IAAE,GAAG,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACjF,KAAK,gBAAgB,GAAG;IAAE,KAAK,EAAE,uBAAuB,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACxE,KAAK,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAwClF;AAiDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,OAAO,EACf,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,uBAAuB,CAAC,CAqFlC"}

package/dist/types/sdk/codemode/p5-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p5-runtime.d.ts","sourceRoot":"","sources":["../../../../p5-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAAmB,CAAC;AAC3D,eAAO,MAAM,wBAAwB,IAAiB,CAAC;AACvD,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,aAAa,GAAG,iBAAiB,CAAC;AAEvC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,eAAe,GACvB,SAAS,CAs8BX;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAM3E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAmCpE;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAE3E"}

package/dist/{sdk → types/sdk}/codemode/runtime.d.ts

@@ -18,7 +18,7 @@
  * ║  BROWSER-SAFE: No Node.js dependencies. Works in Vite/Next/React.        ║
  * ╚══════════════════════════════════════════════════════════════════════════╝
  */
-export declare const RUNTIME_VERSION = "1.8.3";
+export declare const RUNTIME_VERSION = "1.9.0";
 export interface RuntimeOptions {
     seed: string | number;
     vars?: number[];

package/dist/types/sdk/codemode/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,eAAO,MAAM,eAAe,UAAc,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,IAAI,MAAM,CAAC;IACjB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,IAAI,MAAM,CAAC;IACjB,QAAQ,IAAI,YAAY,CAAC;IACzB,OAAO,IAAI,MAAM,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAqGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAuHpE;AAED,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}

package/dist/types/sdk/codemode/snapshot.d.ts

@@ -0,0 +1,72 @@
+/**
+ * NexArt CodeMode SDK - Snapshot Support
+ * See version.ts for SDK version (single source of truth)
+ *
+ * Provides snapshot utilities for deterministic execution and verification.
+ */
+import { SDK_VERSION, PROTOCOL_VERSION } from './version';
+/**
+ * Snapshot v1 format
+ */
+export interface NexArtSnapshotV1 {
+    protocol: 'nexart';
+    protocolVersion: string;
+    runtime: 'canonical';
+    runtimeHash: string;
+    codeHash: string;
+    seed: number;
+    VAR: number[];
+    canvas: {
+        width: number;
+        height: number;
+    };
+    outputHash: string;
+    createdAt: string;
+    code?: string;
+}
+/**
+ * Options for snapshot creation
+ */
+export interface CreateSnapshotOptions {
+    code: string;
+    seed: number;
+    VAR: number[];
+    width: number;
+    height: number;
+    outputHash: string;
+    runtimeHash?: string;
+    includeCode?: boolean;
+}
+/**
+ * Normalize code for consistent hashing
+ * - CRLF to LF
+ * - Trim trailing whitespace per line
+ * - Ensure single trailing newline
+ */
+export declare function normalizeCode(code: string): string;
+/**
+ * SHA-256 hash for bytes (Node.js only, synchronous)
+ */
+export declare function sha256Bytes(data: Buffer | Uint8Array): string;
+/**
+ * SHA-256 hash for strings (Node.js only, synchronous)
+ */
+export declare function sha256String(data: string): string;
+/**
+ * Hash code after normalization
+ */
+export declare function hashCode(code: string): string;
+/**
+ * Pad or truncate VAR array to exactly 10 elements
+ */
+export declare function normalizeVAR(vars?: number[]): number[];
+/**
+ * Create a Snapshot v1 from execution parameters
+ */
+export declare function createSnapshotV1(options: CreateSnapshotOptions): NexArtSnapshotV1;
+/**
+ * Validate snapshot structure
+ */
+export declare function validateSnapshot(snapshot: unknown): snapshot is NexArtSnapshotV1;
+export { SDK_VERSION, PROTOCOL_VERSION };
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/sdk/codemode/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAK7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAmBjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,gBAAgB,CAmBhF;AAGD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/types/sdk/codemode/sound-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound-bridge.d.ts","sourceRoot":"","sources":["../../../../sound-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAAC,aAAa,CAAC;CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAExE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,YAAY,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9D,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,aAAa,GACtB,CAAC,GAAG;IAAE,CAAC,EAAE,YAAY,CAAA;CAAE,CAuBzB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB;IAE9B;;OAEG;sBACe,MAAM,UAAU,MAAM,UAAU,MAAM,KAAG,MAAM;IAIjE;;OAEG;2BACoB,MAAM,UAAU,MAAM,UAAU,MAAM,WAAU,MAAM,KAAO,MAAM;IAK1F;;OAEG;2BACoB,MAAM,aAAa,MAAM,cAAc,MAAM,KAAG,MAAM;EAIhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,WAAW,GAAE,MAAU,GACtB,MAAM,EAAE,CAeV;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,YAAY,CAiBvE"}

package/dist/types/sdk/codemode/soundart-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundart-engine.d.ts","sourceRoot":"","sources":["../../../../soundart-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI/E,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,UAAU,EAAE,OAAO,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC;CACH;AAqCD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoG/B;AA4BD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,kBAAkB,EAAE,CAGjE;AAGD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/chladniBloom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chladniBloom.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/chladniBloom.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,+hEAmDhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/dualVortex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dualVortex.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/dualVortex.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,m/EAiE9B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/geometryIllusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryIllusion.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/geometryIllusion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,krGAuFpC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,aAAa,GACb,aAAa,GACb,KAAK,GACL,aAAa,GACb,SAAS,GACT,WAAW,GACX,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,SAAS,GACT,kBAAkB,GAClB,qBAAqB,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAehE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAE9E;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,kBAAkB,EAAE,CAEnE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAE3E;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/isoflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isoflow.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/isoflow.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,g2EA0D1B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/loomWeave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loomWeave.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/loomWeave.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,0wEAyD7B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/noiseTerraces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noiseTerraces.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/noiseTerraces.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,muDAmDjC,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/orb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orb.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/orb.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,4kEAgDtB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/pixelGlyphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelGlyphs.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/pixelGlyphs.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,m4FAsE/B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/prismFlowFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prismFlowFields.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/prismFlowFields.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,43DAiDpC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/radialBurst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radialBurst.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/radialBurst.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,+5DA0D/B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/resonantSoundBodies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resonantSoundBodies.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/resonantSoundBodies.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,wtGAuFxC,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/rings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rings.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/rings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,YAAY,u2FA+ExB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/squares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"squares.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/squares.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,0kDAkD1B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/types/sdk/codemode/soundart-sketches/waveStripes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waveStripes.d.ts","sourceRoot":"","sources":["../../../../../soundart-sketches/waveStripes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,6vDA0C/B,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/types/sdk/codemode/static-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-engine.d.ts","sourceRoot":"","sources":["../../../../static-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAkDtE,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Hf"}

package/dist/{sdk → types/sdk}/codemode/types.d.ts

@@ -149,6 +149,102 @@ export interface ExecuteCodeModeResult {
     frames?: ImageData[];
     metadata: ProtocolMetadata;
 }
+/**
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Verification Reason Codes (v1.9.0)
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Stable, string-valued reason codes returned by all Code Mode verification
+ * functions.  Additive-only: existing codes will never be renamed or removed.
+ */
+export declare const CodeVerifyCode: {
+    readonly OK: "OK";
+    readonly CERTIFICATE_HASH_MISMATCH: "CERTIFICATE_HASH_MISMATCH";
+    readonly SNAPSHOT_HASH_MISMATCH: "SNAPSHOT_HASH_MISMATCH";
+    readonly RENDER_HASH_MISMATCH: "RENDER_HASH_MISMATCH";
+    readonly INVALID_SHA256_FORMAT: "INVALID_SHA256_FORMAT";
+    readonly CANONICALIZATION_ERROR: "CANONICALIZATION_ERROR";
+    readonly SCHEMA_ERROR: "SCHEMA_ERROR";
+    readonly NODE_RECEIPT_MISSING: "NODE_RECEIPT_MISSING";
+    readonly NODE_RECEIPT_KEY_NOT_FOUND: "NODE_RECEIPT_KEY_NOT_FOUND";
+    readonly NODE_RECEIPT_INVALID_SIGNATURE: "NODE_RECEIPT_INVALID_SIGNATURE";
+    readonly NODE_RECEIPT_KEY_FORMAT_UNSUPPORTED: "NODE_RECEIPT_KEY_FORMAT_UNSUPPORTED";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type CodeVerifyCode = typeof CodeVerifyCode[keyof typeof CodeVerifyCode];
+/**
+ * Verification result returned by Code Mode verification functions.
+ * `ok`      — true on success
+ * `code`    — stable machine-readable reason code (CodeVerifyCode)
+ * `details` — optional human-readable detail lines
+ */
+export interface CodeVerificationResult {
+    ok: boolean;
+    code: CodeVerifyCode;
+    details?: string[];
+}
+/**
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Signed Attestation Receipt — Code Mode (v1.9.0)
+ * ─────────────────────────────────────────────────────────────────────────────
+ *
+ * Payload signed by the attestation node over a Code Mode snapshot bundle.
+ * The signature is Ed25519 over the canonical JSON bytes of this object.
+ */
+export interface SignedAttestationReceipt {
+    receiptVersion: 'attestation.receipt.v1';
+    attestationId: string;
+    attestedAt: string;
+    nodeId: string;
+    attestorKeyId: string;
+    nodeRuntimeHash: string;
+    certificateHash: string;
+    protocolVersion: string;
+    [key: string]: unknown;
+}
+/**
+ * Node Keys Document
+ * Fetched from /.well-known/nexart-node.json on the attestation node.
+ */
+export interface NodeKeysDocument {
+    nodeId: string;
+    activeKid?: string;
+    keys: Array<{
+        kid: string;
+        alg: 'Ed25519';
+        use: 'sig';
+        publicKeyJwk?: {
+            kty: 'OKP';
+            crv: 'Ed25519';
+            x: string;
+        };
+        publicKey?: string;
+        publicKeySpkiB64?: string;
+        createdAt?: string;
+    }>;
+}
+/**
+ * Result of node receipt signature verification (Code Mode variant).
+ * Alias of CodeVerificationResult — kept as a distinct named type for
+ * clarity in function signatures.
+ */
+export type NodeReceiptVerifyResult = CodeVerificationResult;
+/**
+ * Normalised attestation receipt extracted from any Code Mode bundle format.
+ * Returned by getAttestationReceipt().
+ */
+export interface CodeAttestationReceipt {
+    attestationId: string;
+    attestedAt: string;
+    nodeId?: string;
+    attestorKeyId?: string;
+    nodeRuntimeHash?: string;
+    certificateHash?: string;
+    protocolVersion?: string;
+    receipt?: SignedAttestationReceipt;
+    signature?: string;
+    [key: string]: unknown;
+}
 /**
  * Builder Manifest (v1.6.0)
  *

package/dist/types/sdk/codemode/types.d.ts.map

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

package/dist/{sdk → types/sdk}/codemode/version.d.ts

@@ -8,11 +8,11 @@
  * See package.json for the canonical npm version.
  */
 /** SDK version - must match package.json version */
-export declare const SDK_VERSION = "1.8.3";
+export declare const SDK_VERSION = "1.9.0";
 /** Protocol version - defines runtime semantics and determinism guarantees */
 export declare const PROTOCOL_VERSION = "1.2.0";
 /** Protocol phase - phase 3 = stable, production-ready */
 export declare const PROTOCOL_PHASE = 3;
 /** Combined version string for display */
-export declare const VERSION_STRING = "v1.8.3 (Protocol v1.2.0)";
+export declare const VERSION_STRING = "v1.9.0 (Protocol v1.2.0)";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/sdk/codemode/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oDAAoD;AACpD,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,6BAAoD,CAAC"}

package/dist/types/shared/soundSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundSnapshot.d.ts","sourceRoot":"","sources":["../../../../../shared/soundSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAE5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAGrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,EAAE,MAAM,CAAC;IAGpB,OAAO,EAAE,MAAM,CAAC;IAGhB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IAGV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,aAAa,CAmBxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,aAAa,EAAE,EACxB,QAAQ,GAAE,MAAY,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAsEf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAEpF"}

package/examples/sketch-minimal.js

@@ -0,0 +1,27 @@
+/**
+ * Minimal NexArt Code Mode Sketch
+ * 
+ * A simple sketch demonstrating basic canvas operations.
+ * No randomness - produces identical output every run.
+ * 
+ * Canonical size: 1950x2400 (enforced by canonical renderer)
+ */
+
+createCanvas(1950, 2400);
+background(20, 20, 30);
+
+noStroke();
+
+fill(255, 100, 100);
+ellipse(width / 2, height / 3, 600, 600);
+
+fill(100, 255, 100);
+ellipse(width / 3, height * 2 / 3, 400, 400);
+
+fill(100, 100, 255);
+ellipse(width * 2 / 3, height * 2 / 3, 400, 400);
+
+stroke(255);
+strokeWeight(4);
+noFill();
+rect(100, 100, width - 200, height - 200, 50);

package/examples/sketch-vars.js

@@ -0,0 +1,59 @@
+/**
+ * VAR + Random Sketch - Demonstrates Determinism
+ * 
+ * This sketch uses VAR parameters and random() to show that
+ * NexArt Code Mode produces identical output for the same seed.
+ * 
+ * VAR[0]: Number of circles (0-100 maps to 10-50)
+ * VAR[1]: Circle size multiplier (0-100 maps to 0.5-2.0)
+ * VAR[2]: Color hue shift (0-100 maps to 0-360)
+ * 
+ * Canonical size: 1950x2400 (enforced by canonical renderer)
+ * 
+ * Usage:
+ *   nexart run sketch-vars.js --seed 12345 --vars 50,75,25
+ */
+
+createCanvas(1950, 2400);
+background(10, 10, 20);
+
+const numCircles = Math.floor(map(VAR[0], 0, 100, 10, 50));
+const sizeMultiplier = map(VAR[1], 0, 100, 0.5, 2.0);
+const hueShift = map(VAR[2], 0, 100, 0, 360);
+
+colorMode(HSB, 360, 100, 100, 100);
+
+noStroke();
+
+for (let i = 0; i < numCircles; i++) {
+  const x = random(100, width - 100);
+  const y = random(100, height - 100);
+  const baseSize = random(50, 200) * sizeMultiplier;
+  const hue = (random(360) + hueShift) % 360;
+  const sat = random(60, 100);
+  const bright = random(70, 100);
+  const alpha = random(40, 80);
+  
+  fill(hue, sat, bright, alpha);
+  ellipse(x, y, baseSize, baseSize);
+}
+
+stroke(0, 0, 100, 50);
+strokeWeight(2);
+noFill();
+
+for (let i = 0; i < 20; i++) {
+  const x1 = random(width);
+  const y1 = random(height);
+  const x2 = random(width);
+  const y2 = random(height);
+  line(x1, y1, x2, y2);
+}
+
+colorMode(RGB, 255);
+fill(255);
+noStroke();
+textSize(48);
+textAlign(CENTER, TOP);
+text(`Seed: ${SEED}`, width / 2, 50);
+text(`VAR: [${VAR[0]}, ${VAR[1]}, ${VAR[2]}]`, width / 2, 120);

package/examples/sketch.js

@@ -0,0 +1,24 @@
+function setup() {
+  const brightness = map(VAR[0], 0, 100, 20, 245);
+  background(brightness);
+
+  const diameter = map(VAR[1], 0, 100, 200, 1400);
+
+  // Deterministic palette choice (no random dependency)
+  const paletteIndex = floor(map(VAR[2], 0, 100, 0, 2.9999));
+
+  const palettes = [
+    { main: [255, 100, 120], accent: [100, 200, 255] },
+    { main: [100, 220, 180], accent: [255, 180, 100] },
+    { main: [180, 120, 255], accent: [255, 220, 100] }
+  ];
+  const palette = palettes[paletteIndex];
+
+  noStroke();
+
+  fill(palette.main[0], palette.main[1], palette.main[2]);
+  ellipse(width / 2, height / 2, diameter, diameter);
+
+  fill(palette.accent[0], palette.accent[1], palette.accent[2]);
+  ellipse(width / 2, height / 2, diameter * 0.4, diameter * 0.4);
+}