@aelionsdk/material-compiler 0.1.0-beta.1 → 1.1.0-rc.1

package/README.md

@@ -1,7 +1,28 @@
-# @aelionsdk/material-compiler
+# `@aelionsdk/material-compiler`
 
-Aelion Material Protocol graph compiler for WebGL2 and WebGPU
+Typed Aelion Material Protocol graph compiler for WebGL2 and WebGPU.
 
-Install with `npm install @aelionsdk/material-compiler@next`.
+## Install
 
-Version 0.1.0-beta.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.
+```bash
+npm install @aelionsdk/material-compiler@next
+```
+
+`next` currently resolves to `1.1.0-rc.1`. Material authors should normally use
+`@aelionsdk/material-sdk`; import this package directly to build a custom
+compiler, renderer or validation host.
+
+## Public surface
+
+- Core Node registry and typed graph validation;
+- graph compilation and resource-budget diagnostics;
+- WebGL2 and WebGPU program generation;
+- compiler input, output and backend types.
+
+Treat generated Shader/WASM code as untrusted unless the host explicitly
+authorizes its publisher and execution mode. Compilation success does not
+bypass runtime resource budgets.
+
+See the [Material guide](https://foyonaczy.github.io/AelionSDK/guides/materials/)
+and [API reference](https://foyonaczy.github.io/AelionSDK/api/aelionsdk/material-compiler/overview/).
+Licensed under MIT.

package/dist/codegen-common.d.ts

@@ -0,0 +1,6 @@
+import type { JsonValue } from '@aelionsdk/core';
+import type { MaterialGraph } from './types.js';
+export declare function identifier(value: string): string;
+export declare function literal(value: JsonValue, backend: string): string;
+export declare function graphHash(graph: MaterialGraph): string;
+//# sourceMappingURL=codegen-common.d.ts.map

package/dist/codegen-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen-common.d.ts","sourceRoot":"","sources":["../src/codegen-common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAQtD"}

package/dist/codegen-common.js

@@ -0,0 +1,18 @@
+export function identifier(value) {
+    return value.replaceAll(/[^a-zA-Z0-9_]/gu, '_');
+}
+export function literal(value, backend) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TypeError(`${backend} material expressions only support finite numeric literals`);
+    }
+    return Number.isInteger(value) ? `${value.toString()}.0` : value.toString();
+}
+export function graphHash(graph) {
+    const serialized = JSON.stringify(graph);
+    let hash = 2_166_136_261;
+    for (let index = 0; index < serialized.length; index += 1) {
+        hash ^= serialized.charCodeAt(index);
+        hash = Math.imul(hash, 16_777_619);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}

package/dist/webgl2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl2.d.ts","sourceRoot":"","sources":["../src/webgl2.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEb,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAySpB,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA+FvB"}
+{"version":3,"file":"webgl2.d.ts","sourceRoot":"","sources":["../src/webgl2.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEb,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAoRpB,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA+FvB"}

package/dist/webgl2.js

@@ -1,23 +1,6 @@
 import { buildMaterialExecutionPlan, compileMaterialGraph } from './compiler.js';
+import { graphHash, identifier, literal } from './codegen-common.js';
 import { compileMaterialGraphToWebGpu } from './webgpu.js';
-function identifier(value) {
-    return value.replaceAll(/[^a-zA-Z0-9_]/gu, '_');
-}
-function literal(value) {
-    if (typeof value !== 'number' || !Number.isFinite(value)) {
-        throw new TypeError('WebGL2 material expressions only support finite numeric literals');
-    }
-    return Number.isInteger(value) ? `${value.toString()}.0` : value.toString();
-}
-function graphHash(graph) {
-    const serialized = JSON.stringify(graph);
-    let hash = 2_166_136_261;
-    for (let index = 0; index < serialized.length; index += 1) {
-        hash ^= serialized.charCodeAt(index);
-        hash = Math.imul(hash, 16_777_619);
-    }
-    return (hash >>> 0).toString(16).padStart(8, '0');
-}
 function uniformFor(binding, uniforms) {
     if ('parameter' in binding) {
         const name = `u_parameter_${identifier(binding.parameter)}`;
@@ -37,7 +20,7 @@ function uniformFor(binding, uniforms) {
 }
 function bindingExpression(binding, nodeExpressions, inputPorts, uniforms) {
     if ('value' in binding)
-        return literal(binding.value);
+        return literal(binding.value, 'WebGL2');
     const uniform = uniformFor(binding, uniforms);
     if (uniform !== undefined)
         return uniform;

package/dist/webgpu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu.d.ts","sourceRoot":"","sources":["../src/webgpu.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEb,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAkJpB,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA0EvB"}
+{"version":3,"file":"webgpu.d.ts","sourceRoot":"","sources":["../src/webgpu.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEb,qBAAqB,EACtB,MAAM,YAAY,CAAC;AA6HpB,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA0EvB"}

package/dist/webgpu.js

@@ -1,22 +1,5 @@
 import { buildMaterialExecutionPlan, compileMaterialGraph } from './compiler.js';
-function identifier(value) {
-    return value.replaceAll(/[^a-zA-Z0-9_]/gu, '_');
-}
-function literal(value) {
-    if (typeof value !== 'number' || !Number.isFinite(value)) {
-        throw new TypeError('WebGPU material expressions only support finite numeric literals');
-    }
-    return Number.isInteger(value) ? `${value.toString()}.0` : value.toString();
-}
-function graphHash(graph) {
-    const serialized = JSON.stringify(graph);
-    let hash = 2_166_136_261;
-    for (let index = 0; index < serialized.length; index += 1) {
-        hash ^= serialized.charCodeAt(index);
-        hash = Math.imul(hash, 16_777_619);
-    }
-    return (hash >>> 0).toString(16).padStart(8, '0');
-}
+import { graphHash, identifier, literal } from './codegen-common.js';
 function uniformExpression(binding, uniforms) {
     let source;
     if ('parameter' in binding)
@@ -34,7 +17,7 @@ function uniformExpression(binding, uniforms) {
 }
 function bindingExpression(binding, nodeExpressions, inputPorts, uniforms) {
     if ('value' in binding)
-        return literal(binding.value);
+        return literal(binding.value, 'WebGPU');
     const uniform = uniformExpression(binding, uniforms);
     if (uniform !== undefined)
         return uniform;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/material-compiler",
-  "version": "0.1.0-beta.1",
+  "version": "1.1.0-rc.1",
   "description": "Aelion Material Protocol graph compiler for WebGL2 and WebGPU",
   "license": "MIT",
   "repository": {
@@ -27,14 +27,14 @@
     "!dist/.tsbuildinfo"
   ],
   "engines": {
-    "node": ">=20.19"
+    "node": ">=24 <25"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "0.1.0-beta.1"
+    "@aelionsdk/core": "1.1.0-rc.1"
   },
   "scripts": {
     "build": "tsc -b",