@nexart/codemode-sdk 1.8.2 → 1.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/CHANGELOG.md +71 -1
  2. package/COMMERCIAL.md +25 -23
  3. package/LICENSE.md +10 -41
  4. package/README.md +12 -2
  5. package/dist/cjs/browser.cjs +3077 -0
  6. package/dist/cjs/browser.js +3042 -0
  7. package/dist/cjs/core.cjs +1660 -0
  8. package/dist/cjs/core.js +1636 -0
  9. package/dist/cjs/node.cjs +3245 -0
  10. package/dist/cjs/node.js +3208 -0
  11. package/dist/esm/browser.cjs +3077 -0
  12. package/dist/esm/browser.js +3042 -0
  13. package/dist/esm/core.cjs +1660 -0
  14. package/dist/esm/core.js +1636 -0
  15. package/dist/esm/node.cjs +3245 -0
  16. package/dist/esm/node.js +3208 -0
  17. package/dist/types/sdk/codemode/builder-manifest.d.ts.map +1 -0
  18. package/dist/{sdk → types/sdk}/codemode/core-index.d.ts +1 -1
  19. package/dist/types/sdk/codemode/core-index.d.ts.map +1 -0
  20. package/dist/types/sdk/codemode/engine.d.ts.map +1 -0
  21. package/dist/{sdk → types/sdk}/codemode/entry/browser.d.ts +1 -1
  22. package/dist/types/sdk/codemode/entry/browser.d.ts.map +1 -0
  23. package/dist/types/sdk/codemode/entry/node.d.ts.map +1 -0
  24. package/dist/types/sdk/codemode/execute.d.ts.map +1 -0
  25. package/dist/types/sdk/codemode/execution-sandbox.d.ts.map +1 -0
  26. package/dist/types/sdk/codemode/loop-engine.d.ts.map +1 -0
  27. package/dist/{sdk → types/sdk}/codemode/p5-runtime.d.ts +3 -2
  28. package/dist/types/sdk/codemode/p5-runtime.d.ts.map +1 -0
  29. package/dist/{sdk → types/sdk}/codemode/runtime.d.ts +1 -1
  30. package/dist/types/sdk/codemode/runtime.d.ts.map +1 -0
  31. package/dist/types/sdk/codemode/snapshot.d.ts +72 -0
  32. package/dist/types/sdk/codemode/snapshot.d.ts.map +1 -0
  33. package/dist/types/sdk/codemode/sound-bridge.d.ts.map +1 -0
  34. package/dist/types/sdk/codemode/soundart-engine.d.ts.map +1 -0
  35. package/dist/types/sdk/codemode/soundart-sketches/chladniBloom.d.ts.map +1 -0
  36. package/dist/types/sdk/codemode/soundart-sketches/dualVortex.d.ts.map +1 -0
  37. package/dist/types/sdk/codemode/soundart-sketches/geometryIllusion.d.ts.map +1 -0
  38. package/dist/types/sdk/codemode/soundart-sketches/index.d.ts.map +1 -0
  39. package/dist/types/sdk/codemode/soundart-sketches/isoflow.d.ts.map +1 -0
  40. package/dist/types/sdk/codemode/soundart-sketches/loomWeave.d.ts.map +1 -0
  41. package/dist/types/sdk/codemode/soundart-sketches/noiseTerraces.d.ts.map +1 -0
  42. package/dist/types/sdk/codemode/soundart-sketches/orb.d.ts.map +1 -0
  43. package/dist/types/sdk/codemode/soundart-sketches/pixelGlyphs.d.ts.map +1 -0
  44. package/dist/types/sdk/codemode/soundart-sketches/prismFlowFields.d.ts.map +1 -0
  45. package/dist/types/sdk/codemode/soundart-sketches/radialBurst.d.ts.map +1 -0
  46. package/dist/types/sdk/codemode/soundart-sketches/resonantSoundBodies.d.ts.map +1 -0
  47. package/dist/types/sdk/codemode/soundart-sketches/rings.d.ts.map +1 -0
  48. package/dist/types/sdk/codemode/soundart-sketches/squares.d.ts.map +1 -0
  49. package/dist/types/sdk/codemode/soundart-sketches/waveStripes.d.ts.map +1 -0
  50. package/dist/types/sdk/codemode/static-engine.d.ts.map +1 -0
  51. package/dist/{sdk → types/sdk}/codemode/types.d.ts +2 -1
  52. package/dist/types/sdk/codemode/types.d.ts.map +1 -0
  53. package/dist/{sdk → types/sdk}/codemode/version.d.ts +2 -2
  54. package/dist/types/sdk/codemode/version.d.ts.map +1 -0
  55. package/dist/types/shared/soundSnapshot.d.ts.map +1 -0
  56. package/examples/preflight-test.ts +1 -1
  57. package/package.json +22 -22
  58. package/dist/sdk/codemode/builder-manifest.d.ts.map +0 -1
  59. package/dist/sdk/codemode/builder-manifest.js +0 -97
  60. package/dist/sdk/codemode/core-index.d.ts.map +0 -1
  61. package/dist/sdk/codemode/core-index.js +0 -28
  62. package/dist/sdk/codemode/engine.d.ts.map +0 -1
  63. package/dist/sdk/codemode/engine.js +0 -67
  64. package/dist/sdk/codemode/entry/browser.d.ts.map +0 -1
  65. package/dist/sdk/codemode/entry/browser.js +0 -69
  66. package/dist/sdk/codemode/entry/node.d.ts.map +0 -1
  67. package/dist/sdk/codemode/entry/node.js +0 -35
  68. package/dist/sdk/codemode/execute.d.ts.map +0 -1
  69. package/dist/sdk/codemode/execute.js +0 -283
  70. package/dist/sdk/codemode/execution-sandbox.d.ts.map +0 -1
  71. package/dist/sdk/codemode/execution-sandbox.js +0 -207
  72. package/dist/sdk/codemode/loop-engine.d.ts.map +0 -1
  73. package/dist/sdk/codemode/loop-engine.js +0 -229
  74. package/dist/sdk/codemode/p5-runtime.d.ts.map +0 -1
  75. package/dist/sdk/codemode/p5-runtime.js +0 -1031
  76. package/dist/sdk/codemode/runtime.d.ts.map +0 -1
  77. package/dist/sdk/codemode/runtime.js +0 -220
  78. package/dist/sdk/codemode/sound-bridge.d.ts.map +0 -1
  79. package/dist/sdk/codemode/sound-bridge.js +0 -128
  80. package/dist/sdk/codemode/soundart-engine.d.ts.map +0 -1
  81. package/dist/sdk/codemode/soundart-engine.js +0 -173
  82. package/dist/sdk/codemode/soundart-sketches/chladniBloom.d.ts.map +0 -1
  83. package/dist/sdk/codemode/soundart-sketches/chladniBloom.js +0 -53
  84. package/dist/sdk/codemode/soundart-sketches/dualVortex.d.ts.map +0 -1
  85. package/dist/sdk/codemode/soundart-sketches/dualVortex.js +0 -67
  86. package/dist/sdk/codemode/soundart-sketches/geometryIllusion.d.ts.map +0 -1
  87. package/dist/sdk/codemode/soundart-sketches/geometryIllusion.js +0 -89
  88. package/dist/sdk/codemode/soundart-sketches/index.d.ts.map +0 -1
  89. package/dist/sdk/codemode/soundart-sketches/index.js +0 -72
  90. package/dist/sdk/codemode/soundart-sketches/isoflow.d.ts.map +0 -1
  91. package/dist/sdk/codemode/soundart-sketches/isoflow.js +0 -60
  92. package/dist/sdk/codemode/soundart-sketches/loomWeave.d.ts.map +0 -1
  93. package/dist/sdk/codemode/soundart-sketches/loomWeave.js +0 -59
  94. package/dist/sdk/codemode/soundart-sketches/noiseTerraces.d.ts.map +0 -1
  95. package/dist/sdk/codemode/soundart-sketches/noiseTerraces.js +0 -53
  96. package/dist/sdk/codemode/soundart-sketches/orb.d.ts.map +0 -1
  97. package/dist/sdk/codemode/soundart-sketches/orb.js +0 -50
  98. package/dist/sdk/codemode/soundart-sketches/pixelGlyphs.d.ts.map +0 -1
  99. package/dist/sdk/codemode/soundart-sketches/pixelGlyphs.js +0 -72
  100. package/dist/sdk/codemode/soundart-sketches/prismFlowFields.d.ts.map +0 -1
  101. package/dist/sdk/codemode/soundart-sketches/prismFlowFields.js +0 -51
  102. package/dist/sdk/codemode/soundart-sketches/radialBurst.d.ts.map +0 -1
  103. package/dist/sdk/codemode/soundart-sketches/radialBurst.js +0 -60
  104. package/dist/sdk/codemode/soundart-sketches/resonantSoundBodies.d.ts.map +0 -1
  105. package/dist/sdk/codemode/soundart-sketches/resonantSoundBodies.js +0 -89
  106. package/dist/sdk/codemode/soundart-sketches/rings.d.ts.map +0 -1
  107. package/dist/sdk/codemode/soundart-sketches/rings.js +0 -89
  108. package/dist/sdk/codemode/soundart-sketches/squares.d.ts.map +0 -1
  109. package/dist/sdk/codemode/soundart-sketches/squares.js +0 -52
  110. package/dist/sdk/codemode/soundart-sketches/waveStripes.d.ts.map +0 -1
  111. package/dist/sdk/codemode/soundart-sketches/waveStripes.js +0 -44
  112. package/dist/sdk/codemode/static-engine.d.ts.map +0 -1
  113. package/dist/sdk/codemode/static-engine.js +0 -157
  114. package/dist/sdk/codemode/types.d.ts.map +0 -1
  115. package/dist/sdk/codemode/types.js +0 -32
  116. package/dist/sdk/codemode/version.d.ts.map +0 -1
  117. package/dist/sdk/codemode/version.js +0 -17
  118. package/dist/shared/soundSnapshot.d.ts.map +0 -1
  119. package/dist/shared/soundSnapshot.js +0 -128
  120. /package/dist/{sdk → types/sdk}/codemode/builder-manifest.d.ts +0 -0
  121. /package/dist/{sdk → types/sdk}/codemode/engine.d.ts +0 -0
  122. /package/dist/{sdk → types/sdk}/codemode/entry/node.d.ts +0 -0
  123. /package/dist/{sdk → types/sdk}/codemode/execute.d.ts +0 -0
  124. /package/dist/{sdk → types/sdk}/codemode/execution-sandbox.d.ts +0 -0
  125. /package/dist/{sdk → types/sdk}/codemode/loop-engine.d.ts +0 -0
  126. /package/dist/{sdk → types/sdk}/codemode/sound-bridge.d.ts +0 -0
  127. /package/dist/{sdk → types/sdk}/codemode/soundart-engine.d.ts +0 -0
  128. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/chladniBloom.d.ts +0 -0
  129. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/dualVortex.d.ts +0 -0
  130. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/geometryIllusion.d.ts +0 -0
  131. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/index.d.ts +0 -0
  132. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/isoflow.d.ts +0 -0
  133. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/loomWeave.d.ts +0 -0
  134. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/noiseTerraces.d.ts +0 -0
  135. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/orb.d.ts +0 -0
  136. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/pixelGlyphs.d.ts +0 -0
  137. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/prismFlowFields.d.ts +0 -0
  138. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/radialBurst.d.ts +0 -0
  139. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/resonantSoundBodies.d.ts +0 -0
  140. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/rings.d.ts +0 -0
  141. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/squares.d.ts +0 -0
  142. /package/dist/{sdk → types/sdk}/codemode/soundart-sketches/waveStripes.d.ts +0 -0
  143. /package/dist/{sdk → types/sdk}/codemode/static-engine.d.ts +0 -0
  144. /package/dist/{shared → types/shared}/soundSnapshot.d.ts +0 -0
package/CHANGELOG.md CHANGED
@@ -4,6 +4,76 @@ All notable changes to @nexart/codemode-sdk will be documented in this file.
4
4
 
5
5
  ---
6
6
 
7
+ ## [1.8.4] — 2026-01-25
8
+
9
+ ### Fixed — Node ESM Compatibility
10
+
11
+ **Patch Release — Packaging Fix Only**
12
+
13
+ This release fixes Node.js ESM compatibility by switching to dual build output (ESM + CJS) via tsup.
14
+
15
+ #### Breaking Change (Internal Only)
16
+ - Dist structure changed from `dist/entry/*.js` to `dist/esm/*.js` and `dist/cjs/*.js`
17
+ - Types now in `dist/types/`
18
+ - Exports map updated to support both `import` and `require`
19
+
20
+ #### Fixes
21
+ - Node ESM: Imports now resolve correctly (no more missing .js extension errors)
22
+ - Node CJS: `require('@nexart/codemode-sdk')` now works
23
+ - Bundlers: Continue to work via exports map
24
+
25
+ #### Build Changes
26
+ - Added tsup for dual ESM/CJS bundling
27
+ - Types emitted separately via tsc
28
+ - New smoke tests: `scripts/smoke-node.mjs` and `scripts/smoke-node.cjs`
29
+
30
+ #### Unchanged
31
+ - No protocol changes (v1.2.0)
32
+ - No runtime API changes
33
+ - No behavior changes
34
+ - Full backward compatibility with v1.8.3 API
35
+
36
+ ---
37
+
38
+ ## [1.8.3] — 2026-01-25
39
+
40
+ ### Changed — CLI v0.2 Remote Renderer + Version Bump
41
+
42
+ **Non-Breaking Release**
43
+
44
+ This release adds CLI v0.2 with remote canonical renderer support and ensures all version references are synchronized.
45
+
46
+ #### CLI v0.2 Features
47
+ - **Remote renderer support** — `nexart run` now calls canonical Node renderer by default
48
+ - **`--renderer` flag** — Switch between `remote` (default) and `local` (placeholder)
49
+ - **`--endpoint` flag** — Custom renderer endpoint URL
50
+ - **`--include-code` flag** — Embed source code in snapshot for standalone verify/replay
51
+ - **`NEXART_RENDERER_ENDPOINT`** — Environment variable for default endpoint
52
+ - **Real PNG output** — When remote renderer available, produces actual rendered images
53
+
54
+ #### Snapshot v1 Updates
55
+ - `outputHash` = SHA-256 of PNG bytes (locked)
56
+ - `runtimeHash` sourced from renderer response when using remote mode
57
+ - Optional `code` field when `--include-code` is used
58
+
59
+ #### Documentation Updates
60
+ - Updated `docs/snapshot-v1.md` with runtimeHash sourcing and code embedding
61
+ - CLI README now documents remote renderer as default
62
+ - All version references updated from 1.8.2 to 1.8.3
63
+
64
+ #### Package Updates
65
+ - **SDK Version**: 1.8.3
66
+ - **CLI Version**: 0.2.0
67
+
68
+ ### Unchanged
69
+
70
+ - No changes to protocol semantics (v1.2.0)
71
+ - No changes to runtime APIs
72
+ - No changes to determinism guarantees
73
+ - Full backward compatibility with v1.8.2
74
+
75
+ ---
76
+
7
77
  ## [1.8.2] — 2026-01-24
8
78
 
9
79
  ### Changed — AI Agent Adoption Friction Reduction
@@ -71,7 +141,7 @@ This release addresses external review feedback about documentation framing and
71
141
  - **COMMERCIAL.md added** — Plain language licensing terms
72
142
  - **Free for**: personal, experiments, research, open-source
73
143
  - **Commercial production**: requires license
74
- - **Contact**: licensing@nexart.xyz
144
+ - **Contact**: contact@artnames.io
75
145
  - **No phase language, no future enforcement language**
76
146
 
77
147
  #### Package Updates
package/COMMERCIAL.md CHANGED
@@ -1,41 +1,43 @@
1
- # Commercial Licensing
1
+ # Commercial Use
2
2
 
3
3
  ## @nexart/codemode-sdk
4
4
 
5
5
  ---
6
6
 
7
- ## Free Use
7
+ ## License: MIT (Free for All Use)
8
8
 
9
- You may use this SDK at no cost for:
9
+ This SDK is released under the **MIT License**.
10
10
 
11
- - **Personal projects** Learning, hobby work, portfolio pieces
12
- - **Experiments and prototypes** — Proof of concepts, demos, hackathons
13
- - **Research and education** — Academic work, teaching, scientific research
14
- - **Open-source projects** — Projects with source code publicly available under an OSI-approved license
15
-
16
- ---
17
-
18
- ## Commercial Use
19
-
20
- Commercial production deployments require a license.
21
-
22
- **Commercial use includes:**
23
- - Products or services that generate revenue
24
- - Internal tools used in commercial operations
25
- - SaaS applications
26
- - Games or simulations sold or monetized
11
+ You may use it for **any purpose**, including:
12
+ - Personal projects
13
+ - Commercial products
14
+ - Revenue-generating applications
27
15
  - Enterprise deployments
16
+ - NFT minting
17
+ - SaaS applications
18
+
19
+ **No license key required. No usage tracking. No restrictions.**
28
20
 
29
21
  ---
30
22
 
31
- ## Get a License
23
+ ## How NexArt Monetizes
24
+
25
+ NexArt follows a "monetize edges, not core" model:
32
26
 
33
- Contact: **licensing@artnames.io**
27
+ | Component | Cost |
28
+ |-----------|------|
29
+ | SDK | Free (MIT) |
30
+ | CLI | Free (MIT) |
31
+ | Local run/replay/verify | Free |
32
+ | **Hosted attestation** | Paid |
33
+ | **Cloud retention** | Paid |
34
+ | **SLA guarantees** | Paid |
35
+ | **Compliance tooling** | Paid |
34
36
 
35
- We offer flexible licensing options for teams and enterprises.
37
+ See [Core vs Edges](./docs/core-vs-edges.md) for the full breakdown.
36
38
 
37
39
  ---
38
40
 
39
41
  ## Questions?
40
42
 
41
- If you're unsure whether your use case requires a license, reach out to licensing@artnames.io. We're happy to help.
43
+ Contact: **contact@artnames.io**
package/LICENSE.md CHANGED
@@ -1,44 +1,9 @@
1
- NexArt Code Mode SDK — License
2
-
3
- See package.json for current version
4
- Status: DRAFT — Enforcement Not Active
5
-
6
-
7
-
8
- License Status
9
-
10
- The NexArt Code Mode SDK is currently released under the MIT License.
11
-
12
- At this time, all usage — including commercial usage — is permitted under the MIT License.
13
-
14
- This document also serves as advance notice of a future commercial licensing model that may apply to certain uses of the NexArt Protocol.
15
-
16
-
17
-
18
- Future Commercial Licensing (Not Active)
19
-
20
- NexArt intends to introduce a separate commercial license for specific categories of usage in a future release.
21
-
22
- Planned commercial usage categories may include (non-exhaustive):
23
- • Minting NFTs for sale
24
- • Revenue-generating applications
25
- • Products or services that charge fees
26
- • Enterprise or business deployments
27
-
28
- Enforcement is NOT active.
29
-
30
- No license keys, validation, usage tracking, or commercial restrictions are currently implemented.
31
-
32
- Until enforcement is introduced in a future version, all usage remains governed solely by the MIT License below.
33
-
34
-
35
-
36
- MIT License
1
+ # MIT License
37
2
 
38
3
  Copyright (c) 2024–2026 NexArt
39
4
 
40
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
41
- of this software and associated documentation files (the Software), to deal
6
+ of this software and associated documentation files (the "Software"), to deal
42
7
  in the Software without restriction, including without limitation the rights
43
8
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
44
9
  copies of the Software, and to permit persons to whom the Software is
@@ -47,7 +12,7 @@ furnished to do so, subject to the following conditions:
47
12
  The above copyright notice and this permission notice shall be included in all
48
13
  copies or substantial portions of the Software.
49
14
 
50
- THE SOFTWARE IS PROVIDED AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
51
16
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
52
17
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
53
18
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
@@ -55,8 +20,12 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
55
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
56
21
  SOFTWARE.
57
22
 
58
-
23
+ ---
24
+
25
+ ## Summary
26
+
27
+ This SDK is **MIT licensed** — free for all use, including commercial.
59
28
 
60
- Contact
29
+ NexArt monetizes optional hosted services (attestation, verification, compliance), not the SDK.
61
30
 
62
- For future commercial licensing inquiries: arrotu@artnames.io
31
+ See [Core vs Edges](./docs/core-vs-edges.md) for details.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @nexart/codemode-sdk
2
2
 
3
- **Version: 1.8.2 (Protocol v1.2.0)**
3
+ **Version: 1.8.4 (Protocol v1.2.0)**
4
4
 
5
5
  A deterministic execution runtime for reproducible, verifiable computation.
6
6
 
@@ -236,7 +236,7 @@ These are examples — the SDK is designed for any system requiring deterministi
236
236
  |----------|-------|
237
237
  | Protocol Version | v1.2.0 |
238
238
  | Status | **STABLE** |
239
- | SDK Version | 1.8.2 |
239
+ | SDK Version | 1.8.4 |
240
240
 
241
241
  **Core protocol surface is frozen. Breaking changes require v2.0.0.**
242
242
 
@@ -450,6 +450,16 @@ See [CHANGELOG.md](./CHANGELOG.md) for version history.
450
450
 
451
451
  ---
452
452
 
453
+ ## License
454
+
455
+ **MIT License** — Free for all use, including commercial.
456
+
457
+ NexArt monetizes optional hosted services (attestation, verification, compliance), not the SDK.
458
+
459
+ See [Core vs Edges](./docs/core-vs-edges.md) for details on what's free vs paid.
460
+
461
+ ---
462
+
453
463
  ## About
454
464
 
455
465
  This SDK is a reference implementation of a deterministic execution protocol designed for replay, verification, and long-term stability.