@birdapi/velinstyle 0.8.0 → 0.9.0

package/dist/velin-agent.json

@@ -0,0 +1,684 @@
+{
+  "schemaVersion": 1,
+  "mime": "application/vnd.velinstyle.meta+json",
+  "generatedAt": "2026-05-21T06:42:57.710Z",
+  "framework": {
+    "name": "@birdapi/velinstyle",
+    "version": "0.9.0",
+    "homepage": "https://velinstyle.info",
+    "repository": "https://github.com/SkyliteDesign/velinstyle.git",
+    "tagline": "VelinStyle is the WCAG 2.2 AAA CSS framework with native JavaScript runtime and Web Components."
+  },
+  "packageExports": [
+    ".",
+    "./bundle",
+    "./css",
+    "./sanitize",
+    "./runtime",
+    "./secure",
+    "./email",
+    "./search",
+    "./motion",
+    "./attributes",
+    "./highlight",
+    "./meta",
+    "./a11y"
+  ],
+  "release": {
+    "breaking": [
+      "Canonical tags: velin-tooltip, velin-stepper (legacy *-wc aliases deprecated).",
+      ".velin-mb-* is margin-bottom only; use .velin-my-* for block axis."
+    ],
+    "migration": [
+      "Replace velin-tooltip-wc / velin-stepper-wc with velin-tooltip / velin-stepper.",
+      "Point AI tools at velin-agent.json or docs/llms.txt for framework context."
+    ]
+  },
+  "components": {
+    "tags": [
+      "velin-accordion",
+      "velin-announcer",
+      "velin-bottom-nav",
+      "velin-carousel",
+      "velin-code-block",
+      "velin-collapse",
+      "velin-combobox",
+      "velin-command",
+      "velin-copy",
+      "velin-countdown",
+      "velin-counter",
+      "velin-dialog",
+      "velin-drawer",
+      "velin-dropdown",
+      "velin-email",
+      "velin-icon",
+      "velin-lightbox",
+      "velin-live-dot",
+      "velin-menubar",
+      "velin-modal",
+      "velin-persist",
+      "velin-popover",
+      "velin-progress-ring",
+      "velin-rating",
+      "velin-scroll-top",
+      "velin-scrollspy",
+      "velin-search",
+      "velin-secure-field",
+      "velin-segmented-control",
+      "velin-sheet",
+      "velin-sparkline",
+      "velin-stepper",
+      "velin-tabs",
+      "velin-theme-toggle",
+      "velin-toast",
+      "velin-tooltip"
+    ],
+    "count": 36,
+    "loaderTags": [
+      "velin-accordion",
+      "velin-announcer",
+      "velin-bottom-nav",
+      "velin-carousel",
+      "velin-code-block",
+      "velin-collapse",
+      "velin-combobox",
+      "velin-command",
+      "velin-copy",
+      "velin-countdown",
+      "velin-counter",
+      "velin-dialog",
+      "velin-drawer",
+      "velin-dropdown",
+      "velin-email",
+      "velin-icon",
+      "velin-lightbox",
+      "velin-live-dot",
+      "velin-menubar",
+      "velin-modal",
+      "velin-persist",
+      "velin-popover",
+      "velin-progress-ring",
+      "velin-rating",
+      "velin-scroll-top",
+      "velin-scrollspy",
+      "velin-search",
+      "velin-secure-field",
+      "velin-segmented-control",
+      "velin-sheet",
+      "velin-sparkline",
+      "velin-stepper",
+      "velin-stepper-wc",
+      "velin-tabs",
+      "velin-theme-toggle",
+      "velin-toast",
+      "velin-tooltip",
+      "velin-tooltip-wc"
+    ],
+    "loaderCount": 38,
+    "legacyAliases": [
+      "velin-stepper-wc",
+      "velin-tooltip-wc"
+    ],
+    "helpers": [
+      "velin-flip",
+      "velin-haptic",
+      "velin-reveal"
+    ]
+  },
+  "attributes": {
+    "names": [
+      "velin-accordion",
+      "velin-anchor",
+      "velin-code",
+      "velin-copy",
+      "velin-counter",
+      "velin-fade",
+      "velin-grid",
+      "velin-highlight",
+      "velin-hover",
+      "velin-lazy",
+      "velin-loading",
+      "velin-modal",
+      "velin-notify",
+      "velin-parallax",
+      "velin-progress",
+      "velin-quote",
+      "velin-reveal",
+      "velin-scale",
+      "velin-scroll",
+      "velin-scroll-top",
+      "velin-search",
+      "velin-skeleton",
+      "velin-slide",
+      "velin-stagger",
+      "velin-tabs",
+      "velin-theme",
+      "velin-tooltip"
+    ],
+    "count": 27
+  },
+  "cli": {
+    "commands": [
+      {
+        "name": "init",
+        "summary": "Create velinstyle.config.js",
+        "flags": [],
+        "example": "velinstyle init"
+      },
+      {
+        "name": "build",
+        "summary": "Build custom CSS with selected layers from config",
+        "flags": [],
+        "example": "velinstyle build"
+      },
+      {
+        "name": "themes",
+        "summary": "List available built-in themes",
+        "flags": [],
+        "example": "velinstyle themes"
+      },
+      {
+        "name": "add",
+        "summary": "Add a single component CSS file to your project",
+        "flags": [],
+        "example": "velinstyle add button"
+      },
+      {
+        "name": "icons",
+        "summary": "Manage icon providers (list, add, remove, build)",
+        "flags": [
+          "--icons",
+          "--variant"
+        ],
+        "subcommands": [
+          "list",
+          "add",
+          "remove",
+          "build"
+        ],
+        "example": "velinstyle icons add lucide --icons menu,search"
+      },
+      {
+        "name": "scan",
+        "summary": "Security, accessibility, CSS, and PII scanner",
+        "flags": [
+          "--format",
+          "--severity",
+          "--only",
+          "--fix",
+          "--fix-dry-run",
+          "--fix-lang"
+        ],
+        "example": "velinstyle scan . --only pii --fix-dry-run"
+      },
+      {
+        "name": "prefix",
+        "summary": "Add missing velin- prefix to classes (dry-run; use --write)",
+        "flags": [
+          "--write",
+          "--map",
+          "--bootstrap-display"
+        ],
+        "example": "velinstyle prefix src/ --write"
+      },
+      {
+        "name": "blueprint",
+        "summary": "Print HTML blueprint snippets",
+        "flags": [
+          "--output",
+          "-o"
+        ],
+        "subcommands": [
+          "list"
+        ],
+        "example": "velinstyle blueprint modal -o snippet.html"
+      },
+      {
+        "name": "scaffold",
+        "summary": "Generate layout HTML from natural language prompt",
+        "flags": [
+          "--output",
+          "-o",
+          "--json"
+        ],
+        "subcommands": [
+          "list-intents"
+        ],
+        "example": "velinstyle scaffold \"dashboard with sidebar\""
+      },
+      {
+        "name": "layout",
+        "summary": "Responsive layout audit (flex, grid, viewport)",
+        "flags": [
+          "--json",
+          "--write",
+          "--dry-run"
+        ],
+        "subcommands": [
+          "audit",
+          "suggest",
+          "fix"
+        ],
+        "example": "velinstyle layout suggest index.html"
+      },
+      {
+        "name": "perf",
+        "summary": "Performance audit for images and scripts",
+        "flags": [
+          "--json",
+          "--write",
+          "--dry-run"
+        ],
+        "subcommands": [
+          "audit",
+          "suggest",
+          "fix"
+        ],
+        "example": "velinstyle perf audit samples/"
+      },
+      {
+        "name": "tokens",
+        "summary": "Build or validate design tokens JSON",
+        "flags": [
+          "--input",
+          "--output",
+          "-o"
+        ],
+        "subcommands": [
+          "build",
+          "validate"
+        ],
+        "example": "velinstyle tokens validate --input examples/tokens.full.json"
+      },
+      {
+        "name": "docs",
+        "summary": "Generate developer reference Markdown",
+        "flags": [
+          "--scope",
+          "--out"
+        ],
+        "subcommands": [
+          "generate"
+        ],
+        "example": "velinstyle docs generate --scope all"
+      },
+      {
+        "name": "meta",
+        "summary": "Build Velin-Meta agent bundle (velin-agent.json, llms.txt)",
+        "flags": [
+          "--out",
+          "--llms-out",
+          "--base-url",
+          "--no-llms"
+        ],
+        "subcommands": [
+          "page"
+        ],
+        "example": "velinstyle meta"
+      }
+    ]
+  },
+  "tooling": {
+    "categories": [
+      "scan",
+      "prefix",
+      "scaffold",
+      "layout",
+      "perf",
+      "tokens",
+      "docs",
+      "search",
+      "meta"
+    ],
+    "scannerRuleCount": 37
+  },
+  "a11y": {
+    "wcagLevel": "AAA",
+    "modules": "src/a11y/*.css",
+    "matrix": "docs/generated/a11y/wcag22-aaa-matrix.md",
+    "componentContracts": {
+      "velin-accordion": {
+        "status": "pass",
+        "roles": [
+          "group"
+        ],
+        "keyboard": "Arrow/Home/End between summaries",
+        "reducedMotion": true,
+        "requiredAttributes": [],
+        "notes": "Wires aria-controls on summary elements."
+      },
+      "velin-announcer": {
+        "status": "pass",
+        "roles": [
+          "status"
+        ],
+        "liveRegion": "polite|assertive",
+        "keyboard": "N/A",
+        "reducedMotion": true
+      },
+      "velin-bottom-nav": {
+        "status": "pass",
+        "roles": [
+          "navigation"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ],
+        "keyboard": "Native links or buttons in slot",
+        "notes": "Host aria-label; slotchange syncs aria-current and infers item labels from data-nav/title."
+      },
+      "velin-carousel": {
+        "status": "pass",
+        "roles": [
+          "group",
+          "button"
+        ],
+        "keyboard": "Arrows, Home, End, dots",
+        "reducedMotion": true
+      },
+      "velin-code-block": {
+        "status": "pass",
+        "roles": [
+          "button"
+        ],
+        "requiredAttributes": [],
+        "keyboard": "Expand toggle keyboard",
+        "notes": "Expand uses aria-expanded and aria-controls."
+      },
+      "velin-collapse": {
+        "status": "pass",
+        "roles": [
+          "button"
+        ],
+        "keyboard": "Enter/Space on trigger",
+        "requiredAttributes": []
+      },
+      "velin-combobox": {
+        "status": "pass",
+        "roles": [
+          "combobox",
+          "listbox"
+        ],
+        "keyboard": "Roving, Escape, Enter",
+        "requiredAttributes": [
+          "aria-label"
+        ]
+      },
+      "velin-command": {
+        "status": "pass",
+        "roles": [
+          "dialog"
+        ],
+        "keyboard": "Escape, arrows in results, Tab trap",
+        "requiredAttributes": []
+      },
+      "velin-copy": {
+        "status": "pass",
+        "roles": [
+          "button"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ],
+        "keyboard": "Native button"
+      },
+      "velin-countdown": {
+        "status": "pass",
+        "roles": [
+          "timer"
+        ],
+        "liveRegion": "polite",
+        "keyboard": "N/A"
+      },
+      "velin-counter": {
+        "status": "pass",
+        "roles": [
+          "status"
+        ],
+        "liveRegion": "polite",
+        "keyboard": "N/A",
+        "reducedMotion": true
+      },
+      "velin-dialog": {
+        "status": "pass",
+        "roles": [
+          "dialog"
+        ],
+        "keyboard": "Native dialog, Escape",
+        "requiredAttributes": [],
+        "notes": "aria-labelledby on dialog, aria-modal true."
+      },
+      "velin-drawer": {
+        "status": "pass",
+        "roles": [
+          "dialog"
+        ],
+        "keyboard": "Escape, Tab trap",
+        "requiredAttributes": []
+      },
+      "velin-dropdown": {
+        "status": "pass",
+        "roles": [
+          "menu",
+          "button"
+        ],
+        "keyboard": "Roving, typeahead, Escape"
+      },
+      "velin-email": {
+        "status": "pass",
+        "roles": [
+          "button"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ]
+      },
+      "velin-icon": {
+        "status": "pass",
+        "roles": [
+          "img",
+          "presentation"
+        ],
+        "requiredAttributes": [
+          "label"
+        ],
+        "notes": "Decorative when no label; SVG aria-hidden. Do not set aria-hidden on host in JS."
+      },
+      "velin-lightbox": {
+        "status": "pass",
+        "roles": [
+          "dialog"
+        ],
+        "keyboard": "Escape, arrows, Tab trap",
+        "liveRegion": "polite"
+      },
+      "velin-live-dot": {
+        "status": "pass",
+        "roles": [
+          "status"
+        ],
+        "requiredAttributes": [],
+        "notes": "Status exposed via aria-label on host, not color alone."
+      },
+      "velin-menubar": {
+        "status": "pass",
+        "roles": [
+          "menubar",
+          "menu"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ],
+        "keyboard": "Roving arrows"
+      },
+      "velin-modal": {
+        "status": "pass",
+        "roles": [
+          "dialog"
+        ],
+        "keyboard": "Escape, Tab trap",
+        "requiredAttributes": []
+      },
+      "velin-persist": {
+        "status": "pass",
+        "keyboard": "N/A",
+        "notes": "display:contents; auto-saves form field values (WCAG 3.3.7 Redundant Entry helper). Clears on form submit."
+      },
+      "velin-popover": {
+        "status": "pass",
+        "roles": [
+          "dialog",
+          "tooltip"
+        ],
+        "keyboard": "Escape, Enter/Space on trigger; focus opens hover mode",
+        "notes": "aria-labelledby or default aria-label; non-button triggers get role=button."
+      },
+      "velin-progress-ring": {
+        "status": "pass",
+        "roles": [
+          "progressbar"
+        ],
+        "requiredAttributes": []
+      },
+      "velin-rating": {
+        "status": "pass",
+        "roles": [
+          "radiogroup"
+        ],
+        "keyboard": "Roving, arrows"
+      },
+      "velin-scroll-top": {
+        "status": "pass",
+        "roles": [
+          "button"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ],
+        "reducedMotion": true
+      },
+      "velin-scrollspy": {
+        "status": "pass",
+        "keyboard": "Native nav links",
+        "notes": "Sets aria-current on active link."
+      },
+      "velin-search": {
+        "status": "pass",
+        "roles": [
+          "combobox",
+          "listbox"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ],
+        "keyboard": "Arrows, Enter, Escape",
+        "notes": "Default aria-label Search when unset."
+      },
+      "velin-secure-field": {
+        "status": "pass",
+        "roles": [
+          "textbox"
+        ],
+        "requiredAttributes": [],
+        "notes": "Native label association."
+      },
+      "velin-segmented-control": {
+        "status": "pass",
+        "roles": [
+          "group"
+        ],
+        "requiredAttributes": [
+          "aria-label"
+        ],
+        "keyboard": "Roving"
+      },
+      "velin-sheet": {
+        "status": "pass",
+        "roles": [
+          "dialog"
+        ],
+        "keyboard": "Escape, Tab trap"
+      },
+      "velin-sparkline": {
+        "status": "pass",
+        "roles": [
+          "img",
+          "presentation"
+        ],
+        "requiredAttributes": [
+          "label"
+        ],
+        "notes": "Uses label, aria-label, or figcaption aria-labelledby."
+      },
+      "velin-stepper": {
+        "status": "pass",
+        "roles": [
+          "list"
+        ],
+        "keyboard": "N/A (display); pair with buttons calling next()/prev()",
+        "notes": "aria-label per step (completed/current/upcoming); sr-only Completed text; aria-current on active step."
+      },
+      "velin-tabs": {
+        "status": "pass",
+        "roles": [
+          "tablist",
+          "tab",
+          "tabpanel"
+        ],
+        "keyboard": "Roving, auto-select arrows"
+      },
+      "velin-theme-toggle": {
+        "status": "pass",
+        "roles": [
+          "button",
+          "menu"
+        ],
+        "keyboard": "Menu arrows, Escape",
+        "notes": "aria-pressed on theme toggle."
+      },
+      "velin-toast": {
+        "status": "pass",
+        "roles": [
+          "status",
+          "alert"
+        ],
+        "liveRegion": "polite|assertive",
+        "keyboard": "Close button"
+      },
+      "velin-tooltip": {
+        "status": "pass",
+        "roles": [
+          "tooltip"
+        ],
+        "keyboard": "Escape, focusin"
+      }
+    },
+    "init": "import { initA11y } from '@birdapi/velinstyle/a11y'; initA11y();"
+  },
+  "searchIndex": {
+    "path": "dist/search-index.json",
+    "entryCount": 137
+  },
+  "documentation": {
+    "generated": "docs/generated/",
+    "guides": {
+      "velinMeta": "docs/guides/velin-meta.html",
+      "velinSearch": "docs/guides/velin-search.html",
+      "syntaxHighlight": "docs/guides/syntax-highlight.html",
+      "promptScaffolding": "docs/guides/prompt-scaffolding.html",
+      "apiReference": "docs/guides/api-reference.html"
+    },
+    "agentFiles": {
+      "json": "dist/velin-agent.json",
+      "llmsTxt": "dist/llms.txt"
+    }
+  },
+  "conventions": [
+    "Positioning: VelinStyle is the WCAG 2.2 AAA CSS framework with native JavaScript runtime and Web Components — not a JS-only library or a utility-only CSS kit.",
+    "Use only velin-* utility classes and documented Web Components.",
+    "Prefer data-velin-theme on <html> for theme switching.",
+    "Run velinstyle scan on generated HTML before shipping.",
+    "Do not put secrets, API keys, or raw emails in velin-meta or page meta.",
+    "Resolve doc links against docs root (/docs/), not the current page folder."
+  ]
+}