@once-ui-system/core 1.7.11 → 1.7.13

package/ai/tasks/auth.json

@@ -0,0 +1,23 @@
+{
+  "id": "auth",
+  "title": "Auth flow",
+  "description": "Sign-up / login with social auth, email form, stacked dialog for OTP",
+  "components": [
+    "Column",
+    "Row",
+    "Grid",
+    "Heading",
+    "Text",
+    "Button",
+    "Input",
+    "PasswordInput",
+    "OTPInput",
+    "Dialog",
+    "Media",
+    "SmartLink",
+    "Line"
+  ],
+  "recipes": [],
+  "example": "examples/auth.tsx",
+  "gotchas": ["Card.interactive", "layout.shorthands", "color.tokens"]
+}

package/ai/tasks/chat.json

@@ -0,0 +1,28 @@
+{
+  "id": "chat",
+  "title": "Chat UI",
+  "description": "Message list with avatars, streaming indicator, input bar with emoji picker",
+  "components": [
+    "Column",
+    "Row",
+    "SplitView",
+    "Avatar",
+    "Text",
+    "Input",
+    "IconButton",
+    "EmojiPickerDropdown",
+    "Fade",
+    "Spinner",
+    "Kbd",
+    "User",
+    "Line"
+  ],
+  "recipes": [],
+  "example": "examples/chat.tsx",
+  "blocks": {
+    "manifest": "examples/blocks/manifest.json",
+    "primary": ["Chat1", "Feed3", "Sidebar4"],
+    "compose": ["Sidebar5", "Table1"]
+  },
+  "gotchas": ["Fade.edge", "Badge.duplicate", "layout.shorthands"]
+}

package/ai/tasks/dashboard.json

@@ -0,0 +1,39 @@
+{
+  "id": "dashboard",
+  "title": "Analytics dashboard",
+  "description": "KPI stat cards, charts area, recent-activity list",
+  "components": [
+    "Column",
+    "Row",
+    "Grid",
+    "Heading",
+    "Text",
+    "Background",
+    "CountFx",
+    "StatusIndicator",
+    "Table",
+    "SegmentedControl",
+    "Tag",
+    "Icon",
+    "RevealFx",
+    "Line"
+  ],
+  "recipes": ["reveal-stagger"],
+  "example": "examples/dashboard.tsx",
+  "blocks": {
+    "manifest": "examples/blocks/manifest.json",
+    "primary": ["Dashboard1", "Table1"],
+    "compose": ["Header1", "Sidebar1"]
+  },
+  "gotchas": [
+    "Card.interactive",
+    "CountFx.trigger",
+    "RevealFx.delay",
+    "layout.shorthands",
+    "LogoCloud.columns"
+  ],
+  "quality": {
+    "statCard": "Column surface recipe — not Card",
+    "kpiNumber": "CountFx or display-strong-s with viewport latch"
+  }
+}

package/ai/tasks/index.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "tasks": [
+    { "id": "marketing-hero", "file": "tasks/marketing-hero.json", "priority": 1 },
+    { "id": "pricing", "file": "tasks/pricing.json", "priority": 2 },
+    { "id": "settings", "file": "tasks/settings.json", "priority": 3 },
+    { "id": "dashboard", "file": "tasks/dashboard.json", "priority": 4 },
+    { "id": "chat", "file": "tasks/chat.json", "priority": 5 },
+    { "id": "auth", "file": "tasks/auth.json", "priority": 6 },
+    { "id": "roadmap", "file": "tasks/roadmap.json", "priority": 7 }
+  ]
+}

package/ai/tasks/marketing-hero.json

@@ -0,0 +1,38 @@
+{
+  "id": "marketing-hero",
+  "title": "Marketing hero",
+  "description": "Headline with text effect, CTA pair, social proof logos, background effect",
+  "components": [
+    "Column",
+    "Row",
+    "Heading",
+    "Text",
+    "Button",
+    "Background",
+    "RevealFx",
+    "LetterFx",
+    "LogoCloud",
+    "Grid",
+    "Line"
+  ],
+  "recipes": ["hero-glow-dots", "reveal-stagger"],
+  "example": "examples/marketing-hero.tsx",
+  "blocks": {
+    "manifest": "examples/blocks/manifest.json",
+    "primary": ["Waitlist1", "Header1", "Footer4"],
+    "patterns": ["Background6", "Footer3"]
+  },
+  "gotchas": [
+    "Background.gradient.width",
+    "Background.absolute",
+    "section.gaps",
+    "heading.scale",
+    "animation.budget",
+    "overflow.hero"
+  ],
+  "quality": {
+    "sectionGap": "104",
+    "heroHeading": "display-strong-l",
+    "eyebrow": "label-default-s onBackground=\"brand-medium\""
+  }
+}

package/ai/tasks/pricing.json

@@ -0,0 +1,42 @@
+{
+  "id": "pricing",
+  "title": "Pricing page",
+  "description": "Three tiers, highlighted middle tier, feature comparison table, FAQ accordion",
+  "components": [
+    "Column",
+    "Row",
+    "Grid",
+    "Heading",
+    "Text",
+    "Button",
+    "Background",
+    "MatrixFx",
+    "BlobFx",
+    "RevealFx",
+    "CountFx",
+    "SegmentedControl",
+    "Table",
+    "AccordionGroup",
+    "Tag",
+    "Icon"
+  ],
+  "recipes": ["hero-matrix-strip", "highlighted-card-glow", "blob-ambient-panel"],
+  "example": "examples/pricing.tsx",
+  "blocks": {
+    "manifest": "examples/blocks/manifest.json",
+    "patterns": ["Header2", "Footer2"]
+  },
+  "gotchas": [
+    "Card.interactive",
+    "RevealFx.delay",
+    "LogoCloud.columns",
+    "layout.shorthands",
+    "section.gaps",
+    "animation.budget"
+  ],
+  "quality": {
+    "sectionGap": "104",
+    "tierPanel": "Column background=\"surface\" border radius=\"l\" — not Card",
+    "highlightedTier": "border=\"brand-alpha-medium\" + Background gradient glow"
+  }
+}

package/ai/tasks/roadmap.json

@@ -0,0 +1,22 @@
+{
+  "id": "roadmap",
+  "title": "Product roadmap",
+  "description": "Kanban-style roadmap with status columns and task cards",
+  "components": [
+    "Column",
+    "Row",
+    "Heading",
+    "Text",
+    "Card",
+    "StatusIndicator",
+    "User",
+    "Scroller"
+  ],
+  "recipes": [],
+  "example": "examples/blocks/Roadmap1.tsx",
+  "blocks": {
+    "manifest": "examples/blocks/manifest.json",
+    "primary": ["Roadmap1"]
+  },
+  "gotchas": ["Card.interactive", "layout.shorthands", "heading.scale"]
+}

package/ai/tasks/settings.json

@@ -0,0 +1,34 @@
+{
+  "id": "settings",
+  "title": "Settings page",
+  "description": "Sidebar sections, profile form, danger zone",
+  "components": [
+    "Column",
+    "Row",
+    "SplitView",
+    "Heading",
+    "Text",
+    "Button",
+    "Input",
+    "Select",
+    "Switch",
+    "Checkbox",
+    "Slider",
+    "MediaUpload",
+    "Avatar",
+    "Line",
+    "Tag"
+  ],
+  "recipes": [],
+  "example": "examples/settings.tsx",
+  "gotchas": [
+    "Card.interactive",
+    "layout.shorthands",
+    "color.tokens",
+    "layout.defaults"
+  ],
+  "quality": {
+    "surfaceRecipe": "background=\"surface\" border=\"neutral-alpha-weak\" radius=\"l\" padding=\"24\"",
+    "dangerZone": "border=\"danger-alpha-medium\" on danger actions only"
+  }
+}

package/dist/AGENTS.md

@@ -0,0 +1,53 @@
+# @once-ui-system/core — agent harness
+
+This package ships an agent-first codegen harness under `ai/`. Use it when **writing Once UI code**, not full MDX documentation pages.
+
+## Entry point
+
+```
+@once-ui-system/core/ai/manifest.json
+```
+
+Or from disk:
+
+```
+node_modules/@once-ui-system/core/ai/manifest.json
+```
+
+## Bootstrap workflow
+
+1. Read `ai/manifest.json`
+2. Load bootstrap files: `ai/rules.compact.md` + `ai/catalog.json` (~6KB)
+3. Match intent via `ai/tasks/index.json` → e.g. `ai/tasks/pricing.json`
+4. Fetch component slices listed in the task bundle (`ai/components/*.json`)
+5. Read the gold example referenced by the task; for production fidelity, read Pro blocks from `ai/examples/blocks/manifest.json`
+6. Validate generated code: `npx once-ui-validate-ai-code path/to/file.tsx`
+
+## npm exports
+
+```tsx
+// Readable paths (version-pinned to your install)
+import manifest from '@once-ui-system/core/ai/manifest.json';
+```
+
+```bash
+# One-time project setup (writes AGENTS.md + Cursor rule in consumer app)
+npx once-ui-init-agent
+```
+
+## Remote fallback
+
+If you cannot read `node_modules`, use the docs host (may not match your installed version exactly):
+
+- https://docs.once-ui.com/ai/manifest.json
+- https://docs.once-ui.com/ai/rules.compact.md
+- https://docs.once-ui.com/once-ui/ai-coding
+
+## Key rules (summary)
+
+- Use `Column` / `Row`, not `Flex` unless direction changes at breakpoints
+- Use `fill`, not `fillWidth fillHeight`; use `center`, not `horizontal="center" vertical="center"`
+- Static panels: `Column background="surface" border="neutral-alpha-weak" radius="l" padding="24"`
+- `Card` is interactive only (`href` or `onClick`)
+
+Full rules: `@once-ui-system/core/ai/rules.compact.md`

package/dist/README.md

@@ -35,6 +35,33 @@ Learn how to set up and build with Once UI at [docs.once-ui.com](https://docs.on
 npm install @once-ui-system/core
 ```
 
+## AI codegen harness
+
+This package includes an agent-first harness under `ai/` for generating Once UI code with minimal context (~6–10KB per task).
+
+| Resource | Path |
+|----------|------|
+| Entry point | `@once-ui-system/core/ai/manifest.json` |
+| Compact rules | `@once-ui-system/core/ai/rules.compact.md` |
+| Component catalog | `@once-ui-system/core/ai/catalog.json` |
+| Task bundles | `@once-ui-system/core/ai/tasks/index.json` |
+
+**One-time setup in your app** (writes project `AGENTS.md` + Cursor rule):
+
+```bash
+npx once-ui-init-agent
+```
+
+**Validate generated code:**
+
+```bash
+npx once-ui-validate-ai-code src/app/page.tsx
+```
+
+Full guide: [docs.once-ui.com/once-ui/ai-coding](https://docs.once-ui.com/once-ui/ai-coding)
+
+Machine-readable discovery: see the `onceUi` field in this package's `package.json`.
+
 ## Authors
 
 Built and maintained by [**Lorant One**](https://lorant.one).

package/dist/agent/once-ui-codegen.mdc

@@ -0,0 +1,27 @@
+---
+description: Load Once UI agent harness before generating UI code
+globs: "**/*.{tsx,jsx}"
+alwaysApply: false
+---
+
+# Once UI codegen harness
+
+Before generating or editing Once UI UI code in this project:
+
+1. Read `@once-ui-system/core/ai/manifest.json` (or `node_modules/@once-ui-system/core/ai/manifest.json`)
+2. Load bootstrap files from the manifest: `rules.compact.md` + `catalog.json`
+3. Resolve intent via `ai/tasks/index.json` → fetch the matching task bundle
+4. Fetch only the component slices listed in that task (`ai/components/*.json`)
+5. Read the task's gold example; for production layouts, read matching Pro blocks from `ai/examples/blocks/manifest.json`
+6. Validate output: `npx once-ui-validate-ai-code path/to/file.tsx`
+
+## Do not
+
+- Use full documentation MDX pages for codegen (too large; use the harness)
+- Use `Flex direction="column"` when `Column` works; same for `Row`
+- Use `fillWidth fillHeight` when `fill` works
+- Use `Card` for static panels (use the surface recipe on `Column`)
+
+## Remote fallback
+
+https://docs.once-ui.com/ai/manifest.json