@forumone/throughline-components 0.0.1 → 0.2.0

package/dist/validation/composition.js

@@ -0,0 +1,135 @@
+/**
+ * Validates a proposed page layout against the design system's composition
+ * rules: forbiddenAdjacent, maxPerPage, requiredSiblings, unknown components,
+ * unknown variants. Errors block; warnings advise.
+ */
+export function validateComposition(input, manifest) {
+    const issues = [];
+    const counts = new Map();
+    for (let i = 0; i < input.blocks.length; i++) {
+        const block = input.blocks[i];
+        if (!block)
+            continue;
+        counts.set(block.type, (counts.get(block.type) ?? 0) + 1);
+        const contract = manifest.getComponent(block.type);
+        if (!contract) {
+            issues.push({
+                severity: 'error',
+                rule: 'unknown-component',
+                message: `Unknown component "${block.type}". Not present in the design system.`,
+                blockIndex: i,
+            });
+            continue;
+        }
+        if (block.variant && contract.content.variants) {
+            const has = contract.content.variants.some((v) => v.name === block.variant);
+            if (!has) {
+                issues.push({
+                    severity: 'error',
+                    rule: 'unknown-variant',
+                    message: `Component "${block.type}" does not have variant "${block.variant}"`,
+                    blockIndex: i,
+                });
+            }
+        }
+        const prev = i > 0 ? input.blocks[i - 1] : undefined;
+        const next = i < input.blocks.length - 1 ? input.blocks[i + 1] : undefined;
+        for (const forbidden of contract.composition.forbiddenAdjacent) {
+            if (prev?.type === forbidden) {
+                issues.push({
+                    severity: 'error',
+                    rule: 'forbidden-adjacent',
+                    message: `"${block.type}" cannot appear directly after "${forbidden}"`,
+                    blockIndex: i,
+                });
+            }
+            if (next?.type === forbidden) {
+                issues.push({
+                    severity: 'error',
+                    rule: 'forbidden-adjacent',
+                    message: `"${block.type}" cannot appear directly before "${forbidden}"`,
+                    blockIndex: i,
+                });
+            }
+        }
+    }
+    for (const [type, count] of counts) {
+        const contract = manifest.getComponent(type);
+        if (!contract)
+            continue;
+        const max = contract.composition.maxPerPage;
+        if (max !== null && count > max) {
+            issues.push({
+                severity: 'error',
+                rule: 'max-per-page',
+                message: `Component "${type}" appears ${count} times but the maximum allowed is ${max}`,
+            });
+        }
+        for (const required of contract.composition.requiredSiblings) {
+            if (!counts.has(required)) {
+                issues.push({
+                    severity: 'warning',
+                    rule: 'required-sibling-missing',
+                    message: `Component "${type}" expects a sibling "${required}" but none is present`,
+                });
+            }
+        }
+    }
+    return { valid: issues.every((issue) => issue.severity !== 'error'), issues };
+}
+/**
+ * Surfaces structural anti-patterns inferred from each component's
+ * `antiExamples` plus position-aware heuristics. The current rule set is
+ * intentionally small and explicit; new rules should be added with care
+ * since false positives are worse than missed detections here.
+ */
+export function findAntiPatterns(input, manifest) {
+    const matches = [];
+    const counts = new Map();
+    for (const block of input.blocks) {
+        counts.set(block.type, (counts.get(block.type) ?? 0) + 1);
+    }
+    for (let i = 0; i < input.blocks.length; i++) {
+        const block = input.blocks[i];
+        if (!block)
+            continue;
+        const contract = manifest.getComponent(block.type);
+        if (!contract)
+            continue;
+        const isLast = i === input.blocks.length - 1;
+        for (const anti of contract.antiExamples) {
+            const labelLower = anti.label.toLowerCase();
+            const isMultiplePattern = labelLower.includes('multiple') || labelLower.includes('two') || labelLower.includes('stacked');
+            if (isMultiplePattern && (counts.get(block.type) ?? 0) > 1) {
+                matches.push({
+                    pattern: anti.label,
+                    why: anti.why,
+                    useInstead: anti.useInstead,
+                    blockIndex: i,
+                });
+                continue;
+            }
+            const isEndOfPagePattern = labelLower.includes('end of') ||
+                labelLower.includes('bottom') ||
+                labelLower.includes('closer');
+            if (isEndOfPagePattern && isLast && contract.composition.placement.includes('page')) {
+                matches.push({
+                    pattern: anti.label,
+                    why: anti.why,
+                    useInstead: anti.useInstead,
+                    blockIndex: i,
+                });
+            }
+        }
+    }
+    // De-duplicate (same blockIndex + pattern can fire twice if both branches match)
+    const seen = new Set();
+    return matches.filter((m) => {
+        const key = `${m.blockIndex}:${m.pattern}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=composition.js.map

package/dist/validation/composition.js.map

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

package/package.json

@@ -1,10 +1,65 @@
 {
   "name": "@forumone/throughline-components",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @forumone/throughline-components",
+  "version": "0.2.0",
+  "description": "MCP server that exposes a design system manifest as conversational primitives for Throughline.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "throughline",
+    "design-system",
+    "mcp",
+    "payload"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forumone/throughline.git",
+    "directory": "packages/components"
+  },
+  "homepage": "https://github.com/forumone/throughline/tree/main/packages/components#readme",
+  "bugs": {
+    "url": "https://github.com/forumone/throughline/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "payload": "^3.0.0"
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "@forumone/throughline-core": "0.2.0",
+    "@forumone/throughline-design-contract": "0.2.0",
+    "@forumone/throughline-plugin-contract": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "eslint": "^9.15.0",
+    "payload": "^3.83.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "@forumone/throughline-eslint-config": "0.0.0",
+    "@forumone/throughline-reference-ds": "0.2.0",
+    "@forumone/throughline-tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b -w",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}