@widgentic/designer 0.1.0

package/dist/validate.js

@@ -0,0 +1,131 @@
+/**
+ * The designer's derive step: run widgentic's pure validators over the
+ * draft and shape their structured errors into per-panel diagnostics.
+ * Everything here goes through public package entries — the designer owns
+ * no validation logic of its own.
+ */
+import { isPlainObject } from "@widgentic/core";
+import { createCatalog, validateDataAgainstSchema, widgetStylesToCss } from "@widgentic/core";
+import { collectActionRefs, parsePath, validateTemplate } from "@widgentic/core";
+import { validateLoadBinding } from "@widgentic/core";
+import { validateTheme } from "@widgentic/core";
+/**
+ * The schema validation actually runs against: the inline one, or the
+ * referenced shared one resolved from the supplied list — the same join
+ * the server's composition performs.
+ */
+export function effectiveDataSchema(draft, schemas = []) {
+    const ref = draft.descriptor?.dataSchemaRef;
+    if (typeof ref === "string") {
+        return schemas.find((entry) => entry.name === ref)?.schema;
+    }
+    const inline = draft.descriptor?.dataSchema;
+    return isPlainObject(inline) ? inline : undefined;
+}
+const BASE_KINDS = new Set(createCatalog().kinds());
+/**
+ * Detect style entries the renderer would skip, using only the public
+ * generator: a probe that produces no CSS was filtered by the safety
+ * guards. Selector and per-declaration issues are reported separately.
+ */
+function auditStyles(styles) {
+    if (!isPlainObject(styles))
+        return [];
+    const issues = [];
+    for (const [selector, declarations] of Object.entries(styles)) {
+        if (widgetStylesToCss({ [selector]: { color: "red" } }) === "") {
+            issues.push({
+                selector,
+                message: "Selector would be skipped — every comma-separated part must target a .wg- class and avoid ;{}<>@\\."
+            });
+            continue;
+        }
+        if (!isPlainObject(declarations)) {
+            issues.push({ selector, message: "Declarations must be a property → value map." });
+            continue;
+        }
+        for (const [property, value] of Object.entries(declarations)) {
+            if (typeof value !== "string" ||
+                widgetStylesToCss({ ".wg-probe": { [property]: value } }) === "") {
+                issues.push({
+                    selector,
+                    property,
+                    message: "Declaration would be skipped — unsafe property name or value (no url(), expression(), or ;{}<>@\\)."
+                });
+            }
+        }
+    }
+    return issues;
+}
+/** Run every validator; total — never throws on any draft shape. */
+export function deriveDiagnostics(draft, options = {}) {
+    const diagnostics = { styles: [], previewable: false };
+    if (typeof draft.kind !== "string" || draft.kind.trim().length === 0) {
+        diagnostics.kind = "Kind must be a non-empty id.";
+    }
+    else if (BASE_KINDS.has(draft.kind)) {
+        diagnostics.kind = `'${draft.kind}' is a built-in kind — pick a distinct id.`;
+    }
+    const template = validateTemplate(draft.template);
+    if (!template.ok) {
+        const issue = {
+            code: template.error.code,
+            message: template.error.message
+        };
+        const path = template.error.path;
+        if (typeof path === "string")
+            issue.path = path;
+        diagnostics.template = issue;
+    }
+    // Shared-schema refs resolve here exactly as the server's composition
+    // resolves them, so diagnostics match what the store will enforce.
+    const ref = draft.descriptor?.dataSchemaRef;
+    if (typeof ref === "string") {
+        if (draft.descriptor?.dataSchema !== undefined) {
+            diagnostics.schemaRef =
+                "A descriptor carries 'dataSchema' OR 'dataSchemaRef', never both.";
+        }
+        else if ((options.schemas ?? []).every((entry) => entry.name !== ref)) {
+            diagnostics.schemaRef = `References unknown schema '${ref}' — it is not among the supplied shared schemas.`;
+        }
+    }
+    const schema = effectiveDataSchema(draft, options.schemas ?? []);
+    if (isPlainObject(schema)) {
+        if (draft.descriptor.dataExample !== undefined) {
+            const error = validateDataAgainstSchema(schema, draft.descriptor.dataExample);
+            if (error)
+                diagnostics.example = error;
+        }
+        if (draft.sampleData !== undefined) {
+            const error = validateDataAgainstSchema(schema, draft.sampleData);
+            if (error)
+                diagnostics.sample = error;
+        }
+    }
+    diagnostics.styles = auditStyles(draft.descriptor?.styles);
+    if (draft.load !== undefined) {
+        const problem = validateLoadBinding(draft.load, "load", {
+            isPath: (value) => parsePath(value) !== undefined
+        });
+        if (problem)
+            diagnostics.load = `${problem.message} (at ${problem.path})`;
+    }
+    if (options.actions !== undefined) {
+        const known = new Set(options.actions.map((action) => action.name));
+        const unknown = collectActionRefs(draft.template, draft.load).filter((ref) => !known.has(ref));
+        if (unknown.length > 0) {
+            diagnostics.actionRefs = `References unknown shared action${unknown.length === 1 ? "" : "s"} ${unknown
+                .map((ref) => `'${ref}'`)
+                .join(", ")} — bound elements will render disabled.`;
+        }
+    }
+    if (draft.theme !== undefined) {
+        const theme = validateTheme(draft.theme);
+        if (!theme.ok)
+            diagnostics.theme = theme.error;
+    }
+    diagnostics.previewable =
+        diagnostics.kind === undefined && diagnostics.template === undefined;
+    return diagnostics;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@widgentic/designer",
+  "version": "0.1.0",
+  "description": "Hostable widgentic designers: widget, theme, schema and action designers as functions and custom elements, plus a single-file browser bundle.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser/widgentic-designer.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/widgentic/widgentic.git",
+    "directory": "packages/designer"
+  },
+  "homepage": "https://widgentic.dev",
+  "keywords": [
+    "widgentic",
+    "widgets",
+    "mcp",
+    "agents"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/bundle.mjs",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@widgentic/core": "^0.1.0"
+  }
+}