iridis: changelog

iridis 0.4.5

Tue, 19 May 2026 12:00:00 GMT

### Fixed - **Image-mode theming** now drives the docs cascade end-to-end. `ImageToTheme` was reading `state.metadata['gallery'].dominantColors` and `.histogram`, but the engine writes outputs to the colon-prefixed `state.metadata['gallery:dominantColors']` and `state.metadata['gallery:histogram']` keys. The extractor silently produced an empty seed list every run, so `configStore.paletteColors` never updated and dropping an image or picking a preset left every `--iridis-*` variable on the page unchanged. The component now reads the canonical keys; the spectrograph and the docs-wide theme both track the extracted palette and re-resolve through dark/light framing toggles. - **WCAG / APCA role badges** in `BuildResolvedRoles` were sourced from a non-existent `state.metadata['wcag']` blob. The contrast plugin writes three separate keys — `state.metadata['contrast:aa']`, `['contrast:aaa']`, `['contrast:apca']`. `roleBadge` now reads each key directly so the AA / AAA / APCA·Bronze indicators render again.

iridis 0.4.4

Mon, 18 May 2026 12:00:00 GMT

### Changed - **README structure** trimmed to match the json-tology pattern: composite header SVG up top, then concise Documentation / Requirements / Install / License / Changelog sections. The long-form usage walkthroughs that previously lived in the README are kept on the docs site. - **Composite header SVG** (`docs/public/readme-header.svg`) replaces the standalone `iridis-node.svg`. The new SVG is 1280×320, base64-embeds `docs/public/logo.png` on the left, and renders the wordmark + version pill + tagline + palette swatches on the right. Single asset, self-contained, used by both the README and the release-publish workflow. ### Removed - `docs/public/iridis-node.svg` and its template — superseded by `readme-header.svg`.

iridis 0.4.3

Mon, 18 May 2026 12:00:00 GMT

### Fixed - **README header image now uses the sidebar logo.** v0.4.2 shipped with a brand-new hex-node SVG drawn from the favicon vector. The README image is supposed to match the rest of the site — every other surface (VitePress sidebar, favicon, apple-touch-icon, msapplication-TileImage) renders `docs/public/logo.png`. The versioned SVG now base64-embeds `logo.png` directly so the README, GitHub release pages, and the docs site all show the same artifact. Version pill below the image unchanged.

iridis 0.4.2

Mon, 18 May 2026 12:00:00 GMT

Docs and release-pipeline polish. ### Added - **Versioned README header.** Replaces the static logo with a brand-styled `iridis-node` hex SVG that carries the current release version in a pill below the wordmark. The SVG is referenced via `raw.githubusercontent.com` so it renders correctly in the README on GitHub and in release-notes bodies. - **Release-publish workflow** (`.github/workflows/release.yml`). Fires on any `v*` tag push: verifies the stamped SVG matches the tag, extracts the matching `## []` section from `CHANGELOG.md`, and creates or updates the GitHub release with a body that embeds the per-tag SVG URL. Historical release pages render the version that was tagged at that moment rather than always-latest. Supports `workflow_dispatch` for manual republish. - **`scripts/stamp-version.mjs`** reads `packages/core/package.json` and stamps every `docs/public/*.svg.template` into its sibling `.svg` with the current version. `--check` flag is the CI drift guard. Wired into `predocs:build` so the docs site always carries a fresh stamp. - **Self-contained `og-image.svg`.** Embeds the favicon vector inline so the SVG renders correctly when uploaded as the GitHub social preview or fetched by link-unfurl bots that don't co-locate adjacent assets.

iridis 0.4.1

Mon, 18 May 2026 12:00:00 GMT

### Fixed - **Peer-dependency ranges in plugin packages** updated to `^0.4.0` so workspace resolution links `@studnicky/iridis` correctly under `npm ci`. The 0.4.0 release shipped with plugins declaring `^0.3.0`, which made `npm ci` fall through to the public npm registry (where the package is unpublished) and 404. CI build for the docs site failed as a result; this release fixes the workspace-internal linking.

iridis 0.4.0

Mon, 18 May 2026 12:00:00 GMT

Schema-first engine foundation, flat slot grammar, and full test refactor. Breaking on plugin slot names and the `PluginOutputsRegistry` / `PluginMetadataRegistry` module-augmentation pattern. ### Breaking - **Flat colon-namespaced slot grammar.** `state.outputs` and `state.metadata` use a single top-level key per slot, namespaced by plugin (`capacitor:statusBar`, `vscode:themeJson`, `stylesheet:cssVars`, `rdf:reasoningGraph`, `gallery:histogram`, `contrast:aa`, `core:json`, etc.). The previous namespace-object pattern (`state.outputs['capacitor'].statusBar`) is gone. User configs map slot keys to filenames 1:1 in `output.files`. - **`declare module '@studnicky/iridis'` augmentation pattern deleted.** Plugins now expose `schemas(): { outputs?: Record, metadata?: Record }` on `PluginInterface` to declare their slot shapes. The engine validates `state.outputs[slot]` and `state.metadata[slot]` against the contributing plugin's schema at run exit. - **Typed intakes throw on non-conforming input.** `intake:hex`, `intake:rgb`, `intake:hsl`, `intake:oklch`, `intake:lab`, `intake:p3`, `intake:named`, `intake:imagePixels` reject malformed input with a descriptive error. `intake:any` keeps polymorphic dispatch — iterates delegates, first non-null parse wins, throws only if no delegate matches. ### Added - **ajv-backed validator** with per-engine compile cache. Replaces the hand-rolled draft-07 walker. `Validator` is now a thin wrapper around ajv. - **`json-schema-to-ts`** derives TS interfaces from `as const` schema literals via `FromSchema`. JSON Schema is the source of truth for every boundary type. - **`TaskManifestSchema`** validates every adopted task's manifest at `Engine.adopt`, again at `Engine.pipeline`, and at `Engine.run` entry. Defense in depth. - **Upstream `output.files` validation** at `Cli.run`: rejects configs that declare a slot no pipeline task writes. The error names the missing slot and lists the slots that ARE produced. - **Bundle aggregator pattern** (opt-in): plugins may ship an `emit:Bundle` task that reads sibling slots and writes one combined slot for users who want one file containing the whole plugin namespace. - **Scenario-matrix test suites** across all 9 packages. Cells, coordinate-tagged assertion messages, happy/edge/unhappy scenarios per subject. ~700 scenarios workspace-wide. ### Fixed - **VSCode P3 leak.** `EnsureContrast.apply` now preserves the source gamut. sRGB-sourced foregrounds (hex inputs) round-trip through contrast adjustment as sRGB instead of being re-stamped as `displayP3`. VSCode theme slots like `gitDecoration.addedResourceForeground` emit `#rrggbb` hex for sRGB inputs instead of `color(display-p3 …)`. ### Removed - **Dead `requires` runtime guards** in vscode tasks (`ApplyModifiers`, `EmitVscodeSemanticRules`, `EmitVscodeThemeJson`). `Engine.pipeline` validates these declarations at build time; the runtime throws were unreachable. - **`PluginOutputsRegistry` / `PluginMetadataRegistry`** TypeScript registry interfaces. Plugin output and metadata shapes now flow through schemas, not module augmentation. ### Dependencies - `@studnicky/iridis` (core) adds runtime deps: `ajv@^8.20.0`, `json-schema-to-ts@^3.1.1`. The "zero runtime dependencies" claim is gone.

iridis 0.3.6

Sun, 17 May 2026 12:00:00 GMT

Docs site refactor. Eliminates the entire import-map fragility class. ### Removed - **CDN externalisation of Vue, PrimeVue, `@primeuix/themes`, and mermaid.** The site used to load these from `esm.sh` at runtime via an import-map declared in ``; that approach forced a fragile head-ordering dance (see v0.3.4 / v0.3.5) because VitePress 1.x emits its own `