@microsoft/webui 0.0.17 → 0.0.19

package/dist/projection/manifest.js

@@ -0,0 +1,340 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Versioned deterministic JSON manifest schema for WebUI state projection.
+ *
+ * See DESIGN.md §"Bundler-Neutral State Projection Compiler" for the
+ * authoritative cross-language contract.
+ */
+import { createHash } from "node:crypto";
+/** The only valid schema string for this version. */
+export const MANIFEST_SCHEMA = "webui.state-projection/v1";
+/** Sentinel hash value for virtual modules/outputs with no physical bytes. */
+export const VIRTUAL_HASH = "virtual";
+/** Computes `"sha256:<64 lowercase hex>"` over exact UTF-8/byte content. */
+export function hashContent(content) {
+    const hash = createHash("sha256");
+    if (typeof content === "string")
+        hash.update(content, "utf8");
+    else
+        hash.update(content);
+    return `sha256:${hash.digest("hex")}`;
+}
+/** Cross-language lexical ordering: raw UTF-8 bytes, ascending. */
+export function compareUtf8(left, right) {
+    return Buffer.compare(Buffer.from(left, "utf8"), Buffer.from(right, "utf8"));
+}
+/**
+ * Computes the deterministic manifest `buildId`.
+ *
+ * Each canonical record is encoded as a record label followed by
+ * `<utf8-byte-length>:<value>` fields and one LF. Length-prefixing avoids
+ * delimiter ambiguity for paths and Unicode identifiers.
+ */
+export function computeBuildId(params) {
+    const records = [];
+    appendRecord(records, "schema", [MANIFEST_SCHEMA]);
+    appendRecord(records, "producer", [
+        params.producerName,
+        params.producerVersion,
+    ]);
+    appendRecord(records, "adapter", [
+        params.adapterName,
+        params.adapterBundler,
+    ]);
+    appendRecord(records, "root", [params.root]);
+    appendRecord(records, "analysis", [params.analysisHash]);
+    appendRecord(records, "inputs", [String(params.sortedInputs.length)]);
+    for (const [path, hash] of params.sortedInputs) {
+        appendRecord(records, "input", [path, hash]);
+    }
+    appendRecord(records, "outputs", [String(params.sortedOutputs.length)]);
+    for (const [path, hash] of params.sortedOutputs) {
+        appendRecord(records, "output", [path, hash]);
+    }
+    appendRecord(records, "components", [
+        String(params.sortedComponents.length),
+    ]);
+    for (const [tag, module, outputs, hydrationKeys, navigationKeys,] of params.sortedComponents) {
+        appendRecord(records, "component", [
+            tag,
+            module,
+            String(outputs.length),
+            ...outputs,
+            String(hydrationKeys.length),
+            ...hydrationKeys,
+            String(navigationKeys.length),
+            ...navigationKeys,
+        ]);
+    }
+    return hashContent(records.join(""));
+}
+function appendRecord(destination, label, fields) {
+    let record = label;
+    for (const field of fields) {
+        record += `${Buffer.byteLength(field, "utf8")}:${field}`;
+    }
+    destination.push(`${record}\n`);
+}
+/** Serializes a manifest to its canonical compact JSON form. */
+export function serializeManifestCanonical(manifest) {
+    const inputs = sortRecord(manifest.inputs);
+    const outputs = sortRecord(manifest.outputs);
+    const components = {};
+    for (const tag of Object.keys(manifest.components).sort(compareUtf8)) {
+        const entry = manifest.components[tag];
+        components[tag] = {
+            module: entry.module,
+            outputs: [...entry.outputs].sort(compareUtf8),
+            hydrationKeys: [...entry.hydrationKeys].sort(compareUtf8),
+            navigationKeys: [...entry.navigationKeys].sort(compareUtf8),
+        };
+    }
+    return JSON.stringify({
+        schema: manifest.schema,
+        producer: manifest.producer,
+        adapter: manifest.adapter,
+        root: manifest.root,
+        analysisHash: manifest.analysisHash,
+        buildId: manifest.buildId,
+        outputs,
+        inputs,
+        components,
+    });
+}
+function sortRecord(value) {
+    const result = {};
+    for (const key of Object.keys(value).sort(compareUtf8)) {
+        result[key] = value[key];
+    }
+    return result;
+}
+/**
+ * Validates a parsed manifest's structural and canonical invariants.
+ *
+ * Stale file validation is intentionally performed by the consuming host.
+ */
+export function validateManifestSchema(value) {
+    const errors = new Set();
+    if (!isRecord(value))
+        return ["PROJ-M008"];
+    rejectUnknownKeys(value, [
+        "schema",
+        "producer",
+        "adapter",
+        "root",
+        "analysisHash",
+        "buildId",
+        "outputs",
+        "inputs",
+        "components",
+    ], errors);
+    if (value["schema"] !== MANIFEST_SCHEMA)
+        errors.add("PROJ-M002");
+    if (!isProducerInfo(value["producer"]))
+        errors.add("PROJ-M009");
+    if (!isAdapterInfo(value["adapter"]))
+        errors.add("PROJ-M009");
+    if (typeof value["root"] !== "string" ||
+        !isCanonicalRoot(value["root"])) {
+        errors.add("PROJ-S003");
+    }
+    if (!isSha256(value["analysisHash"]) || !isSha256(value["buildId"])) {
+        errors.add("PROJ-S004");
+    }
+    const inputs = validateHashRecord(value["inputs"], errors);
+    const outputs = validateHashRecord(value["outputs"], errors);
+    validateComponents(value["components"], inputs, outputs, errors);
+    return [...errors];
+}
+function validateHashRecord(value, errors) {
+    if (!isRecord(value)) {
+        errors.add("PROJ-M009");
+        return undefined;
+    }
+    const keys = Object.keys(value);
+    if (!isSortedUnique(keys))
+        errors.add("PROJ-M009");
+    for (const [path, hash] of Object.entries(value)) {
+        if (typeof hash !== "string" || !isHash(hash)) {
+            errors.add("PROJ-S004");
+            continue;
+        }
+        const virtual = isVirtualPath(path);
+        if (!virtual && !isCanonicalFilePath(path))
+            errors.add("PROJ-S003");
+        if ((virtual && hash !== VIRTUAL_HASH) ||
+            (!virtual && hash === VIRTUAL_HASH)) {
+            errors.add("PROJ-S004");
+        }
+    }
+    return value;
+}
+function validateComponents(value, inputs, outputs, errors) {
+    if (!isRecord(value)) {
+        errors.add("PROJ-M009");
+        return;
+    }
+    const tags = Object.keys(value);
+    if (tags.length > 65_535)
+        errors.add("PROJ-S002");
+    if (!isSortedUnique(tags))
+        errors.add("PROJ-M009");
+    for (const [tag, rawEntry] of Object.entries(value)) {
+        if (!isComponentTag(tag) || !isRecord(rawEntry)) {
+            errors.add("PROJ-M009");
+            continue;
+        }
+        rejectUnknownKeys(rawEntry, ["module", "outputs", "hydrationKeys", "navigationKeys"], errors);
+        const module = rawEntry["module"];
+        const componentOutputs = rawEntry["outputs"];
+        const hydrationKeys = rawEntry["hydrationKeys"];
+        const navigationKeys = rawEntry["navigationKeys"];
+        if (typeof module !== "string" ||
+            !isCanonicalFilePath(module) ||
+            inputs?.[module] === undefined ||
+            inputs[module] === VIRTUAL_HASH) {
+            errors.add("PROJ-M009");
+        }
+        if (!isStringArray(componentOutputs) ||
+            componentOutputs.length === 0 ||
+            !isSortedUnique(componentOutputs)) {
+            errors.add("PROJ-M009");
+        }
+        else {
+            for (const output of componentOutputs) {
+                if (outputs?.[output] === undefined)
+                    errors.add("PROJ-M009");
+            }
+        }
+        if (!isStringArray(hydrationKeys) ||
+            !isSortedUnique(hydrationKeys) ||
+            !isStringArray(navigationKeys) ||
+            !isSortedUnique(navigationKeys)) {
+            errors.add("PROJ-M009");
+        }
+        else if (hydrationKeys.some((key) => key.length === 0 || hasControlCharacter(key)) ||
+            navigationKeys.some((key) => key.length === 0 || hasControlCharacter(key)) ||
+            hydrationKeys.some((key) => binarySearch(navigationKeys, key) === false)) {
+            errors.add("PROJ-M009");
+        }
+    }
+}
+function rejectUnknownKeys(value, allowed, errors) {
+    const allowedSet = new Set(allowed);
+    if (Object.keys(value).some((key) => !allowedSet.has(key))) {
+        errors.add("PROJ-M009");
+    }
+}
+function isProducerInfo(value) {
+    if (!isRecord(value))
+        return false;
+    const keys = Object.keys(value);
+    return (keys.length === 2 &&
+        keys.includes("name") &&
+        keys.includes("version") &&
+        value["name"] === "@microsoft/webui/projection.js" &&
+        typeof value["version"] === "string" &&
+        value["version"].length > 0);
+}
+function isAdapterInfo(value) {
+    if (!isRecord(value))
+        return false;
+    const keys = Object.keys(value);
+    return (keys.length === 2 &&
+        keys.includes("name") &&
+        keys.includes("bundler") &&
+        typeof value["name"] === "string" &&
+        value["name"].length > 0 &&
+        typeof value["bundler"] === "string" &&
+        value["bundler"].length > 0);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+function isHash(value) {
+    return value === VIRTUAL_HASH || isSha256(value);
+}
+function isSha256(value) {
+    if (typeof value !== "string" || value.length !== 71)
+        return false;
+    if (!value.startsWith("sha256:"))
+        return false;
+    for (let index = 7; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        const digit = code >= 48 && code <= 57;
+        const lowerHex = code >= 97 && code <= 102;
+        if (!digit && !lowerHex)
+            return false;
+    }
+    return true;
+}
+function isCanonicalRoot(value) {
+    if (value === ".")
+        return true;
+    const segments = value.split("/");
+    return segments.length <= 32 && segments.every((segment) => segment === "..");
+}
+function isVirtualPath(value) {
+    return value.startsWith("virtual:");
+}
+function isCanonicalFilePath(value) {
+    if (value.length === 0 ||
+        value.startsWith("/") ||
+        value.startsWith("./") ||
+        value.includes("\\") ||
+        hasControlCharacter(value)) {
+        return false;
+    }
+    const segments = value.split("/");
+    return segments.every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+function isComponentTag(value) {
+    if (value.length < 3 || !value.includes("-"))
+        return false;
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        const valid = (code >= 97 && code <= 122) ||
+            (code >= 48 && code <= 57) ||
+            code === 45 ||
+            code === 46 ||
+            code === 95;
+        if (!valid)
+            return false;
+    }
+    return value.charCodeAt(0) >= 97 && value.charCodeAt(0) <= 122;
+}
+function isSortedUnique(values) {
+    for (let index = 1; index < values.length; index++) {
+        if (compareUtf8(values[index - 1], values[index]) >= 0)
+            return false;
+    }
+    return true;
+}
+function binarySearch(values, target) {
+    let low = 0;
+    let high = values.length;
+    while (low < high) {
+        const middle = low + ((high - low) >> 1);
+        const order = compareUtf8(values[middle], target);
+        if (order === 0)
+            return true;
+        if (order < 0)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    return false;
+}
+function hasControlCharacter(value) {
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        if (code <= 31 || code === 127)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/projection/manifest.js.map

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

package/package.json

@@ -2,7 +2,7 @@
   "name": "@microsoft/webui",
   "description": "WebUI — high-performance server-side rendering framework. Build-time protocol compiler and streaming renderer.",
   "license": "MIT",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "type": "module",
   "repository": {
     "type": "git",
@@ -13,7 +13,10 @@
   },
   "files": [
     "bin/",
-    "dist/",
+    "dist/index.*",
+    "dist/install.*",
+    "dist/platform.*",
+    "dist/projection/",
     "wasm/"
   ],
   "engines": {
@@ -31,24 +34,43 @@
         "types": "./dist/platform.d.ts",
         "default": "./dist/platform.js"
       }
+    },
+    "./projection.js": {
+      "import": {
+        "types": "./dist/projection/index.d.ts",
+        "default": "./dist/projection/index.js"
+      }
     }
   },
   "optionalDependencies": {
-    "@microsoft/webui-darwin-arm64": "0.0.17",
-    "@microsoft/webui-linux-arm64": "0.0.17",
-    "@microsoft/webui-darwin-x64": "0.0.17",
-    "@microsoft/webui-linux-x64": "0.0.17",
-    "@microsoft/webui-win32-arm64": "0.0.17",
-    "@microsoft/webui-win32-x64": "0.0.17"
+    "@microsoft/webui-darwin-arm64": "0.0.19",
+    "@microsoft/webui-linux-x64": "0.0.19",
+    "@microsoft/webui-linux-arm64": "0.0.19",
+    "@microsoft/webui-win32-x64": "0.0.19",
+    "@microsoft/webui-win32-arm64": "0.0.19",
+    "@microsoft/webui-darwin-x64": "0.0.19"
+  },
+  "peerDependencies": {
+    "esbuild": "^0.28.1",
+    "typescript": "^6.0.3"
+  },
+  "peerDependenciesMeta": {
+    "esbuild": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@types/node": "^25.3.5",
-    "typescript": "^5.9.3"
+    "@types/node": "^26.1.0",
+    "esbuild": "^0.28.1",
+    "typescript": "^6.0.3"
   },
   "scripts": {
     "build": "tsc",
     "postbuild": "node dist/install.js",
     "postinstall": "node --input-type=module -e \"try{await import('./dist/install.js')}catch{}\"",
-    "test": "tsc --project tsconfig.test.json && node --test dist/test/integration.test.js"
+    "test": "tsc --project tsconfig.test.json && node --test dist/test/integration.test.js dist/test/projection-cli-fallback.test.js dist/test/projection-conformance.test.js dist/test/projection-compiler.test.js dist/test/projection-esbuild.test.js dist/test/projection-peers.test.js"
   }
 }