Core modules 1.2.2

Tree-shakeable JavaScript modules under core/ — separate from CSS and Web Components in components/. Deutsch: Kernmodule

When to use

• Import tree-shakeable modules for search, motion, attributes, highlight, or meta without the full WC bundle.
• Use components/runtime (bootFromDOM) when you only need tags present on the page.

When not

• Do not treat core/meta as a complete AI design system — agent metadata is beta.
• Prefer documented subpaths over deep relative imports into core/ files.

Layout

velinstyle/
  core/
    search/       types.js, engine.js, highlight.js, providers.js, index.js
    motion/       scheduler.js, effects.js, stagger.js, scroll.js, index.js
    attributes/   registry.js, index.js
  components/     velin-search.js, velin-modal.js, …
  cli/            search-index.js, docs-generate.js

core/search

• VelinSearchEngine — in-memory fuzzy + substring scoring
• velinSearch — singleton: loadIndex(), query()
• createSearch() — isolated instance per widget
• registerSearchProvider(id, fn) — merge custom entries
• highlightHtml(text, query) — safe <mark class="velin-search-hit">

core/motion

• initMotion(options?) — IO + stagger + smooth scroll bindings
• observeInView(el, callback) — rAF-batched visibility
• applyEffects(el, attrs) — map attributes to CSS classes
• smoothScrollTo(target) — reduced-motion aware

core/attributes

• registerAttribute(name, { enhance })
• bootAttributes(root) — scan DOM, lazy WC load
• listRegisteredAttributes() — 27 built-ins

core/highlight

initHighlight() — lazy language registry, MutationObserver for velin-code / pre code. Subpath: @birdapi/velinstyle/highlight.

core/meta

velin-meta export and velin-agent.json agent bundle — see Velin-Meta guide.

sanitize / email / secure

Package exports: @birdapi/velinstyle/sanitize, ./email, ./secure — used by components and PII tooling.

components/runtime

bootFromDOM() registers only components present in the page. Prefer over full IIFE when bundle size matters.

Legacy motion helpers

velin-reveal / velin-flip / velin-haptic remain as helper modules; prefer core/motion + attributes for new work (Motion guide).

Package exports (1.2.0)

Verified against @birdapi/velinstyle package.json exports:

Related: VelinSearch, Motion guide, JavaScript API.