@birdapi/velinstyle 1.1.0 → 1.2.1

package/dist/chunks/{velin-search-2XRQFBCS.js → velin-search-L3UG6NDQ.js}

@@ -1,7 +1,7 @@
 import {
   escapeHTMLAttribute,
   sanitizeSearchUrl
-} from "./chunk-RDE3QE7Z.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // core/search/types.js
 var SEARCH_CATEGORIES = (
@@ -284,7 +284,7 @@ function createSearch(config = {}) {
   async function getWorker() {
     if (!wantWorker || workerClient) return workerClient;
     if (typeof Worker === "undefined") return null;
-    const { createSearchWorker } = await import("./worker-client-R6DBYPFT.js");
+    const { createSearchWorker } = await import("./worker-client-MPT7PNQ4.js");
     workerClient = createSearchWorker(config.workerUrl);
     return workerClient;
   }
@@ -368,12 +368,13 @@ var VelinSearch = class extends HTMLElement {
   _ensureMarkup() {
     if (this.querySelector("[data-velin-search-input]")) return;
     const ph = escapeHTMLAttribute(this.getAttribute("placeholder") || "Search\u2026");
+    const label = escapeHTMLAttribute(this.getAttribute("aria-label") || "Search");
     this.innerHTML = `
       <div class="velin-search">
         <div class="velin-search__field">
           <input type="search" class="velin-search__input" data-velin-search-input
             placeholder="${ph}" autocomplete="off" role="combobox" aria-expanded="false"
-            aria-controls="${this._listId}" aria-autocomplete="list" />
+            aria-label="${label}" aria-controls="${this._listId}" aria-autocomplete="list" />
         </div>
         <div class="velin-search__status velin-visually-hidden" data-velin-search-status aria-live="polite" aria-atomic="true"></div>
         <div class="velin-search__results" data-velin-search-results role="listbox"
@@ -426,7 +427,7 @@ var VelinSearch = class extends HTMLElement {
       return;
     }
     if (!this._indexLoaded) await this._loadIndex();
-    const { groups } = this._search.query(q, {
+    const { groups } = await this._search.query(q, {
       minChars: this.minChars,
       fuzzy: this.fuzzy,
       categories: this.categories || void 0,

package/dist/chunks/{velin-secure-field-6PV7RZDJ.js → velin-secure-field-DGYMP7OK.js}

@@ -2,7 +2,7 @@ import {
   escapeHTML,
   escapeHTMLAttribute,
   sanitizeInputType
-} from "./chunk-MKZP2TBH.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // components/velin-secure-field.js
 var styles = `

package/dist/chunks/{velin-segmented-control-GYD5BIXQ.js → velin-segmented-control-P74GJPAR.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-42VVPW6N.js";
 import {
   escapeHTML
-} from "./chunk-MKZP2TBH.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // components/velin-segmented-control.js
 var styles = `

package/dist/chunks/{velin-sheet-R2Y67X6H.js → velin-sheet-M5GZZD7G.js}

@@ -88,7 +88,6 @@ var VelinSheet = class extends HTMLElement {
     this._prev = saveFocus();
     setBackgroundInert(this);
     document.addEventListener("keydown", this._onKey);
-    document.body.style.overflow = "hidden";
     requestAnimationFrame(() => {
       const f = getFocusableElements(this.shadowRoot);
       if (f.length) f[0].focus();
@@ -96,8 +95,7 @@ var VelinSheet = class extends HTMLElement {
   }
   _close() {
     document.removeEventListener("keydown", this._onKey);
-    document.body.style.overflow = "";
-    clearBackgroundInert();
+    clearBackgroundInert(this);
     restoreFocus(this._prev);
   }
   _onKey(e) {
@@ -109,7 +107,7 @@ var VelinSheet = class extends HTMLElement {
   }
   disconnectedCallback() {
     document.removeEventListener("keydown", this._onKey);
-    document.body.style.overflow = "";
+    clearBackgroundInert(this);
   }
 };
 customElements.define("velin-sheet", VelinSheet);

package/dist/chunks/{velin-sheet-OUK6572T.js → velin-sheet-X7RXIWKV.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-42VVPW6N.js";
 import {
   escapeHTML
-} from "./chunk-MKZP2TBH.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // components/velin-sheet.js
 var styles = `
@@ -88,7 +88,6 @@ var VelinSheet = class extends HTMLElement {
     this._prev = saveFocus();
     setBackgroundInert(this);
     document.addEventListener("keydown", this._onKey);
-    document.body.style.overflow = "hidden";
     requestAnimationFrame(() => {
       const f = getFocusableElements(this.shadowRoot);
       if (f.length) f[0].focus();
@@ -96,8 +95,7 @@ var VelinSheet = class extends HTMLElement {
   }
   _close() {
     document.removeEventListener("keydown", this._onKey);
-    document.body.style.overflow = "";
-    clearBackgroundInert();
+    clearBackgroundInert(this);
     restoreFocus(this._prev);
   }
   _onKey(e) {
@@ -109,7 +107,7 @@ var VelinSheet = class extends HTMLElement {
   }
   disconnectedCallback() {
     document.removeEventListener("keydown", this._onKey);
-    document.body.style.overflow = "";
+    clearBackgroundInert(this);
   }
 };
 customElements.define("velin-sheet", VelinSheet);

package/dist/chunks/{velin-stepper-X54WGHDG.js → velin-stepper-4YQJUHPC.js}

@@ -1,6 +1,6 @@
 import {
   escapeHTML
-} from "./chunk-RDE3QE7Z.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // components/velin-stepper.js
 var styles = `
@@ -52,10 +52,14 @@ var styles = `
   .panels ::slotted(*) { display: none; }
   .panels ::slotted([data-active]) { display: block; }
   @media (prefers-reduced-motion: reduce) { .step__marker { transition: none; } }
+  .velin-sr-only {
+    position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px;
+    overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0;
+  }
 `;
 var VelinStepper = class extends HTMLElement {
   static get observedAttributes() {
-    return ["active"];
+    return ["active", "aria-label", "labels"];
   }
   constructor() {
     super();
@@ -68,15 +72,18 @@ var VelinStepper = class extends HTMLElement {
   }
   _buildSteps() {
     const labels = (this.getAttribute("labels") || "").split(",").map((s) => s.trim());
+    const listLabel = this.getAttribute("aria-label") || "Progress";
     const stepsHTML = labels.map((label, i) => {
       const state = i < this._current ? "completed" : i === this._current ? "active" : "";
-      const marker = i < this._current ? "&#10003;" : i + 1;
+      const status = i < this._current ? "completed" : i === this._current ? "current step" : "upcoming";
+      const marker = i < this._current ? '<span class="velin-sr-only">Completed</span><span aria-hidden="true">&#10003;</span>' : `<span aria-hidden="true">${i + 1}</span>`;
       const ariaCurrent = i === this._current ? ' aria-current="step"' : "";
-      return `<div class="step ${state}" role="listitem"${ariaCurrent}><span class="step__marker" aria-hidden="true">${marker}</span><span class="step__label">${escapeHTML(label)}</span></div>`;
+      const itemLabel = label ? `${label}, ${status}` : `Step ${i + 1}, ${status}`;
+      return `<div class="step ${state}" role="listitem" aria-label="${escapeHTML(itemLabel)}"${ariaCurrent}><span class="step__marker">${marker}</span><span class="step__label">${escapeHTML(label)}</span></div>`;
     }).join("");
     this.shadowRoot.innerHTML = `
       <style>${styles}</style>
-      <div class="steps" role="list" aria-label="Progress" part="steps">${stepsHTML}</div>
+      <div class="steps" role="list" aria-label="${escapeHTML(listLabel)}" part="steps">${stepsHTML}</div>
       <div class="panels" part="panels"><slot></slot></div>
     `;
   }

package/dist/chunks/{velin-toast-OMMOA2DK.js → velin-toast-UG5LWTG2.js}

@@ -1,6 +1,6 @@
 import {
   escapeHTML
-} from "./chunk-LA7264K4.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // components/velin-toast.js
 var styles = `
@@ -80,8 +80,12 @@ var VelinToast = class extends HTMLElement {
     this.setAttribute("aria-atomic", "true");
   }
   show({ message, type = "info", duration = 5e3 } = {}) {
+    const assertive = type === "error" || type === "danger";
+    this.setAttribute("role", assertive ? "alert" : "status");
+    this.setAttribute("aria-live", assertive ? "assertive" : "polite");
     const toast = document.createElement("div");
     toast.className = `toast toast--${type}`;
+    toast.setAttribute("role", assertive ? "alert" : "status");
     toast.innerHTML = `
       <div class="toast-content">${escapeHTML(message)}</div>
       <button class="toast-close" aria-label="Close">&#215;</button>

package/dist/chunks/{velin-tooltip-BDHGRTQB.js → velin-tooltip-ZDH5SDLU.js}

@@ -1,6 +1,6 @@
 import {
   escapeHTML
-} from "./chunk-LA7264K4.js";
+} from "./chunk-L7ZGUU4D.js";
 
 // components/velin-tooltip.js
 var styles = `

package/dist/llms.txt

@@ -1,30 +1,48 @@
-# VelinStyle 1.1.0
+# VelinStyle 1.2.1
 
-> VelinStyle is the WCAG 2.2 AAA CSS framework with native JavaScript runtime and Web Components.
+> VelinStyle is a CSS framework with WCAG 2.2 AAA-oriented defaults, native JavaScript runtime, and Web Components.
 > Full machine context: https://velinstyle.info/dist/velin-agent.json
 > MIME: application/vnd.velinstyle.meta+json
 
 ## Framework
 - npm: @birdapi/velinstyle
-- VelinStyle is the WCAG 2.2 AAA CSS framework with native JavaScript runtime and Web Components.
-- Components: 38 canonical Web Components (`velin-*`); 40 lazy-loader entries
-- HTML attributes: 27 `velin-*` bridges
-- CLI: velinstyle (scan, scaffold, docs generate, search index, meta)
+- VelinStyle is a CSS framework with WCAG 2.2 AAA-oriented defaults, native JavaScript runtime, and Web Components.
+- Pipeline: Core Foundation → Design System → Knowledge Graph → Prompt Engine → Review Engine → AI Metadata
+- Maturity: CSS/Web Components/runtime = stable; plan/review, knowledge graph, page/section registry, agent metadata = beta/foundation (seed, expanding); Studio + Utility Engine generator = planned
+- Components: 40 canonical Web Components (`velin-*`); 42 lazy-loader entries
+- Knowledge graph: 17 component nodes, 17 page types, 12 sections, 3 design constraint packs
+- HTML attributes: 29 `velin-*` bridges
+- CLI: velinstyle (scan, scaffold, plan, review, docs generate, search index, meta)
+
+## Agent briefing
+- Treat plan/review/knowledge graph as beta foundation — usable, not a finished AI design system.
+- Build pages with plan-first flow: analyze prompt → page registry → sections → design constraints → HTML → review.
+- Prefer tokens (`--velin-color-*`, `--velin-space-*`) over raw hex.
+- One H1 per page; form fields need labels + `velin-form-summary` when validating.
+- Hero: max 2 CTAs; FAQ uses disclosure (`velin-accordion` / details).
+- Do not invent non-`velin-*` utility classes.
+- Prefer registry-backed skills/workflows (`velinstyle skills ...`, `velinstyle workflow ...`) before ad-hoc orchestration.
 
 ## 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.
+- Positioning: VelinStyle is a CSS framework with WCAG 2.2 AAA-oriented defaults, 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.
+- Prefer registry-first skills (`velinstyle skills`) and workflow graphs (`velinstyle workflow`) before inventing custom pipelines.
+- Honor skill status, confidence, compatibility, and onlyIf predicates when automating.
 - 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.
+- Prefer Velin Transparency Framework (velin-transparency + provenance) for AI/trust/compliance labeling; run `velinstyle transparency doctor`.
 
 ## Key guides
 - [Velin-Meta](https://velinstyle.info/docs/guides/velin-meta.html)
+- [AI Skills](https://velinstyle.info/docs/guides/ai-skills.html)
 - [VelinSearch](https://velinstyle.info/docs/guides/velin-search.html)
 - [Syntax highlighting](https://velinstyle.info/docs/guides/syntax-highlight.html)
 - [Prompt scaffolding](https://velinstyle.info/docs/guides/prompt-scaffolding.html)
 - [API reference (generated)](https://velinstyle.info/docs/guides/api-reference.html)
+- North star: VELINSTYLE_2030.md
+- Architecture: ARCHITECTURE.md
 
 ## Generated reference
 - [Components index](https://velinstyle.info/docs/generated/components/)
@@ -34,7 +52,12 @@
 
 ## Usage for agents
 ```
+npx velinstyle plan "Steuerberater Landingpage mit Kontaktformular"
+npx velinstyle scaffold "Steuerberater Landingpage mit Kontaktformular" -o out.html --json
+npx velinstyle review out.html --json
 npx velinstyle meta
 npx velinstyle docs generate
-npx velinstyle search index
+npx velinstyle skills list --capability review
+npx velinstyle skills install frontend
+npx velinstyle workflow landingpage --json
 ```

package/dist/search-index.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-07-27T10:53:24.107Z",
+  "generatedAt": "2026-08-02T07:30:23.643Z",
   "entries": [
     {
       "id": "examples:samples/a11y-patterns.html",
@@ -57,7 +57,7 @@
     {
       "id": "api:commands",
       "title": "CLI commands",
-      "excerpt": "VelinStyle CLI v1.1.0. Run velinstyle --help for full usage.",
+      "excerpt": "VelinStyle CLI v1.2.1. Run velinstyle --help for full usage.",
       "url": "docs/generated/cli/commands.html",
       "category": "api",
       "keywords": [
@@ -82,7 +82,7 @@
     {
       "id": "api:blueprint",
       "title": "CLI: blueprint",
-      "excerpt": "Print HTML blueprint snippets",
+      "excerpt": "Print HTML blueprint snippets; --strict fails on classes missing from CSS",
       "url": "docs/generated/cli/commands.html#blueprint",
       "category": "api",
       "keywords": [
@@ -103,10 +103,34 @@
       ],
       "weight": 1.1
     },
+    {
+      "id": "api:check",
+      "title": "CLI: check",
+      "excerpt": "Aggregate gate: doctor + blueprint --strict + scan + review (alias: validate)",
+      "url": "docs/generated/cli/commands.html#check",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "check"
+      ],
+      "weight": 1.1
+    },
+    {
+      "id": "api:create",
+      "title": "CLI: create",
+      "excerpt": "Scaffold a runnable project: landing | dashboard | docs | auth",
+      "url": "docs/generated/cli/commands.html#create",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "create"
+      ],
+      "weight": 1.1
+    },
     {
       "id": "api:docs",
       "title": "CLI: docs",
-      "excerpt": "Generate developer reference Markdown",
+      "excerpt": "Generate developer reference Markdown (alias: documentation)",
       "url": "docs/generated/cli/commands.html#docs",
       "category": "api",
       "keywords": [
@@ -115,6 +139,18 @@
       ],
       "weight": 1.1
     },
+    {
+      "id": "api:doctor",
+      "title": "CLI: doctor",
+      "excerpt": "Check dist assets, themes, config, icons, and Windows ESM import hints",
+      "url": "docs/generated/cli/commands.html#doctor",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "doctor"
+      ],
+      "weight": 1.1
+    },
     {
       "id": "api:icons",
       "title": "CLI: icons",
@@ -130,7 +166,7 @@
     {
       "id": "api:init",
       "title": "CLI: init",
-      "excerpt": "Create velinstyle.config.js",
+      "excerpt": "Create velinstyle.config.js, optional vendor copy, and starter HTML with reveal/sprite defaults",
       "url": "docs/generated/cli/commands.html#init",
       "category": "api",
       "keywords": [
@@ -154,7 +190,7 @@
     {
       "id": "api:meta",
       "title": "CLI: meta",
-      "excerpt": "Build Velin-Meta agent bundle (velin-agent.json, llms.txt)",
+      "excerpt": "Build Velin-Meta agent bundle; page --write merges curated goals/intent",
       "url": "docs/generated/cli/commands.html#meta",
       "category": "api",
       "keywords": [
@@ -166,7 +202,7 @@
     {
       "id": "api:perf",
       "title": "CLI: perf",
-      "excerpt": "Performance audit for images and scripts",
+      "excerpt": "Performance audit for images and scripts (directory or .html file)",
       "url": "docs/generated/cli/commands.html#perf",
       "category": "api",
       "keywords": [
@@ -175,6 +211,18 @@
       ],
       "weight": 1.1
     },
+    {
+      "id": "api:plan",
+      "title": "CLI: plan",
+      "excerpt": "Emit page plan JSON from a prompt (no HTML)",
+      "url": "docs/generated/cli/commands.html#plan",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "plan"
+      ],
+      "weight": 1.1
+    },
     {
       "id": "api:prefix",
       "title": "CLI: prefix",
@@ -187,10 +235,22 @@
       ],
       "weight": 1.1
     },
+    {
+      "id": "api:review",
+      "title": "CLI: review",
+      "excerpt": "Design / a11y / SEO / performance / conversion review gate",
+      "url": "docs/generated/cli/commands.html#review",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "review"
+      ],
+      "weight": 1.1
+    },
     {
       "id": "api:scaffold",
       "title": "CLI: scaffold",
-      "excerpt": "Generate layout HTML from natural language prompt",
+      "excerpt": "Plan-first page HTML or recipe fragment from natural language",
       "url": "docs/generated/cli/commands.html#scaffold",
       "category": "api",
       "keywords": [
@@ -202,7 +262,7 @@
     {
       "id": "api:scan",
       "title": "CLI: scan",
-      "excerpt": "Security, accessibility, CSS, and PII scanner",
+      "excerpt": "Security, accessibility, CSS, and PII scanner (directory or single file)",
       "url": "docs/generated/cli/commands.html#scan",
       "category": "api",
       "keywords": [
@@ -211,6 +271,42 @@
       ],
       "weight": 1.1
     },
+    {
+      "id": "api:search",
+      "title": "CLI: search",
+      "excerpt": "Build JSON search index for VelinSearch",
+      "url": "docs/generated/cli/commands.html#search",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "search"
+      ],
+      "weight": 1.1
+    },
+    {
+      "id": "api:serve",
+      "title": "CLI: serve",
+      "excerpt": "Serve a directory over HTTP (default port 4173)",
+      "url": "docs/generated/cli/commands.html#serve",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "serve"
+      ],
+      "weight": 1.1
+    },
+    {
+      "id": "api:skills",
+      "title": "CLI: skills",
+      "excerpt": "Registry-first AI skill catalog and install runner",
+      "url": "docs/generated/cli/commands.html#skills",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "skills"
+      ],
+      "weight": 1.1
+    },
     {
       "id": "api:themes",
       "title": "CLI: themes",
@@ -235,6 +331,30 @@
       ],
       "weight": 1.1
     },
+    {
+      "id": "api:wc",
+      "title": "CLI: wc",
+      "excerpt": "Inspect Web Component APIs from source",
+      "url": "docs/generated/cli/commands.html#wc",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "wc"
+      ],
+      "weight": 1.1
+    },
+    {
+      "id": "api:workflow",
+      "title": "CLI: workflow",
+      "excerpt": "Resolve workflow graph or project workflow steps",
+      "url": "docs/generated/cli/commands.html#workflow",
+      "category": "api",
+      "keywords": [
+        "cli",
+        "workflow"
+      ],
+      "weight": 1.1
+    },
     {
       "id": "examples:samples/signup.html",
       "title": "Create your account",
@@ -898,6 +1018,19 @@
       ],
       "weight": 1.3
     },
+    {
+      "id": "components:velin-calendar",
+      "title": "velin-calendar",
+      "excerpt": "Source: components/velin-calendar.js",
+      "url": "docs/generated/components/velin-calendar.html",
+      "category": "components",
+      "keywords": [
+        "velin-calendar",
+        "components",
+        "velin-calendar"
+      ],
+      "weight": 1.3
+    },
     {
       "id": "components:velin-carousel",
       "title": "velin-carousel",
@@ -1067,6 +1200,19 @@
       ],
       "weight": 1.3
     },
+    {
+      "id": "docs:velin-disclosure",
+      "title": "velin-disclosure",
+      "excerpt": "Alias for velin-transparency.",
+      "url": "docs/generated/attributes/velin-disclosure.html",
+      "category": "docs",
+      "keywords": [
+        "velin-disclosure",
+        "docs",
+        "velin-disclosure"
+      ],
+      "weight": 1.2
+    },
     {
       "id": "components:velin-drawer",
       "title": "velin-drawer",
@@ -1119,6 +1265,19 @@
       ],
       "weight": 1.2
     },
+    {
+      "id": "components:velin-file-dropzone",
+      "title": "velin-file-dropzone",
+      "excerpt": "Source: components/velin-file-dropzone.js",
+      "url": "docs/generated/components/velin-file-dropzone.html",
+      "category": "components",
+      "keywords": [
+        "velin-file-dropzone",
+        "components",
+        "velin-file-dropzone"
+      ],
+      "weight": 1.3
+    },
     {
       "id": "components:velin-flip",
       "title": "velin-flip",
@@ -1473,7 +1632,7 @@
     {
       "id": "docs:velin-scroll-top",
       "title": "velin-scroll-top",
-      "excerpt": "Velin HTML attribute extension.",
+      "excerpt": "Inject / configure <velin-scroll-top> (empty or threshold px).",
       "url": "docs/generated/attributes/velin-scroll-top.html",
       "category": "docs",
       "keywords": [
@@ -1717,6 +1876,19 @@
       ],
       "weight": 1.2
     },
+    {
+      "id": "docs:velin-transparency",
+      "title": "velin-transparency",
+      "excerpt": "Velin Transparency Framework host — attaches disclosure + provenance mark (Renderer).",
+      "url": "docs/generated/attributes/velin-transparency.html",
+      "category": "docs",
+      "keywords": [
+        "velin-transparency",
+        "docs",
+        "velin-transparency"
+      ],
+      "weight": 1.2
+    },
     {
       "id": "examples:samples/velin-search.html",
       "title": "VelinSearch",