@birdapi/velinstyle 1.2.0 → 1.2.1

package/dist/chunks/attributes-DZCXX2RZ.js

@@ -0,0 +1,404 @@
+import {
+  disconnectInViewObserver,
+  observeInView
+} from "./chunk-7MCGPHVC.js";
+import {
+  lazyDefine
+} from "./chunk-CQMTCEI6.js";
+
+// core/motion/effects.js
+var VISIBLE_CLASS = "velin-in-view";
+var EFFECT_MAP = {
+  reveal: ["velin-animate-on-scroll"],
+  fade: ["velin-animate-on-scroll", "velin-animate-on-scroll--fade"],
+  slide: ["velin-animate-on-scroll", "velin-animate-on-scroll--slide-up"],
+  "slide-up": ["velin-animate-on-scroll", "velin-animate-on-scroll--slide-up"],
+  "slide-down": ["velin-animate-on-scroll", "velin-animate-on-scroll--slide-down"],
+  "slide-left": ["velin-animate-on-scroll", "velin-animate-on-scroll--slide-left"],
+  "slide-right": ["velin-animate-on-scroll", "velin-animate-on-scroll--slide-right"],
+  scale: ["velin-animate-on-scroll", "velin-animate-on-scroll--scale"],
+  parallax: ["velin-parallax"],
+  "parallax-slow": ["velin-parallax", "velin-parallax--slow"],
+  hover: ["velin-animate-hover"],
+  "hover-lift": ["velin-animate-hover"],
+  flip: ["velin-animate-scale-in"],
+  blur: ["velin-animate-fade-in"]
+};
+function applyEffects(el, attrs = {}) {
+  const classes = /* @__PURE__ */ new Set();
+  for (const [name, value] of Object.entries(attrs)) {
+    if (value === "false" || value === "off") continue;
+    const mapped = EFFECT_MAP[name];
+    if (mapped) mapped.forEach((c) => classes.add(c));
+    if (name === "slide" && value && value !== "true" && value !== "") {
+      const key = `slide-${value}`;
+      EFFECT_MAP[key]?.forEach((c) => classes.add(c));
+    }
+  }
+  classes.forEach((c) => el.classList.add(c));
+  if (!el.classList.contains("velin-animate-on-scroll") && attrs.reveal !== void 0) {
+    el.classList.add("velin-animate-on-scroll");
+  }
+  return [...classes];
+}
+function markVisible(el) {
+  el.classList.add(VISIBLE_CLASS);
+  el.dataset.velinVisible = "true";
+}
+function prefersReducedMotion() {
+  return typeof window !== "undefined" && window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+
+// core/motion/stagger.js
+var STAGGER_ATTR = "velin-stagger";
+function applyStagger(listEl, value = "true") {
+  const base = value === "true" || value === "" ? 60 : parseInt(value, 10) || 60;
+  const children = [...listEl.children];
+  children.forEach((child, i) => {
+    child.style.setProperty("--velin-stagger-delay", `${i * base}ms`);
+    child.classList.add("velin-stagger-item");
+  });
+  listEl.classList.add("velin-stagger");
+}
+function enhanceStagger(root = document) {
+  root.querySelectorAll(`[${STAGGER_ATTR}]`).forEach((el) => {
+    if (el.dataset.velinStaggerDone) return;
+    el.dataset.velinStaggerDone = "1";
+    applyStagger(el, el.getAttribute(STAGGER_ATTR) || "true");
+  });
+}
+
+// core/motion/scroll.js
+function smoothScrollTo(target, options = {}) {
+  const reduced = typeof window !== "undefined" && window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+  const el = typeof target === "string" ? document.querySelector(target) : target;
+  if (!el) return;
+  el.scrollIntoView({
+    behavior: reduced || options.instant ? "auto" : "smooth",
+    block: options.block || "start",
+    inline: options.inline || "nearest"
+  });
+  if (el.tabIndex < 0 && !el.hasAttribute("tabindex")) {
+    el.setAttribute("tabindex", "-1");
+  }
+  el.focus({ preventScroll: true });
+}
+function bindSmoothScroll(root = document) {
+  root.querySelectorAll("[velin-scroll]").forEach((link) => {
+    if (link.dataset.velinScrollBound) return;
+    link.dataset.velinScrollBound = "1";
+    link.addEventListener("click", (e) => {
+      const href = link.getAttribute("href");
+      if (!href || !href.startsWith("#")) return;
+      const target = document.querySelector(href);
+      if (!target) return;
+      e.preventDefault();
+      smoothScrollTo(target);
+    });
+  });
+}
+
+// core/motion/index.js
+var MOTION_ATTRS = ["velin-reveal", "velin-fade", "velin-slide", "velin-scale", "velin-parallax", "velin-hover"];
+var teardownFns = [];
+function initMotion(options = {}) {
+  const root = options.root || (typeof document !== "undefined" ? document : null);
+  if (!root) return () => {
+  };
+  const selector = options.selector || [
+    "[velin-reveal]",
+    "[velin-fade]",
+    "[velin-slide]",
+    "[velin-scale]",
+    "[velin-parallax]",
+    "[velin-hover]",
+    ".velin-animate-on-scroll"
+  ].join(",");
+  const elements = root.querySelectorAll(selector);
+  const reduced = prefersReducedMotion();
+  for (const el of elements) {
+    if (el.dataset.velinMotionInit) continue;
+    el.dataset.velinMotionInit = "1";
+    const attrs = {};
+    for (const name of MOTION_ATTRS) {
+      if (el.hasAttribute(name)) attrs[name.replace("velin-", "")] = el.getAttribute(name) || "true";
+    }
+    applyEffects(el, attrs);
+    if (reduced) {
+      markVisible(el);
+      continue;
+    }
+    const stop = observeInView(el, (node) => markVisible(node));
+    teardownFns.push(stop);
+  }
+  enhanceStagger(root);
+  bindSmoothScroll(root);
+  return () => {
+    teardownFns.forEach((fn) => fn());
+    teardownFns = [];
+    disconnectInViewObserver();
+  };
+}
+
+// core/attributes/registry.js
+var registry = /* @__PURE__ */ new Map();
+function registerAttribute(name, handler) {
+  registry.set(name, handler);
+}
+function getAttributeHandler(name) {
+  return registry.get(name);
+}
+function bridgeComponent(el, tag, attrs = {}) {
+  el.setAttribute("data-velin-component", tag);
+  for (const [k, v] of Object.entries(attrs)) {
+    if (v != null) el.setAttribute(k, v);
+  }
+  return lazyDefine(tag);
+}
+function registerBuiltins() {
+  registerAttribute("velin-modal", {
+    enhance(el) {
+      bridgeComponent(el, "velin-modal", { open: el.getAttribute("velin-modal") || "" });
+    }
+  });
+  registerAttribute("velin-tabs", { enhance: (el) => bridgeComponent(el, "velin-tabs") });
+  registerAttribute("velin-accordion", { enhance: (el) => bridgeComponent(el, "velin-accordion") });
+  registerAttribute("velin-tooltip", {
+    enhance(el) {
+      const tip = el.getAttribute("velin-tooltip") || el.getAttribute("title") || "";
+      if (tip && el.hasAttribute("title")) el.removeAttribute("title");
+      if (el.tagName === "VELIN-TOOLTIP" || el.tagName === "VELIN-TOOLTIP-WC") {
+        el.setAttribute("content", tip);
+        return lazyDefine("velin-tooltip");
+      }
+      const wc = document.createElement("velin-tooltip");
+      wc.setAttribute("content", tip);
+      const parent = el.parentElement;
+      if (parent) {
+        parent.insertBefore(wc, el);
+        wc.appendChild(el);
+      }
+      return lazyDefine("velin-tooltip");
+    }
+  });
+  registerAttribute("velin-copy", {
+    enhance(el) {
+      const text = el.getAttribute("velin-copy") || el.textContent?.trim() || "";
+      if (!el.querySelector("velin-copy")) {
+        const wc = document.createElement("velin-copy");
+        wc.setAttribute("value", text);
+        if (el.tagName === "BUTTON") {
+          wc.append(...el.childNodes);
+          el.replaceWith(wc);
+          return lazyDefine("velin-copy");
+        }
+        el.appendChild(wc);
+      }
+      return lazyDefine("velin-copy");
+    }
+  });
+  registerAttribute("velin-counter", {
+    enhance(el) {
+      bridgeComponent(el, "velin-counter", {
+        value: el.getAttribute("velin-counter") || "0"
+      });
+    }
+  });
+  registerAttribute("velin-notify", {
+    async enhance(el) {
+      await lazyDefine("velin-toast");
+      el.addEventListener("click", () => {
+        const msg = el.getAttribute("velin-notify") || el.textContent || "";
+        document.dispatchEvent(
+          new CustomEvent("velin-toast-show", { detail: { message: msg, variant: el.dataset.variant || "info" } })
+        );
+      });
+    }
+  });
+  registerAttribute("velin-theme", {
+    enhance(el) {
+      const theme = el.getAttribute("velin-theme") || "toggle";
+      if (theme === "toggle") {
+        if (!el.querySelector("velin-theme-toggle")) {
+          el.appendChild(document.createElement("velin-theme-toggle"));
+        }
+        return lazyDefine("velin-theme-toggle");
+      }
+      document.documentElement.setAttribute("data-velin-theme", theme);
+    }
+  });
+  registerAttribute("velin-scroll-top", {
+    enhance(el) {
+      const raw = el.getAttribute("velin-scroll-top");
+      const threshold = raw && raw !== "true" ? raw : "300";
+      if (el.tagName === "VELIN-SCROLL-TOP") {
+        if (raw && raw !== "true") el.setAttribute("threshold", threshold);
+        return lazyDefine("velin-scroll-top");
+      }
+      let wc = document.querySelector("velin-scroll-top");
+      if (!wc) {
+        wc = document.createElement("velin-scroll-top");
+        wc.setAttribute("threshold", threshold);
+        (el === document.body || el === document.documentElement ? document.body : el).appendChild(wc);
+      }
+      return lazyDefine("velin-scroll-top");
+    }
+  });
+  registerAttribute("velin-progress", {
+    enhance(el) {
+      const ring = el.hasAttribute("ring");
+      if (ring) return bridgeComponent(el, "velin-progress-ring");
+      el.classList.add("velin-progress");
+      const val = parseInt(el.getAttribute("velin-progress") || "0", 10);
+      el.setAttribute("role", "progressbar");
+      el.setAttribute("aria-valuenow", String(val));
+      el.style.setProperty("--velin-progress", `${Math.min(100, val)}%`);
+    }
+  });
+  registerAttribute("velin-search", {
+    async enhance(el) {
+      if (el.tagName !== "VELIN-SEARCH") {
+        const host = document.createElement("velin-search");
+        host.setAttribute("index", el.getAttribute("data-search-index") || "/search-index.json");
+        el.replaceWith(host);
+        host.appendChild(el);
+      }
+      return lazyDefine("velin-search");
+    }
+  });
+  registerAttribute("velin-lazy", {
+    enhance(el) {
+      if (el.tagName === "IMG") {
+        el.loading = "lazy";
+        el.decoding = "async";
+        if (el.hasAttribute("velin-skeleton") || el.dataset.velinSkeleton) {
+          el.classList.add("velin-skeleton", "velin-skeleton--image");
+          el.addEventListener("load", () => el.classList.remove("velin-skeleton", "velin-skeleton--image"), { once: true });
+        }
+      }
+    }
+  });
+  registerAttribute("velin-skeleton", {
+    enhance(el) {
+      const variant = el.getAttribute("velin-skeleton") || "text";
+      el.classList.add("velin-skeleton", `velin-skeleton--${variant}`);
+      const hasText = Boolean(el.textContent?.trim()) && el.children.length > 0;
+      if (!hasText && !el.textContent?.trim()) {
+        el.setAttribute("aria-hidden", "true");
+      }
+    }
+  });
+  registerAttribute("velin-loading", {
+    enhance(el) {
+      el.classList.add("velin-spinner");
+      el.setAttribute("aria-busy", "true");
+      el.setAttribute("role", "status");
+      if (!el.getAttribute("aria-label")?.trim()) {
+        el.setAttribute("aria-label", "Loading");
+      }
+    }
+  });
+  registerAttribute("velin-grid", {
+    enhance(el) {
+      const cols = el.getAttribute("velin-grid") || "auto";
+      el.classList.add("velin-grid");
+      if (cols !== "auto") el.style.setProperty("--velin-grid-cols", cols);
+    }
+  });
+  registerAttribute("velin-anchor", {
+    enhance(el) {
+      if (!el.id && el.getAttribute("velin-anchor")) el.id = el.getAttribute("velin-anchor");
+      el.setAttribute("tabindex", "-1");
+    }
+  });
+  registerAttribute("velin-code", {
+    async enhance(el) {
+      const lang = el.getAttribute("velin-code") || el.getAttribute("language") || el.getAttribute("data-language") || "";
+      el.classList.add("velin-code-block");
+      if (lang && lang !== "true") {
+        el.dataset.language = lang;
+        if (!el.getAttribute("language")) el.setAttribute("language", lang);
+      }
+      if (!el.querySelector("[data-velin-copy]")) {
+        const btn = document.createElement("button");
+        btn.type = "button";
+        btn.className = "velin-code-block__copy velin-btn velin-btn--sm";
+        btn.textContent = "Copy";
+        btn.setAttribute("data-velin-copy", "");
+        btn.setAttribute("velin-copy", el.querySelector("code")?.textContent || el.textContent || "");
+        el.style.position = "relative";
+        el.appendChild(btn);
+      }
+      await lazyDefine("velin-copy");
+      const { initHighlight, highlightElement } = await import("./highlight-M2ELQNYK.js");
+      const immediate = el.getAttribute("data-velin-highlight") === "immediate" || typeof matchMedia !== "undefined" && matchMedia("(prefers-reduced-motion: reduce)").matches;
+      if (immediate) {
+        await highlightElement(el);
+      } else {
+        initHighlight(el, { root: el });
+      }
+    }
+  });
+  registerAttribute("velin-quote", {
+    enhance(el) {
+      if (el.tagName === "BLOCKQUOTE" || el.tagName === "Q") {
+        el.classList.add("velin-quote");
+      }
+    }
+  });
+  registerAttribute("velin-highlight", {
+    enhance(el) {
+      el.classList.add("velin-highlight");
+    }
+  });
+  registerAttribute("velin-transparency", {
+    async enhance(el) {
+      const { attach } = await import("./attach-H2ZSEAE6.js");
+      attach(el);
+    }
+  });
+  registerAttribute("velin-disclosure", {
+    async enhance(el) {
+      const { attach } = await import("./attach-H2ZSEAE6.js");
+      if (!el.hasAttribute("velin-transparency")) el.setAttribute("velin-transparency", "");
+      attach(el);
+    }
+  });
+  for (const motion of ["velin-reveal", "velin-fade", "velin-slide", "velin-scale", "velin-parallax", "velin-hover", "velin-stagger", "velin-scroll"]) {
+    registerAttribute(motion, { enhance() {
+    } });
+  }
+}
+registerBuiltins();
+var enhanced = /* @__PURE__ */ new WeakSet();
+async function bootAttributes(root = document) {
+  const selector = [...registry.keys()].map((a) => `[${a}]`).join(",");
+  const elements = root.querySelectorAll(selector);
+  for (const el of elements) {
+    if (enhanced.has(el)) continue;
+    for (const attr of registry.keys()) {
+      if (!el.hasAttribute(attr)) continue;
+      const handler = registry.get(attr);
+      if (handler?.enhance) await handler.enhance(el);
+    }
+    enhanced.add(el);
+  }
+  initMotion({ root });
+  if (typeof HTMLElement !== "undefined") {
+    const { bindDeclarativeSearch } = await import("./velin-search-L3UG6NDQ.js");
+    bindDeclarativeSearch(root);
+    if (!document.querySelector("velin-announcer")) {
+      const { getAnnouncer } = await import("./a11y-utils-IRC7LOPF.js");
+      getAnnouncer();
+    }
+  }
+}
+function listRegisteredAttributes() {
+  return [...registry.keys()];
+}
+export {
+  bootAttributes,
+  getAttributeHandler,
+  listRegisteredAttributes,
+  registerAttribute
+};

package/dist/chunks/chunk-CQMTCEI6.js

@@ -0,0 +1,113 @@
+// components/runtime/component-loaders.js
+var COMPONENT_LOADERS = {
+  "velin-accordion": () => import("./velin-accordion-WSY6BMLA.js"),
+  "velin-announcer": () => import("./velin-announcer-PVTXXCWR.js"),
+  "velin-bottom-nav": () => import("./velin-bottom-nav-N5F4UO2I.js"),
+  "velin-calendar": () => import("./velin-calendar-XC7JRDSH.js"),
+  "velin-carousel": () => import("./velin-carousel-ZTBANFQQ.js"),
+  "velin-code-block": () => import("./velin-code-block-ZGWG7JI5.js"),
+  "velin-collapse": () => import("./velin-collapse-5XYBUIID.js"),
+  "velin-combobox": () => import("./velin-combobox-56V2ZWT5.js"),
+  "velin-command": () => import("./velin-command-ZJSLPK7B.js"),
+  "velin-copy": () => import("./velin-copy-XDQSV2XU.js"),
+  "velin-countdown": () => import("./velin-countdown-V4Z5MA63.js"),
+  "velin-counter": () => import("./velin-counter-L5FYJF7A.js"),
+  "velin-data-table": () => import("./velin-data-table-UVR42UUM.js"),
+  "velin-dialog": () => import("./velin-dialog-3YK2RPRV.js"),
+  "velin-drawer": () => import("./velin-drawer-CCM6S25D.js"),
+  "velin-dropdown": () => import("./velin-dropdown-PLUIFA5M.js"),
+  "velin-email": () => import("./velin-email-TNFONXPW.js"),
+  "velin-file-dropzone": () => import("./velin-file-dropzone-QRGF2JNA.js"),
+  "velin-form-summary": () => import("./velin-form-summary-XRQ7COQH.js"),
+  "velin-icon": () => import("./velin-icon-A6NCXGUK.js"),
+  "velin-lightbox": () => import("./velin-lightbox-P725FLTY.js"),
+  "velin-live-dot": () => import("./velin-live-dot-RJHX2DGY.js"),
+  "velin-menubar": () => import("./velin-menubar-6I2LM5HL.js"),
+  "velin-modal": () => import("./velin-modal-ICTMGRSU.js"),
+  "velin-persist": () => import("./velin-persist-DFPL3QP4.js"),
+  "velin-popover": () => import("./velin-popover-WZG2GHBL.js"),
+  "velin-progress-ring": () => import("./velin-progress-ring-E4YRLZHH.js"),
+  "velin-rating": () => import("./velin-rating-QBBYRRBU.js"),
+  "velin-scroll-top": () => import("./velin-scroll-top-OHYVVHHY.js"),
+  "velin-scrollspy": () => import("./velin-scrollspy-OKCT4FDV.js"),
+  "velin-search": () => import("./velin-search-L3UG6NDQ.js"),
+  "velin-secure-field": () => import("./velin-secure-field-DGYMP7OK.js"),
+  "velin-segmented-control": () => import("./velin-segmented-control-P74GJPAR.js"),
+  "velin-sheet": () => import("./velin-sheet-X7RXIWKV.js"),
+  "velin-sparkline": () => import("./velin-sparkline-XVTFC6GE.js"),
+  "velin-stepper": () => import("./velin-stepper-4YQJUHPC.js"),
+  "velin-stepper-wc": () => import("./velin-stepper-4YQJUHPC.js"),
+  "velin-tabs": () => import("./velin-tabs-5UQ5ZVMV.js"),
+  "velin-theme-toggle": () => import("./velin-theme-toggle-32J2CBNC.js"),
+  "velin-toast": () => import("./velin-toast-UG5LWTG2.js"),
+  "velin-tooltip": () => import("./velin-tooltip-ZDH5SDLU.js"),
+  "velin-tooltip-wc": () => import("./velin-tooltip-ZDH5SDLU.js")
+};
+
+// components/runtime/index.js
+var registry = /* @__PURE__ */ new Map();
+var VELIN_TAG_RE = /^velin-[a-z0-9-]+$/;
+function whenDefined(tagName) {
+  if (typeof customElements === "undefined") {
+    return Promise.reject(new Error("customElements not available"));
+  }
+  return customElements.whenDefined(tagName);
+}
+async function lazyDefine(tagName) {
+  const loader = COMPONENT_LOADERS[tagName];
+  if (!loader) {
+    throw new Error(`Unknown Velin component: ${tagName}`);
+  }
+  if (registry.has(tagName)) return registry.get(tagName);
+  const p = loader().then((mod) => {
+    const Cls = mod.default;
+    if (Cls && !customElements.get(tagName)) {
+      customElements.define(tagName, Cls);
+    }
+    return Cls;
+  });
+  registry.set(tagName, p);
+  return p;
+}
+async function register(tagNames) {
+  return Promise.all(tagNames.map((t) => lazyDefine(t)));
+}
+function collectTagsFromDOM(root) {
+  const tags = /* @__PURE__ */ new Set();
+  root.querySelectorAll("[data-velin-component]").forEach((el) => {
+    const name = el.getAttribute("data-velin-component");
+    if (name) tags.add(name.startsWith("velin-") ? name : `velin-${name}`);
+  });
+  for (const el of root.querySelectorAll("*")) {
+    const tag = el.tagName?.toLowerCase();
+    if (tag && VELIN_TAG_RE.test(tag) && COMPONENT_LOADERS[tag]) {
+      tags.add(tag);
+    }
+  }
+  return tags;
+}
+async function bootFromDOM(root = document, options = {}) {
+  const tags = options.tags?.length ? new Set(options.tags) : collectTagsFromDOM(root);
+  const wcPromise = register([...tags]);
+  if (options.attributes) {
+    const { bootAttributes } = await import("./attributes-DZCXX2RZ.js");
+    await bootAttributes(root);
+  }
+  if (options.highlight) {
+    const { initHighlight } = await import("./highlight-M2ELQNYK.js");
+    initHighlight(root);
+  }
+  if (options.haptic) {
+    const { VelinHapticObserver } = await import("./velin-haptic-4QQTM3RK.js");
+    new VelinHapticObserver().start(root instanceof Document ? root.body : root);
+  }
+  return wcPromise;
+}
+
+export {
+  COMPONENT_LOADERS,
+  whenDefined,
+  lazyDefine,
+  register,
+  bootFromDOM
+};

package/dist/chunks/runtime-entry.js

@@ -4,7 +4,7 @@ import {
   lazyDefine,
   register,
   whenDefined
-} from "./chunk-TUGIPKW5.js";
+} from "./chunk-CQMTCEI6.js";
 export {
   COMPONENT_LOADERS,
   bootFromDOM,

package/dist/llms.txt

@@ -1,4 +1,4 @@
-# VelinStyle 1.2.0
+# VelinStyle 1.2.1
 
 > 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
@@ -11,7 +11,7 @@
 - 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: 27 `velin-*` bridges
+- HTML attributes: 29 `velin-*` bridges
 - CLI: velinstyle (scan, scaffold, plan, review, docs generate, search index, meta)
 
 ## Agent briefing
@@ -32,6 +32,7 @@
 - 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)

package/dist/search-index.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-08-01T07:28:49.364Z",
+  "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.2.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": [
@@ -1200,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",
@@ -1863,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",

package/dist/velin-agent.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": 1,
   "mime": "application/vnd.velinstyle.meta+json",
-  "generatedAt": "2026-08-01T07:28:51.397Z",
+  "generatedAt": "2026-08-02T07:30:26.797Z",
   "framework": {
     "name": "@birdapi/velinstyle",
-    "version": "1.2.0",
+    "version": "1.2.1",
     "homepage": "https://velinstyle.info",
     "repository": "https://github.com/SkyliteDesign/velinstyle.git",
     "tagline": "VelinStyle is a CSS framework with WCAG 2.2 AAA-oriented defaults, native JavaScript runtime, and Web Components.",
@@ -23,6 +23,7 @@
     "./attributes",
     "./highlight",
     "./meta",
+    "./transparency",
     "./a11y",
     "./skills-registry"
   ],
@@ -3922,6 +3923,7 @@
       "velin-code",
       "velin-copy",
       "velin-counter",
+      "velin-disclosure",
       "velin-fade",
       "velin-grid",
       "velin-highlight",
@@ -3943,9 +3945,10 @@
       "velin-stagger",
       "velin-tabs",
       "velin-theme",
-      "velin-tooltip"
+      "velin-tooltip",
+      "velin-transparency"
     ],
-    "count": 27
+    "count": 29
   },
   "cli": {
     "commands": [
@@ -4620,7 +4623,7 @@
   },
   "searchIndex": {
     "path": "dist/search-index.json",
-    "entryCount": 151
+    "entryCount": 153
   },
   "documentation": {
     "generated": "docs/generated/",
@@ -4650,6 +4653,7 @@
     "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."
+    "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`."
   ]
 }