@watt42/a2ui-component-catalog 0.1.0

package/dist/validateProps.js

@@ -0,0 +1,101 @@
+function typeName(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+function isBindingContract(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "path" in value &&
+        typeof value.path === "string" &&
+        Boolean(String(value.path).trim()));
+}
+function matchesType(expected, value) {
+    if (!expected)
+        return true;
+    if (expected === "string")
+        return typeof value === "string" || isBindingContract(value);
+    if (expected === "boolean")
+        return typeof value === "boolean";
+    if (expected === "number")
+        return typeof value === "number" && Number.isFinite(value);
+    if (expected === "array")
+        return Array.isArray(value);
+    if (expected === "object")
+        return typeof value === "object" && value !== null && !Array.isArray(value);
+    return true;
+}
+function validateValue(path, definition, value) {
+    const errors = [];
+    if (!matchesType(definition.type, value)) {
+        errors.push(`${path}: expected ${definition.type}, got ${typeName(value)}`);
+        return errors;
+    }
+    if (definition.enum && !definition.enum.includes(value)) {
+        errors.push(`${path}: value ${JSON.stringify(value)} is not one of ${definition.enum.map((item) => JSON.stringify(item)).join(", ")}`);
+    }
+    if (definition.type === "array" && Array.isArray(value)) {
+        if (definition.required && value.length === 0) {
+            errors.push(`${path}: array must not be empty`);
+        }
+        if (definition.items) {
+            value.forEach((item, index) => {
+                errors.push(...validateValue(`${path}[${index}]`, definition.items, item));
+            });
+        }
+    }
+    if (definition.type === "object" &&
+        value &&
+        typeof value === "object" &&
+        !Array.isArray(value)) {
+        const nested = definition.properties ?? {};
+        const record = value;
+        for (const [key, sub] of Object.entries(nested)) {
+            if (sub.required && !(key in record)) {
+                errors.push(`${path}.${key}: required`);
+            }
+            else if (key in record) {
+                errors.push(...validateValue(`${path}.${key}`, sub, record[key]));
+            }
+        }
+        for (const key of Object.keys(record)) {
+            if (!(key in nested) && Object.keys(nested).length > 0) {
+                errors.push(`${path}.${key}: unknown property`);
+            }
+        }
+    }
+    return errors;
+}
+export function validateComponentProps(definition, props) {
+    const errors = [];
+    for (const [key, value] of Object.entries(props)) {
+        const propDef = definition.props[key];
+        if (!propDef) {
+            errors.push(`Unknown prop '${key}' on ${definition.name}`);
+            continue;
+        }
+        errors.push(...validateValue(`${definition.name}.${key}`, propDef, value));
+    }
+    for (const [key, propDef] of Object.entries(definition.props)) {
+        if (propDef.required && !(key in props)) {
+            errors.push(`${definition.name}.${key}: required`);
+        }
+    }
+    if (definition.allowedChildren === "none" && "children" in props) {
+        errors.push(`${definition.name} does not allow children`);
+    }
+    if (definition.name === "Chart") {
+        const categories = props.categories;
+        const series = props.series;
+        if (Array.isArray(categories) && categories.length === 0) {
+            errors.push("Chart.categories: array must not be empty");
+        }
+        if (Array.isArray(series) && series.length === 0) {
+            errors.push("Chart.series: array must not be empty");
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validateProps.js.map

package/dist/validateProps.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@watt42/a2ui-component-catalog",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "A2UI component metadata source of truth",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "catalog.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "generate:catalog": "tsx scripts/generate-catalog.ts",
+    "check:catalog-drift": "tsx scripts/check-catalog-drift.ts",
+    "test": "tsx --test test/**/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}