@birdapi/velinstyle 0.7.0 → 0.9.0

package/core/search/providers.js

@@ -0,0 +1,36 @@
+/** @typedef {() => import('./types.js').SearchEntry[]|Promise<import('./types.js').SearchEntry[]>} SearchProviderFn */
+
+/** @type {Map<string, SearchProviderFn>} */
+const providers = new Map();
+
+/**
+ * Register a custom search content provider (API hook for developers).
+ * @param {string} id
+ * @param {SearchProviderFn} fn
+ */
+export function registerSearchProvider(id, fn) {
+  if (!id || typeof fn !== 'function') {
+    throw new Error('registerSearchProvider(id, fn) requires a non-empty id and function');
+  }
+  providers.set(id, fn);
+}
+
+export function unregisterSearchProvider(id) {
+  providers.delete(id);
+}
+
+export function listSearchProviders() {
+  return [...providers.keys()];
+}
+
+/**
+ * @returns {Promise<import('./types.js').SearchEntry[]>}
+ */
+export async function collectProviderEntries() {
+  const all = [];
+  for (const fn of providers.values()) {
+    const chunk = await fn();
+    if (Array.isArray(chunk)) all.push(...chunk);
+  }
+  return all;
+}

package/core/search/types.js

@@ -0,0 +1,61 @@
+import { sanitizeSearchUrl } from '../../components/sanitize.js';
+
+/** @typedef {'docs'|'components'|'api'|'examples'} SearchCategory */
+
+/**
+ * @typedef {Object} SearchEntry
+ * @property {string} id
+ * @property {string} title
+ * @property {string} [excerpt]
+ * @property {string} url
+ * @property {SearchCategory} category
+ * @property {string[]} [keywords]
+ * @property {number} [weight]
+ */
+
+export const SEARCH_CATEGORIES = /** @type {const} */ (['docs', 'components', 'api', 'examples']);
+
+export const CATEGORY_BOOST = {
+  components: 1.25,
+  api: 1.15,
+  docs: 1,
+  examples: 0.9,
+};
+
+/**
+ * @param {unknown} entry
+ * @returns {SearchEntry|null}
+ */
+export function normalizeEntry(entry) {
+  if (!entry || typeof entry !== 'object') return null;
+  const e = /** @type {Record<string, unknown>} */ (entry);
+  const id = String(e.id || e.url || e.title || '').trim();
+  const title = String(e.title || '').trim();
+  const url = String(e.url || '').trim();
+  if (!id || !title) return null;
+  const keywords = Array.isArray(e.keywords)
+    ? e.keywords.map((k) => String(k))
+    : typeof e.keywords === 'string'
+      ? e.keywords.split(/\s+/).filter(Boolean)
+      : [];
+  let category = /** @type {SearchCategory} */ (
+    SEARCH_CATEGORIES.includes(/** @type {SearchCategory} */ (e.category))
+      ? e.category
+      : 'docs'
+  );
+  if (!e.category && typeof e.url === 'string') {
+    if (e.url.includes('/components/')) category = 'components';
+    else if (e.url.includes('/cli/') || e.url.includes('/api/')) category = 'api';
+    else if (e.url.includes('samples/') || e.url.includes('examples/')) category = 'examples';
+  }
+  const safeUrl = url ? sanitizeSearchUrl(url) : `#${id}`;
+  return {
+    id,
+    title,
+    excerpt: String(e.excerpt || e.section || '').slice(0, 200),
+    url: safeUrl,
+    category: /** @type {SearchCategory} */ (category),
+    keywords,
+    weight: typeof e.weight === 'number' ? e.weight : 1,
+  };
+}

package/core/search/worker-client.js

@@ -0,0 +1,56 @@
+let _nextId = 0;
+
+/**
+ * @param {string} [workerUrl]
+ */
+export function createSearchWorker(workerUrl) {
+  if (typeof Worker === 'undefined') return null;
+
+  const url =
+    workerUrl ||
+    new URL('./worker.js', import.meta.url).href;
+
+  let worker;
+  try {
+    worker = new Worker(url, { type: 'module' });
+  } catch {
+    return null;
+  }
+
+  /** @type {Map<number, { resolve: Function, reject: Function }>} */
+  const pending = new Map();
+
+  worker.onmessage = (e) => {
+    const { id, ok, result, error } = e.data || {};
+    const p = pending.get(id);
+    if (!p) return;
+    pending.delete(id);
+    if (ok) p.resolve(result);
+    else p.reject(new Error(error || 'Worker error'));
+  };
+
+  worker.onerror = () => {
+    for (const p of pending.values()) p.reject(new Error('Worker failed'));
+    pending.clear();
+  };
+
+  function send(type, payload) {
+    const id = ++_nextId;
+    return new Promise((resolve, reject) => {
+      pending.set(id, { resolve, reject });
+      worker.postMessage({ id, type, payload });
+    });
+  }
+
+  return {
+    setEntries(entries) {
+      return send('setEntries', { entries });
+    },
+    query(query, options) {
+      return send('query', { query, options });
+    },
+    terminate() {
+      worker.terminate();
+    },
+  };
+}

package/core/search/worker.js

@@ -0,0 +1,20 @@
+import { VelinSearchEngine } from './engine.js';
+
+const engine = new VelinSearchEngine();
+
+self.onmessage = (event) => {
+  const { id, type, payload } = event.data || {};
+  try {
+    if (type === 'setEntries') {
+      engine.setEntries(payload.entries || []);
+      self.postMessage({ id, ok: true });
+    } else if (type === 'query') {
+      const result = engine.query(payload.query, payload.options || {});
+      self.postMessage({ id, ok: true, result });
+    } else {
+      self.postMessage({ id, ok: false, error: 'Unknown message type' });
+    }
+  } catch (err) {
+    self.postMessage({ id, ok: false, error: String(err?.message || err) });
+  }
+};

package/dist/chunks/a11y-utils-IRC7LOPF.js

@@ -0,0 +1,16 @@
+import {
+  announce,
+  ensureAriaLabel,
+  getAnnouncer,
+  liveDotLabel,
+  respectReducedMotion,
+  syncExpanded
+} from "./chunk-Z4JYQ2XX.js";
+export {
+  announce,
+  ensureAriaLabel,
+  getAnnouncer,
+  liveDotLabel,
+  respectReducedMotion,
+  syncExpanded
+};

package/dist/chunks/attributes-3BZLI7XF.js

@@ -0,0 +1,364 @@
+import {
+  disconnectInViewObserver,
+  observeInView
+} from "./chunk-7MCGPHVC.js";
+import {
+  lazyDefine
+} from "./chunk-ZPSPKUYD.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-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}`);
+      el.setAttribute("aria-hidden", "true");
+    }
+  });
+  registerAttribute("velin-loading", {
+    enhance(el) {
+      el.classList.add("velin-spinner");
+      el.setAttribute("aria-busy", "true");
+      el.setAttribute("role", "status");
+    }
+  });
+  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-GJHHV4KM.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");
+    }
+  });
+  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-LWHY23Q5.js");
+    bindDeclarativeSearch(root);
+  }
+}
+function listRegisteredAttributes() {
+  return [...registry.keys()];
+}
+export {
+  bootAttributes,
+  getAttributeHandler,
+  listRegisteredAttributes,
+  registerAttribute
+};