@kurot/ui-document 0.1.0

package/dist/kurot/serialization/UIDocumentValidationError.js

@@ -0,0 +1,16 @@
+/**
+ * Error raised when an in-memory document cannot be safely serialized.
+ */
+export class UIDocumentValidationError extends Error {
+    /**
+     * Structured failures suitable for editor and Agent feedback.
+     */
+    diagnostics;
+    constructor(diagnostics) {
+        const detail = diagnostics[0]?.message ?? 'Unknown document error.';
+        super(`Unable to serialize UI document: ${detail}`);
+        this.name = 'UIDocumentValidationError';
+        this.diagnostics = diagnostics;
+    }
+}
+//# sourceMappingURL=UIDocumentValidationError.js.map

package/dist/kurot/serialization/UIDocumentValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIDocumentValidationError.js","sourceRoot":"","sources":["../../../src/kurot/serialization/UIDocumentValidationError.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACnD;;OAEG;IACa,WAAW,CAA0B;IAErD,YAAmB,WAAoC;QACtD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,yBAAyB,CAAC;QACpE,KAAK,CAAC,oCAAoC,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;CACD"}

package/dist/kurot/serialization/index.d.ts

@@ -0,0 +1,4 @@
+export { UIDocumentParseError } from './UIDocumentParseError.js';
+export { UIDocumentValidationError } from './UIDocumentValidationError.js';
+export { parseUIDocument, serializeUIDocument } from './json.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/kurot/serialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/kurot/serialization/index.js

@@ -0,0 +1,4 @@
+export { UIDocumentParseError } from './UIDocumentParseError.js';
+export { UIDocumentValidationError } from './UIDocumentValidationError.js';
+export { parseUIDocument, serializeUIDocument } from './json.js';
+//# sourceMappingURL=index.js.map

package/dist/kurot/serialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/serialization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/kurot/serialization/json.d.ts

@@ -0,0 +1,10 @@
+import type { UIDocument } from '../model/UIDocument.js';
+/**
+ * Serializes a document with stable schema and property-key ordering.
+ */
+export declare function serializeUIDocument(document: UIDocument, space?: number): string;
+/**
+ * Parses and validates a current-format semantic UI document.
+ */
+export declare function parseUIDocument(source: string): UIDocument;
+//# sourceMappingURL=json.d.ts.map

package/dist/kurot/serialization/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQzD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,SAAI,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAwB1D"}

package/dist/kurot/serialization/json.js

@@ -0,0 +1,78 @@
+import { isUIDocument, validateUIDocument } from '../validation/validateUIDocument.js';
+import { UIDocumentParseError } from './UIDocumentParseError.js';
+import { UIDocumentValidationError } from './UIDocumentValidationError.js';
+/**
+ * Serializes a document with stable schema and property-key ordering.
+ */
+export function serializeUIDocument(document, space = 2) {
+    const diagnostics = validateUIDocument(document);
+    if (diagnostics.length > 0) {
+        throw new UIDocumentValidationError(diagnostics);
+    }
+    return JSON.stringify(normalizeDocument(document), undefined, space);
+}
+/**
+ * Parses and validates a current-format semantic UI document.
+ */
+export function parseUIDocument(source) {
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Input is not valid JSON.';
+        const diagnostics = [
+            {
+                code: 'invalid-json',
+                severity: 'error',
+                path: '$',
+                message,
+            },
+        ];
+        throw new UIDocumentParseError(diagnostics, error instanceof Error ? error : undefined);
+    }
+    if (!isUIDocument(value)) {
+        throw new UIDocumentParseError(validateUIDocument(value));
+    }
+    return value;
+}
+function normalizeDocument(document) {
+    return {
+        kind: document.kind,
+        formatVersion: document.formatVersion,
+        id: document.id,
+        root: normalizeNode(document.root),
+    };
+}
+function normalizeNode(node) {
+    const entries = Object.keys(node.properties)
+        .sort()
+        .map((key) => [
+        key,
+        normalizePropertyValue(node.properties[key]),
+    ]);
+    const properties = Object.fromEntries(entries);
+    return {
+        id: node.id,
+        type: node.type,
+        properties,
+        children: node.children.map(normalizeNode),
+    };
+}
+function normalizePropertyValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(normalizePropertyValue);
+    }
+    if (typeof value === 'object') {
+        const objectValue = value;
+        const entries = Object.keys(objectValue)
+            .sort()
+            .map((key) => [
+            key,
+            normalizePropertyValue(objectValue[key]),
+        ]);
+        return Object.fromEntries(entries);
+    }
+    return value;
+}
+//# sourceMappingURL=json.js.map

package/dist/kurot/serialization/json.js.map

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

package/dist/kurot/validation/UIDiagnostic.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Stable diagnostic categories emitted by document validation.
+ */
+export type UIDiagnosticCode = 'abstract-component-type' | 'circular-component-inheritance' | 'duplicate-node-id' | 'invalid-component-children' | 'invalid-component-property' | 'invalid-document' | 'invalid-json' | 'invalid-property-value' | 'invalid-value' | 'missing-component-property' | 'missing-component-base' | 'unexpected-property' | 'unknown-component-property' | 'unknown-component-type' | 'unsupported-version';
+/**
+ * Severity of a document diagnostic.
+ */
+export type UIDiagnosticSeverity = 'error' | 'warning';
+/**
+ * Machine-readable validation result with a JSON-style source path.
+ */
+export interface UIDiagnostic {
+    /**
+     * Stable category suitable for programmatic handling.
+     */
+    readonly code: UIDiagnosticCode;
+    /**
+     * Current validation impact.
+     */
+    readonly severity: UIDiagnosticSeverity;
+    /**
+     * JSON-style path to the offending value.
+     */
+    readonly path: string;
+    /**
+     * Human-readable explanation intended for tools and Agent feedback.
+     */
+    readonly message: string;
+}
+//# sourceMappingURL=UIDiagnostic.d.ts.map

package/dist/kurot/validation/UIDiagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIDiagnostic.d.ts","sourceRoot":"","sources":["../../../src/kurot/validation/UIDiagnostic.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACzB,yBAAyB,GACzB,gCAAgC,GAChC,mBAAmB,GACnB,4BAA4B,GAC5B,4BAA4B,GAC5B,kBAAkB,GAClB,cAAc,GACd,wBAAwB,GACxB,eAAe,GACf,4BAA4B,GAC5B,wBAAwB,GACxB,qBAAqB,GACrB,4BAA4B,GAC5B,wBAAwB,GACxB,qBAAqB,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB"}

package/dist/kurot/validation/UIDiagnostic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UIDiagnostic.js.map

package/dist/kurot/validation/UIDiagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIDiagnostic.js","sourceRoot":"","sources":["../../../src/kurot/validation/UIDiagnostic.ts"],"names":[],"mappings":""}

package/dist/kurot/validation/index.d.ts

@@ -0,0 +1,3 @@
+export type { UIDiagnostic, UIDiagnosticCode, UIDiagnosticSeverity, } from './UIDiagnostic.js';
+export { isUIDocument, validateUIDocument } from './validateUIDocument.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/kurot/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kurot/validation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/kurot/validation/index.js

@@ -0,0 +1,2 @@
+export { isUIDocument, validateUIDocument } from './validateUIDocument.js';
+//# sourceMappingURL=index.js.map

package/dist/kurot/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kurot/validation/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/kurot/validation/validateUIDocument.d.ts

@@ -0,0 +1,11 @@
+import type { UIDocument } from '../model/UIDocument.js';
+import type { UIDiagnostic } from './UIDiagnostic.js';
+/**
+ * Validates unknown input against the current semantic document format.
+ */
+export declare function validateUIDocument(value: unknown): UIDiagnostic[];
+/**
+ * Returns whether unknown input is a valid current-format UI document.
+ */
+export declare function isUIDocument(value: unknown): value is UIDocument;
+//# sourceMappingURL=validateUIDocument.d.ts.map

package/dist/kurot/validation/validateUIDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateUIDocument.d.ts","sourceRoot":"","sources":["../../../src/kurot/validation/validateUIDocument.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AAKxE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAgBjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}

package/dist/kurot/validation/validateUIDocument.js

@@ -0,0 +1,143 @@
+import { UI_DOCUMENT_KIND } from '../model/UIDocument.js';
+import { UI_DOCUMENT_FORMAT_VERSION } from '../version.js';
+const DOCUMENT_KEYS = new Set(['kind', 'formatVersion', 'id', 'root']);
+const NODE_KEYS = new Set(['id', 'type', 'properties', 'children']);
+/**
+ * Validates unknown input against the current semantic document format.
+ */
+export function validateUIDocument(value) {
+    const diagnostics = [];
+    if (!isRecord(value)) {
+        addDiagnostic(diagnostics, 'invalid-document', '$', 'Document must be an object.');
+        return diagnostics;
+    }
+    validateKnownKeys(value, DOCUMENT_KEYS, '$', diagnostics);
+    validateExactValue(value.kind, UI_DOCUMENT_KIND, '$.kind', diagnostics);
+    validateFormatVersion(value.formatVersion, diagnostics);
+    validateNonEmptyString(value.id, '$.id', 'Document id', diagnostics);
+    const nodeIds = new Map();
+    const nodeStack = new WeakSet();
+    validateNode(value.root, '$.root', diagnostics, nodeIds, nodeStack);
+    return diagnostics;
+}
+/**
+ * Returns whether unknown input is a valid current-format UI document.
+ */
+export function isUIDocument(value) {
+    return validateUIDocument(value).length === 0;
+}
+function validateNode(value, path, diagnostics, nodeIds, nodeStack) {
+    if (!isRecord(value)) {
+        addDiagnostic(diagnostics, 'invalid-value', path, 'Node must be an object.');
+        return;
+    }
+    if (nodeStack.has(value)) {
+        addDiagnostic(diagnostics, 'invalid-value', path, 'Node tree must not contain cycles.');
+        return;
+    }
+    nodeStack.add(value);
+    validateKnownKeys(value, NODE_KEYS, path, diagnostics);
+    validateNodeId(value.id, `${path}.id`, diagnostics, nodeIds);
+    validateNonEmptyString(value.type, `${path}.type`, 'Node type', diagnostics);
+    validateProperties(value.properties, `${path}.properties`, diagnostics);
+    if (!Array.isArray(value.children)) {
+        addDiagnostic(diagnostics, 'invalid-value', `${path}.children`, 'Node children must be an array.');
+    }
+    else {
+        for (let index = 0; index < value.children.length; index++) {
+            validateNode(value.children[index], `${path}.children[${index}]`, diagnostics, nodeIds, nodeStack);
+        }
+    }
+    nodeStack.delete(value);
+}
+function validateNodeId(value, path, diagnostics, nodeIds) {
+    if (!validateNonEmptyString(value, path, 'Node id', diagnostics))
+        return;
+    const firstPath = nodeIds.get(value);
+    if (firstPath) {
+        addDiagnostic(diagnostics, 'duplicate-node-id', path, `Node id "${value}" is already used at ${firstPath}.`);
+        return;
+    }
+    nodeIds.set(value, path);
+}
+function validateProperties(value, path, diagnostics) {
+    if (!isRecord(value)) {
+        addDiagnostic(diagnostics, 'invalid-value', path, 'Node properties must be an object.');
+        return;
+    }
+    const valueStack = new WeakSet();
+    for (const [key, propertyValue] of Object.entries(value)) {
+        validatePropertyValue(propertyValue, `${path}.${key}`, diagnostics, valueStack);
+    }
+}
+function validatePropertyValue(value, path, diagnostics, valueStack) {
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            addDiagnostic(diagnostics, 'invalid-property-value', path, 'Numeric property values must be finite.');
+        }
+        return;
+    }
+    if (!value || typeof value !== 'object') {
+        addDiagnostic(diagnostics, 'invalid-property-value', path, 'Property value must be serializable and must not be null or undefined.');
+        return;
+    }
+    if (valueStack.has(value)) {
+        addDiagnostic(diagnostics, 'invalid-property-value', path, 'Property value must not contain cyclic references.');
+        return;
+    }
+    valueStack.add(value);
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index++) {
+            validatePropertyValue(value[index], `${path}[${index}]`, diagnostics, valueStack);
+        }
+    }
+    else if (isRecord(value)) {
+        for (const [key, nestedValue] of Object.entries(value)) {
+            validatePropertyValue(nestedValue, `${path}.${key}`, diagnostics, valueStack);
+        }
+    }
+    else {
+        addDiagnostic(diagnostics, 'invalid-property-value', path, 'Property object must be a plain string-keyed object.');
+    }
+    valueStack.delete(value);
+}
+function validateFormatVersion(value, diagnostics) {
+    if (!Number.isInteger(value)) {
+        addDiagnostic(diagnostics, 'invalid-value', '$.formatVersion', 'Format version must be an integer.');
+        return;
+    }
+    if (value !== UI_DOCUMENT_FORMAT_VERSION) {
+        addDiagnostic(diagnostics, 'unsupported-version', '$.formatVersion', `Format version ${String(value)} is not supported. Expected ${UI_DOCUMENT_FORMAT_VERSION}.`);
+    }
+}
+function validateExactValue(value, expected, path, diagnostics) {
+    if (value !== expected) {
+        addDiagnostic(diagnostics, 'invalid-value', path, `Value must be "${expected}".`);
+    }
+}
+function validateNonEmptyString(value, path, label, diagnostics) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        addDiagnostic(diagnostics, 'invalid-value', path, `${label} must be a non-empty string.`);
+        return false;
+    }
+    return true;
+}
+function validateKnownKeys(value, knownKeys, path, diagnostics) {
+    for (const key of Object.keys(value)) {
+        if (knownKeys.has(key))
+            continue;
+        addDiagnostic(diagnostics, 'unexpected-property', `${path}.${key}`, `Property "${key}" is not part of the current document format.`);
+    }
+}
+function isRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function addDiagnostic(diagnostics, code, path, message) {
+    diagnostics.push({ code, severity: 'error', path, message });
+}
+//# sourceMappingURL=validateUIDocument.js.map

package/dist/kurot/validation/validateUIDocument.js.map

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

package/dist/kurot/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Latest semantic document format understood by this package.
+ */
+export declare const UI_DOCUMENT_FORMAT_VERSION = 1;
+//# sourceMappingURL=version.d.ts.map

package/dist/kurot/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/kurot/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC"}

package/dist/kurot/version.js

@@ -0,0 +1,5 @@
+/**
+ * Latest semantic document format understood by this package.
+ */
+export const UI_DOCUMENT_FORMAT_VERSION = 1;
+//# sourceMappingURL=version.js.map

package/dist/kurot/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/kurot/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@kurot/ui-document",
+	"version": "0.1.0",
+	"description": "Headless semantic document model for Kurot UI tooling, editors, CLI workflows, and AI agents",
+	"author": "Kelvin <kyia.x52@gmail.com>",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist/**/*",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "tsc --build",
+		"dev": "tsc --watch",
+		"clean": "rm -rf dist",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"typescript": "^5.6.0",
+		"vitest": "^4.1.4"
+	},
+	"keywords": [
+		"kurot",
+		"ui",
+		"document-model",
+		"game-editor",
+		"typescript"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kurot-engine/kurot.git",
+		"directory": "packages/ui-document"
+	},
+	"packageManager": "pnpm@10.33.0",
+	"publishConfig": {
+		"access": "public"
+	}
+}