@shlomoa/openui-spec 0.1.1 → 0.2.0

package/README.md

@@ -9,13 +9,15 @@ This repository contains a technology-independent specification for a Web UI fra
 Contributor and developer entry points for this repository:
 
 - [Contributing guide](CONTRIBUTING.md) — local setup and validation basics.
+- [Changelog](CHANGELOG.md) — release notes, breaking changes, and upgrade guidance.
 
 ## OpenUI JSON API
 
 The [`@shlomoa/openui-spec`](package.json) package provides `OpenUiJson` for
 loading, validating, and editing an OpenUI JSON document. It bundles
 `spec/openui.schema.json` and `spec/openui.json`; validation checks both the
-schema and the object types supported by the canonical catalog.
+schema and exact [known object type](spec/README.md#known-object-type)
+membership in the canonical catalog.
 
 ```bash
 npm install @shlomoa/openui-spec

package/dist/src/index.d.ts

@@ -42,6 +42,7 @@ export declare class OpenUiJson {
     }): void;
     updateAttributes(objectId: string, attributes: Record<string, string | null>): void;
     private validateChild;
+    private catalogTypes;
     private validateNode;
     private find;
     private findParent;

package/dist/src/index.js

@@ -77,15 +77,15 @@ class OpenUiJson {
         if (!validator(this.document)) {
             throw new OpenUiValidationError(formatValidationErrors(validator.errors));
         }
-        const supportedTypes = new Set([...this.walk(catalog)].map((node) => node.type));
+        const knownTypes = this.catalogTypes(catalog);
         const seenIds = new Set();
         for (const node of this.walk(this.document)) {
             if (seenIds.has(node.id)) {
                 throw new OpenUiValidationError(`duplicate object id: ${node.id}`);
             }
             seenIds.add(node.id);
-            if (!supportedTypes.has(node.type)) {
-                throw new OpenUiValidationError(`unsupported object type: ${node.type}`);
+            if (!knownTypes.has(node.type)) {
+                throw new OpenUiValidationError(`unknown OpenUI object type: ${node.type}`);
             }
         }
     }
@@ -164,18 +164,21 @@ class OpenUiJson {
     validateChild(child) {
         this.validateNode(child, false);
         const catalog = this.loadJson(this.options.catalog, this.options.catalogPath, "catalog");
-        const supportedTypes = new Set([...this.walk(catalog)].map((node) => node.type));
+        const knownTypes = this.catalogTypes(catalog);
         const seenIds = new Set();
         for (const node of this.walk(child)) {
             if (seenIds.has(node.id)) {
                 throw new OpenUiJsonError(`duplicate object id: ${node.id}`);
             }
             seenIds.add(node.id);
-            if (!supportedTypes.has(node.type)) {
-                throw new OpenUiJsonError(`unsupported object type: ${node.type}`);
+            if (!knownTypes.has(node.type)) {
+                throw new OpenUiJsonError(`unknown OpenUI object type: ${node.type}`);
             }
         }
     }
+    catalogTypes(catalog) {
+        return new Set([...this.walk(catalog)].map((node) => node.type));
+    }
     validateNode(node, isRoot) {
         const schema = this.loadJson(this.options.schema, this.options.schemaPath, "schema");
         const definition = isRoot ? schema : { $ref: "#/$defs/element", $defs: schema.$defs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shlomoa/openui-spec",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Load, validate, and edit OpenUI JSON documents.",
   "scripts": {
     "build:tsc": "tsc -p tsconfig.json",

package/spec/openui.json

@@ -1,7 +1,7 @@
 {
   "id": "root",
   "type": "html",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "attrs": {
     "name": "OpenUI",
     "description": "Technology-independent Web UI framework specification",