{"_id":"@cognivo/gen-ui","name":"@cognivo/gen-ui","dist-tags":{"latest":"0.5.0"},"versions":{"0.5.0":{"name":"@cognivo/gen-ui","version":"0.5.0","description":"Generative UI runtime with cognitive analysis (bias engagement, cognitive load, dark-pattern detection) on top of Zod-typed component trees.","keywords":["cognivo","design-system","ui","components","generative-ui","llm","zod"],"license":"MIT","author":{"name":"Cognivo"},"type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"sideEffects":false,"repository":{"type":"git","url":"git+https://github.com/murisd/cognivo.git","directory":"packages/gen-ui"},"homepage":"https://cognivo.dev","bugs":{"url":"https://github.com/murisd/cognivo/issues"},"publishConfig":{"access":"public"},"dependencies":{"zod":"^4.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0","vite":"^6.0.0","vite-plugin-dts":"^4.0.0","vitest":"^2.1.0"},"scripts":{"build":"vite build","dev":"vite build --watch","test":"vitest run","test:watch":"vitest","type-check":"tsc --noEmit","clean":"rm -rf dist"},"_id":"@cognivo/gen-ui@0.5.0","_integrity":"sha512-8CN9vWo8bxzWPpLfZp5bemik3mNxbSihN/7DcrquvkCyyymqdwlO4ywnO/+J2TEcYrYCk2OBA96kA3Bzi5obzg==","_resolved":"/private/var/folders/ts/mj917p251k38v_z025z2d8ww0000gn/T/0cb611949b8e67abfaad7b9f0e3bae08/cognivo-gen-ui-0.5.0.tgz","_from":"file:cognivo-gen-ui-0.5.0.tgz","_nodeVersion":"25.8.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-8CN9vWo8bxzWPpLfZp5bemik3mNxbSihN/7DcrquvkCyyymqdwlO4ywnO/+J2TEcYrYCk2OBA96kA3Bzi5obzg==","shasum":"c7106010d9276245127fccea4b013bac9ffb1276","tarball":"https://registry.npmjs.org/@cognivo/gen-ui/-/gen-ui-0.5.0.tgz","fileCount":55,"unpackedSize":1057297,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDOVa516rq7KuBMQrKWDwNnx4rtkplrKvTeYkrVj3nAHQIhAN2izNTEREO386vmk2LBeP9/P/meKDzSnnBADXn1sMKB"}]},"_npmUser":{"name":"muriloscigliano","email":"dev@murilo.design"},"directories":{},"maintainers":[{"name":"muriloscigliano","email":"dev@murilo.design"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gen-ui_0.5.0_1778028449507_0.4358555782222371"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-06T00:47:29.429Z","0.5.0":"2026-05-06T00:47:29.655Z","modified":"2026-05-06T00:47:29.875Z"},"maintainers":[{"name":"muriloscigliano","email":"dev@murilo.design"}],"description":"Generative UI runtime with cognitive analysis (bias engagement, cognitive load, dark-pattern detection) on top of Zod-typed component trees.","homepage":"https://cognivo.dev","keywords":["cognivo","design-system","ui","components","generative-ui","llm","zod"],"repository":{"type":"git","url":"git+https://github.com/murisd/cognivo.git","directory":"packages/gen-ui"},"author":{"name":"Cognivo"},"bugs":{"url":"https://github.com/murisd/cognivo/issues"},"license":"MIT","readme":"# @cognivo/gen-ui\n\nFramework-agnostic generative UI engine. Streaming parser, component registry, prompt generation, cognitive bias analysis, and design token governance.\n\nZero framework dependencies. Works with any renderer.\n\n## Install\n\n```bash\npnpm add @cognivo/gen-ui\n```\n\n## Core Features\n\n### 1. Component Registry + Prompt Generation\n\n```typescript\nimport { cognivoLibrary } from '@cognivo/gen-ui';\n\n// Generate LLM system prompt from 41 registered components\nconst prompt = cognivoLibrary.prompt();\n// → \"You are an AI assistant that generates UI using component-lang...\"\n// → Includes all component signatures, types, streaming rules\n```\n\n### 2. Streaming Parser\n\n```typescript\nimport { createStreamingParser } from '@cognivo/gen-ui';\n\nconst parser = createStreamingParser(cognivoLibrary.toJSONSchema());\n\n// Feed LLM chunks as they arrive\nfor await (const chunk of llmStream) {\n  const result = parser.push(chunk);\n  // result.root is an ElementNode tree — render it with any framework\n}\n```\n\n### 3. Cognitive Bias Analysis\n\n```typescript\nimport { suggestBiasesForTree, formatBiasReport } from '@cognivo/gen-ui';\n\nconst biases = suggestBiasesForTree(result, cognivoLibrary);\n// → [{ biasName: \"Anchoring Bias\", severity: \"high\", components: [\"MetricCard\"], ... }]\n\nconsole.log(formatBiasReport(biases));\n// → \"## Cognitive Bias Analysis\\n### 🟠 Anchoring Bias (high)\\n...\"\n```\n\n### 4. Design Token Governance\n\n```typescript\nimport { validateTokenUsage } from '@cognivo/gen-ui';\n\nconst violations = validateTokenUsage(result.root);\n// → Warns when LLM generates raw hex colors instead of --cg-* tokens\n```\n\n### 5. GenerativeUiClient (End-to-End)\n\n```typescript\nimport { GenerativeUiClient } from '@cognivo/gen-ui';\n\nconst client = new GenerativeUiClient(aiClient, cognivoLibrary);\n\n// One-shot\nconst result = await client.generate('Show a revenue dashboard');\n\n// Streaming\nfor await (const result of client.stream('Show a pricing page')) {\n  renderer.render(result, container);\n}\n```\n\n## 110 Tests\n\n```bash\npnpm test\n```\n","readmeFilename":"README.md","_rev":"1-a9cf5009aa1ec2369549014809b6f422"}