@adukiorg/anza 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -1,352 +0,0 @@
-<!-- markdownlint-disable MD024 -->
-# Changelog
-
-All notable changes to `@adukiorg/anza` will be documented here.
-
-Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-Versioning follows [Semantic Versioning](https://semver.org/).
-
----
-
-## [Unreleased]
-
-### Planned
-
-- Full element library documentation (`src/elements/`)
-- Integration with external bundlers/compilers
-
----
-
-## [0.4.0] — 2026-06-14
-
-### Added
-
-- Natively support arrays of multiple CSS imports in component definitions (`template: { html, css: ['./a.css', './b.css'] }`) across both the JavaScript library runtime and the Rust compiler.
-
-### Changed
-
-- Replaced CSS Custom Highlight API implementation with PrismJS for `view-code` syntax highlighting.
-
----
-
-## [0.3.9] — 2026-06-13
-
-### Changed
-
-- Updated core component rendering to correctly process nested syntax logic and perform full syntax highlighting.
-
----
-
-## [0.3.7] — 2026-06-13
-
-### Changed
-
-- Updated README and package descriptions to clarify the "instant" build step.
-
----
-
-## [0.3.6] — 2026-06-13
-
-### Fixed
-
-- Resolved NPM publish collision for the watcher hotfix.
-
----
-
-## [0.3.5] — 2026-06-13
-
-### Changed
-
-- Prevent native browser tab loading spinner during client-side navigation.
-- Removed unnecessary console logs in `boot.js`, `orchestrator.js`, and `element.js`.
-
----
-
-## [0.3.3] — 2026-06-13
-
-### Changed
-
-- Removed `<main>` to `<dock-main>` compiler auto-alignment. Apps now use `<dock-main id="main">` natively in HTML templates.
-- Update `boot.js` router error messages to correctly refer to `<dock-main id="main">`.
-
----
-
-## [0.3.2] — 2026-06-13
-
-### Fixed
-
-- Update scaffolding templates to use `<dock-main>` and ES module Service Worker registration (`{ type: 'module' }`)
-- Fix CLI watcher to properly resolve Linux `inotify` absolute paths for CSS and JS Hot Module Reloading (HMR)
-- Improve HMR client script with SSE auto-reconnect back-off
-
----
-
-## [0.3.1] — 2026-06-13
-
-### Changed
-
-- Soften library README tone — remove sarcastic framework comparisons
-- Update dock() example to use simplified API (no parent parameter)
-
----
-
-## [0.3.0] — 2026-06-13
-
-### Fixed
-
-- Sync `tools/Cargo.toml` version with npm package version (0.2.1 → 0.3.0)
-
----
-
-## [0.2.8] — 2026-06-09
-
-### Fixed
-
-- Remove empty `importmap.json` from scaffold — HTML now points to `/dist/importmap.json`
-- Category barrel files for generated doc pages (`docs/*/index.js`)
-- Docs root route (`/docs`) uses `entry/` folder like other pages
-
----
-
-## [0.2.7] — 2026-06-09
-
-### Fixed
-
-- Scaffold structure: landing page moved to `src/pages/entry/` instead of `src/pages/index/`
-- Node.js and Rust create commands generate consistent `src/pages/index.js` barrel file
-- Docs conversion task (`tasks/docs.js`) for markdown-to-anza-page generation
-
----
-
-## [0.2.6] — 2026-06-09
-
-### Fixed
-
-- `bin/anza/index.js` wrapper now uses `realpathSync` to correctly detect CLI entry through npm bin symlinks
-- `npm run dev` and `npx anza` now work from installed packages
-
----
-
-## [0.2.5] — 2026-06-09
-
-### Fixed
-
-- Add `./package.json` export to `@adukiorg/anza` so `npm create` resolver works
-- Fix `@adukiorg/create-anza` fallback resolution for local development
-
----
-
-## [0.2.4] — 2026-06-09
-
-### Added
-
-- **`@adukiorg/create-anza`** package for `npm create @adukiorg/anza <name>`
-- `./bin/create` export added to `@adukiorg/anza` for programmatic scaffold access
-
----
-
-## [0.2.3] — 2026-06-09
-
-### Fixed
-
-- CI release workflow artifact naming to prevent binary overwrites
-- Windows runner shell compatibility (`shell: bash`)
-
----
-
-## [0.2.2] — 2026-06-09
-
-### Added
-
-- CI/CD workflows for GitHub Actions (build, typecheck, verify scaffolding, cross-platform release)
-- Comprehensive documentation for all modules (animations, api, events, platform, router, security, state, storage, sw, ui, workers)
-- `library/bin/` CLI wrappers for Node.js distribution
-
----
-
-## [0.2.1] — 2026-06-09
-
-### Added
-
-#### Service Worker Toolkit — `@adukiorg/anza/sw`
-
-- **New subpath export** `@adukiorg/anza/sw` — caching strategies, route interception, background sync, and push notifications
-- **Seven caching strategies**: CacheFirst, NetworkFirst, StaleRevalidate, CacheThenNetwork, NetworkOnly, CacheOnly, OfflineFallback
-- **URLPattern routing** inside the Service Worker via `router()` and `Router`
-- **Install/activate helpers**: `precache()`, `pruneStale()`, `claim()`, `enableNavPreload()`
-- **TTL expiry**: `pruneExpired()`, `setupAutoPrune()` with `x-expires-at` headers
-- **Background sync**: `replayQueue()`, `requeueFailed()` with dead-letter queue
-- **Request serialization**: `serializeRequest()`, `deserializeRequest()` for IndexedDB storage
-- **Push notifications**: `subscribe()`, `notify()` with VAPID support
-- **Scaffolded `src/sw.js`** generated by both `anza create` and `anza-create`
-
-#### Theme Switching — `@adukiorg/anza/theme`
-
-- **New subpath export** `@adukiorg/anza/theme`
-- **Auto-init on import** — reads saved preference from `localStorage` or respects `prefers-color-scheme`
-- **Attaches to `window.theme`** via `Object.defineProperty` (non-enumerable, non-configurable)
-- **API**: `theme.get()`, `theme.set()`, `theme.toggle()` — all update the same global instance
-- **No manual init required** — importing `@adukiorg/anza/ui` triggers it automatically
-
-#### View Transition Tokens — `tokens/semantic/transitions.css`
-
-- **New semantic token layer** connecting the CSS View Transitions API to the design token system
-- **Tokens**: `--transition-bg`, `--transition-duration`, `--transition-easing`, `--transition-push`, `--transition-pop`, `--transition-replace`
-- **Router `transitions.run()`** injects a token-aware stylesheet on first use
-- **Dock `swap()`** reads directional easing from tokens (`--transition-push` vs `--transition-pop`) for physically different forward/back feel
-- **High-contrast theme morphing** — `contrast.css` now declares `transition:` for smooth token interpolation
-
-#### Documentation
-
-- **Comprehensive `docs/index.md`** — master docs entry with all modules listed by usefulness
-- **`docs/sw/`** — complete SW documentation: `index.md`, `start.md`, `strategies.md`, `routes.md`, `sync.md`, `api.md`
-- **Updated `docs/intro/`** — SW toolkit in feature list, build output includes `dist/sw.js`
-- **View Transition token docs** added to `docs/ui/transitions.md`, `docs/router/transitions.md`, `docs/animations/tokens.md`
-
-#### Tooling
-
-- **`tools/src/build/graph.rs` split** into focused modules:
-  - `cache.rs` — incremental build cache (`.anzacache.json`)
-  - `parse.rs` — ESM AST parsing with swc
-  - `entries.rs` — entry point discovery from HTML and `src/sw.js`
-  - `resolve.rs` — import map and filesystem resolution
-  - `html.rs` — HTML injection (importmap link, HMR script)
-  - `sw.rs` — Service Worker bare-specifier rewriting
-- **Auto-discovery of `src/sw.js`** as a build entry point
-- **Bare specifier rewriting in `dist/sw.js`** — `@adukiorg/anza/sw` → `./sw/index.js` (SW does not support import maps)
-
-### Changed
-
-- **Cache file renamed** from `.anza-build-cache.json` to `.anzacache.json`
-- **Scaffolded `src/app.js`** now imports and auto-registers the Service Worker
-- **Scaffolded `src/sw.js`** included in both Node.js and Rust `create` commands
-
-### Fixed
-
-- High-contrast theme (`contrast.css`) now animates token changes instead of snapping instantly
-
----
-
-## [0.2.0] — 2026-06-07
-
-### Added
-
-#### Compiler — `anza`
-
-- **Dependency Graph Walking**: Automated dependency resolution of ESM imports/exports.
-- **Tree-Shaking**: Outputs only referenced files to `dist/`, excluding unused code.
-- **Automatic Inline Importmaps**: Optimal `<script type="importmap">` generated and injected inline into HTML entry points.
-- **Relative Component Styles & Templates**: Parses relative template and stylesheet file paths referenced in `ui.element` relative to `import.meta.url`.
-- **Concurrent File Watcher**: Recompiles output on file modifications.
-- **SSE HMR Dev Server**: CSS hot-swapping and HTML/JS auto-reloading via Server-Sent Events (SSE).
-- **Nested /dist Routing**: Added router nested service mapping in Axum dev server for development path parity.
-
-#### Structure
-
-- **Monorepo Split**: Reorganized files into `/library` (NPM package), `/sample` (demo application), and `/tools` (Rust compiler).
-
-#### Sample
-
-- **Cyberpunk Blog SPA**: Features reactive store, category filters, instant search, likes count persistence, details page with lightweight custom markdown renderer, post publishing, and post deletion.
-
----
-
-## [0.1.0] — 2026-05-27
-
-### Added
-
-#### Package
-
-- Published as `@adukiorg/anza` — pure browser ESM, zero build step
-- Scoped subpath exports for every core module (`/api`, `/state`, `/storage`, etc.)
-- `"type": "module"` — fully native ESM, no CommonJS wrapper
-- `npm test` via `@web/test-runner` (real Chromium, no jsdom)
-- `npm run serve` via `@web/dev-server` on port 8080
-
-#### Core — `@adukiorg/anza/api`
-
-- `execute()` — fetch wrapper with AbortSignal, timeout, and `scheduler.postTask` integration
-- `PlatformError` — unified error shape across all network failures
-- `retry()` — exponential backoff with jitter and AbortSignal support
-- `stream()` — async generator streaming over NDJSON responses
-- `createNDJSONTransform()` — reusable `TransformStream` for NDJSON parsing
-- `upload()` — multipart file upload with progress events
-- `pipeline` — composable request/response middleware pipeline
-- Cache strategies: `cache-first`, `network-first`, `stale-while-revalidate`
-
-#### Core — `@adukiorg/anza/state`
-
-- `ReactiveStore` — Proxy-based reactive state with microtask-batched notifications
-- `setActiveSubscriber` / `getActiveSubscriber` — dependency tracking context
-- `derived()` — auto-tracked computed values that re-evaluate on dependency changes
-- `sync()` — BroadcastChannel cross-tab state synchronization
-
-#### Core — `@adukiorg/anza/events`
-
-- `EventBus` — typed pub/sub with wildcard patterns and AbortSignal cleanup
-- `events` — singleton global event bus instance
-
-#### Core — `@adukiorg/anza/router`
-
-- `register()` / `match()` — URL pattern registration and matching
-- `clear()` / `getRoutes()` — route registry management
-- `addGuard()` — async navigation guard hooks
-- `setNotFound()` — 404 handler
-- `setup()` — bootstraps native Navigation API interception
-- Full programmatic history API: `navigate`, `replace`, `back`, `forward`, `go`, `current`, `entries`
-- `renderOutlet()` — declarative route outlet rendering
-
-#### Core — `@adukiorg/anza/storage`
-
-- `Database` — Promise-wrapped IndexedDB with sequential migrations
-- `LRUCache` / `WeakLRUCache` — in-memory LRU caches with optional TTL
-- `storage` — unified tiered facade: memory → IndexedDB → Cache API → OPFS
-- `quota` — storage estimate and persistence request helpers
-
-#### Core — `@adukiorg/anza/offline`
-
-- `queue` — IndexedDB-backed offline operation queue with FIFO dequeue
-- `check()` / `subscribe()` — connectivity detection and change subscriptions
-
-#### Core — `@adukiorg/anza/animations`
-
-- `animate()` — WAAPI wrapper with AbortSignal and easing controls
-- `stagger()` — staggered multi-element animation groups with `finished` promise
-
-#### Core — `@adukiorg/anza/workers`
-
-- `lock()` — Web Locks API facade with timeout and AbortSignal support
-- `WorkerPool` — managed pool of Web Workers with task queue and concurrency limits
-
-#### Core — `@adukiorg/anza/security`
-
-- `sanitize()` — XSS-safe HTML sanitizer using `DOMParser`
-- `uuid()` — `crypto.randomUUID()` wrapper
-- `hash()` — SHA-256/384/512 via Web Crypto API
-- `generateKey()` / `deriveKey()` — AES-GCM key generation and PBKDF2 derivation
-- `encrypt()` / `decrypt()` — AES-GCM symmetric encryption/decryption
-
-#### Core — `@adukiorg/anza/platform`
-
-- `supports` — feature detection registry for 30+ browser APIs
-- `reset()` — cache reset utility (used in tests)
-
-#### Core — `@adukiorg/anza/ui`
-
-- `BaseElement` — Shadow DOM base class for all custom elements
-- Design token cascade: primitive → semantic → component token layers
-
-#### Tests
-
-- 26 test suites, 70 assertions — all running in real Chromium via `@web/test-runner`
-- Browser-native import maps injected per test run — no Node.js module resolution
-
-#### Blog Demo
-
-- `blog/` — sample SPA demonstrating state, storage, offline queue, and animations
-- Import map mirrors the published `@adukiorg/anza/*` subpath exports exactly
-
-[Unreleased]: https://github.com/aduki-org/anza/compare/v0.2.1...HEAD
-[0.2.1]: https://github.com/aduki-org/anza/compare/v0.2.0...v0.2.1
-[0.2.0]: https://github.com/aduki-org/anza/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/aduki-org/anza/releases/tag/v0.1.0

package/src/tokens/primitives/radius.css

@@ -1,16 +0,0 @@
-/**
- * tokens/primitives/radius.css
- *
- * Border radius scale from none to full pill/circle shapes.
- * Source: doc 26 §4
- */
-
-:root {
-  --radius-none: 0px;
-  --radius-sm:   0.125rem;   /* 2px */
-  --radius-md:   0.375rem;   /* 6px */
-  --radius-lg:   0.5rem;     /* 8px */
-  --radius-xl:   0.75rem;    /* 12px */
-  --radius-2xl:  1rem;       /* 16px */
-  --radius-full: 9999px;     /* Pill / Circle */
-}

package/src/tokens/primitives/shadow.css

@@ -1,34 +0,0 @@
-/**
- * tokens/primitives/shadow.css
- *
- * Elevation shadows using modern ambient + key light OKLCH alpha models.
- * Dark mode shadows automatically increase opacity to counteract low contrast.
- * Source: doc 26 §4
- */
-
-:root {
-  --shadow-xs:   0 1px 2px 0 oklch(0% 0 0 / 0.05);
-  --shadow-sm:   0 1px 3px 0 oklch(0% 0 0 / 0.1), 0 1px 2px -1px oklch(0% 0 0 / 0.1);
-  --shadow-md:   0 4px 6px -1px oklch(0% 0 0 / 0.1), 0 2px 4px -2px oklch(0% 0 0 / 0.1);
-  --shadow-lg:   0 10px 15px -3px oklch(0% 0 0 / 0.1), 0 4px 6px -4px oklch(0% 0 0 / 0.1);
-  --shadow-xl:   0 20px 25px -5px oklch(0% 0 0 / 0.1), 0 8px 10px -6px oklch(0% 0 0 / 0.1);
-  --shadow-none: 0 0 #0000;
-}
-
-[data-theme="dark"] {
-  --shadow-xs:   0 1px 2px 0 oklch(0% 0 0 / 0.15);
-  --shadow-sm:   0 1px 3px 0 oklch(0% 0 0 / 0.3), 0 1px 2px -1px oklch(0% 0 0 / 0.3);
-  --shadow-md:   0 4px 6px -1px oklch(0% 0 0 / 0.3), 0 2px 4px -2px oklch(0% 0 0 / 0.3);
-  --shadow-lg:   0 10px 15px -3px oklch(0% 0 0 / 0.3), 0 4px 6px -4px oklch(0% 0 0 / 0.3);
-  --shadow-xl:   0 20px 25px -5px oklch(0% 0 0 / 0.3), 0 8px 10px -6px oklch(0% 0 0 / 0.3);
-}
-
-@media (prefers-color-scheme: dark) {
-  :root:not([data-theme="light"]) {
-    --shadow-xs:   0 1px 2px 0 oklch(0% 0 0 / 0.15);
-    --shadow-sm:   0 1px 3px 0 oklch(0% 0 0 / 0.3), 0 1px 2px -1px oklch(0% 0 0 / 0.3);
-    --shadow-md:   0 4px 6px -1px oklch(0% 0 0 / 0.3), 0 2px 4px -2px oklch(0% 0 0 / 0.3);
-    --shadow-lg:   0 10px 15px -3px oklch(0% 0 0 / 0.3), 0 4px 6px -4px oklch(0% 0 0 / 0.3);
-    --shadow-xl:   0 20px 25px -5px oklch(0% 0 0 / 0.3), 0 8px 10px -6px oklch(0% 0 0 / 0.3);
-  }
-}

package/src/tokens/primitives/zindex.css

@@ -1,18 +0,0 @@
-/**
- * tokens/primitives/zindex.css
- *
- * Explicit layer indices to eliminate z-index escalation bugs.
- * Source: doc 26 §4
- */
-
-:root {
-  --z-index-base:     0;
-  --z-index-raised:   10;
-  --z-index-dropdown: 100;
-  --z-index-sticky:   200;
-  --z-index-overlay:  300;
-  --z-index-modal:    400;
-  --z-index-popover:  500;
-  --z-index-toast:    600;
-  --z-index-tooltip:  700;
-}

package/src/tokens/semantic/components.css

@@ -1,123 +0,0 @@
-/**
- * tokens/semantic/components.css
- *
- * Semantic component-level design tokens.
- */
-
-:root {
-  /* Form Controls */
-  --input-bg:           var(--background);
-  --input-border:       var(--border);
-  --input-border-focus: var(--border-focus);
-  --input-radius:       var(--radius-md);
-  --input-font-size:    var(--text-md);
-  --input-padding-y:    var(--space-sm);
-  --input-padding-x:    var(--space-md);
-  --input-text-color:   var(--foreground);
-
-  --textarea-bg:           var(--background);
-  --textarea-border:       var(--border);
-  --textarea-border-focus: var(--border-focus);
-  --textarea-radius:       var(--radius-md);
-  --textarea-font-size:    var(--text-md);
-  --textarea-padding-y:    var(--space-sm);
-  --textarea-padding-x:    var(--space-md);
-  --textarea-text-color:   var(--foreground);
-
-  --check-bg:           var(--background);
-  --check-bg-checked:   var(--primary);
-  --check-border:       var(--border);
-  --check-border-focus: var(--border-focus);
-  --check-radius:       var(--radius-sm);
-  --check-size:         var(--space-lg);
-  --check-color:        var(--primary-foreground);
-
-  --radio-bg:           var(--background);
-  --radio-bg-checked:   var(--primary);
-  --radio-border:       var(--border);
-  --radio-border-focus: var(--border-focus);
-  --radio-radius:       var(--radius-full);
-  --radio-size:         var(--space-lg);
-  --radio-color:        var(--primary-foreground);
-
-  --switch-bg:           var(--border-strong);
-  --switch-bg-on:        var(--primary);
-  --switch-thumb-color:  var(--primary-foreground);
-  --switch-width:        var(--space-xl);
-  --switch-height:       var(--space-lg);
-  --switch-thumb-size:   calc(var(--switch-height) - var(--space-xs));
-
-  --select-bg:           var(--background);
-  --select-border:       var(--border);
-  --select-border-focus: var(--border-focus);
-  --select-radius:       var(--radius-md);
-  --select-font-size:    var(--text-md);
-  --select-padding-y:    var(--space-sm);
-  --select-padding-x:    var(--space-md);
-  --select-text-color:   var(--foreground);
-
-  --upload-bg:           var(--background);
-  --upload-border:       var(--border);
-  --upload-border-focus: var(--border-focus);
-  --upload-radius:       var(--radius-lg);
-  --upload-padding:      var(--space-xl);
-  --upload-color:        var(--foreground-muted);
-
-  /* Feedback */
-  --alert-radius: var(--radius-md);
-  --alert-bg:     var(--background-elevated);
-  --alert-color:  var(--foreground);
-  --alert-border: var(--border);
-
-  --skeleton-bg:     var(--foreground-disabled);
-  --skeleton-radius: var(--radius-md);
-  --skeleton-width:  100%;
-  --skeleton-height: var(--space-md);
-
-  /* Data Display */
-  --card-radius: var(--radius-lg);
-
-  --stat-label: var(--text-xs);
-  --stat-value: var(--text-3xl);
-
-  /* Navigation */
-  --link-color:        var(--foreground-link);
-  --link-color-hover:  var(--primary-hover);
-  --link-color-active: var(--primary-active);
-
-  /* Layout */
-  --stack-gap:  var(--space-md);
-
-  --grid-gap:  var(--space-md);
-  --grid-cols: repeat(auto-fit, minmax(250px, 1fr));
-
-  --surface-bg:     var(--background);
-  --surface-border: transparent;
-  --surface-shadow: none;
-  --surface-radius: var(--radius-none);
-
-  /* Overlay */
-  --dialog-radius: var(--radius-lg);
-  --dialog-shadow: var(--shadow-xl);
-
-  --popover-bg:    var(--background-elevated);
-  --popover-border: var(--border);
-  --popover-shadow: var(--shadow-lg);
-  --popover-radius: var(--radius-md);
-
-  --tooltip-bg:    var(--background-inverse);
-  --tooltip-color: var(--foreground-inverse);
-  --tooltip-radius: var(--radius-sm);
-
-  --menu-bg:       var(--background-elevated);
-  --menu-border:    var(--border);
-  --menu-shadow:    var(--shadow-lg);
-  --menu-radius:    var(--radius-md);
-
-  --drawer-shadow: var(--shadow-xl);
-  --drawer-width:  min(calc(var(--space-5xl) * 3), 85vw);
-
-  --sheet-radius: var(--radius-lg);
-  --sheet-shadow: var(--shadow-xl);
-  --sheet-max-width: min(calc(var(--space-5xl) * 6), 100vw);
-}