@excom/nucleus-kit 0.1.0

package/.rush/temp/chunked-rush-logs/nucleus-kit.apply-exports.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/chunked-rush-logs/nucleus-kit.build_docs.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs \n"}

package/.rush/temp/chunked-rush-logs/nucleus-kit.build_package-metas.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/apply-exports/all.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/.rush/temp/operation/apply-exports/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/operation/apply-exports/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 33.996419999999944
+}

package/.rush/temp/operation/build_docs/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs 

package/.rush/temp/operation/build_docs/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs \n"}

package/.rush/temp/operation/build_docs/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 36.887054000000035
+}

package/.rush/temp/operation/build_package-metas/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/.rush/temp/operation/build_package-metas/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/build_package-metas/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 89.94967499999984
+}

package/.rush/temp/shrinkwrap-deps.json

@@ -0,0 +1,3 @@
+{
+  "../../packages/nucleus-kit": "../../packages/nucleus-kit:/A06Wgiyi4bzWWfjrcfyvxiVdBtW/mKsf/tz52eP+1g=:"
+}

package/basic.css

@@ -0,0 +1,2 @@
+@import "@excom/valence/basic.css";
+@import "./custom-elements.css";

package/config/rig.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+  "rigPackageName": "@excom/heft-rig",
+  "rigProfile": "default"
+}
+

package/custom-elements.css

@@ -0,0 +1,18 @@
+/* Nucleus Kit element CSS. */
+@import "@excom/content-carousel/index.css";
+@import "@excom/content-drawer/index.css";
+@import "@excom/content-tabs/index.css";
+/* @import "@excom/provider-fetch/index.css"; */
+@import "@excom/data-table/index.css";
+@import "@excom/dialog-anchor/index.css";
+@import "@excom/event-handler/index.css";
+@import "@excom/gesture-handler/index.css";
+@import "@excom/include-content/index.css";
+/* @import "@excom/mapbox-view/index.css"; */
+@import "@excom/quark-sheet/index.css";
+@import "@excom/scroll-into-view/index.css";
+@import "@excom/spa-route/index.css";
+/* @import "@excom/super-form/index.css"; */
+/* @import "@excom/super-img/index.css"; */
+@import "@excom/super-input/index.css";
+/* @import "@excom/detect-features/index.css"; */

package/index.ts

@@ -0,0 +1,27 @@
+export * from "@excom/content-carousel";
+export * from "@excom/content-drawer";
+export * from "@excom/content-tabs";
+export * from "@excom/data-table";
+export * from "@excom/detect-browser";
+export * from "@excom/detect-features";
+export * from "@excom/detect-media";
+export * from "@excom/dialog-anchor";
+export * from "@excom/dismiss-watcher";
+export * from "@excom/dom-observer";
+export * from "@excom/event-handler";
+export * from "@excom/gesture-handler";
+export * from "@excom/include-content";
+export * from "@excom/network-status";
+export * from "@excom/neutron";
+export * from "@excom/provider-fetch";
+export * from "@excom/provider-geolocation";
+export * from "@excom/provider-orientation";
+export * from "@excom/provider-storage";
+export * from "@excom/quark";
+export * from "@excom/quark-sheet";
+export * from "@excom/scroll-into-view";
+export * from "@excom/service-worker";
+export * from "@excom/spa-route";
+export * from "@excom/super-form";
+export * from "@excom/super-input";
+export * from "@excom/web-authn";

package/nucleus-kit.progressive.ts

@@ -0,0 +1,107 @@
+/**
+ * `nucleus-kit.progressive.min.js`: lazy Nucleus Kit. Watches for Nucleus Kit
+ * element tags (initial scan + `MutationObserver`) and imports that package on
+ * first sight. Shared chunks (`neutron`, `kit-utils`, `quark`, bases) live
+ * under `dist/progressive/` and load once.
+ *
+ * Vs the all-in `index.umd.min.js`: one extra round-trip before upgrade
+ * (style the pre-upgrade state yourself), and ESM only.
+ */
+type Loader = () => Promise<unknown>;
+
+const contentCarousel: Loader = () => import("@excom/content-carousel");
+const contentDrawer: Loader = () => import("@excom/content-drawer");
+const contentTabs: Loader = () => import("@excom/content-tabs");
+const dataTable: Loader = () => import("@excom/data-table");
+const spaRoute: Loader = () => import("@excom/spa-route");
+
+/** Element tag → the package that defines it. */
+export const PROGRESSIVE_LOADERS: Readonly<Record<string, Loader>> = {
+  "content-carousel": contentCarousel,
+  "content-carousel-slide": contentCarousel,
+  "content-drawer": contentDrawer,
+  "content-tabs": contentTabs,
+  "content-tabs-body": contentTabs,
+  "content-tabs-header": contentTabs,
+  "data-table": dataTable,
+  "data-th": dataTable,
+  "detect-browser": () => import("@excom/detect-browser"),
+  "detect-features": () => import("@excom/detect-features"),
+  "detect-media": () => import("@excom/detect-media"),
+  "dialog-anchor": () => import("@excom/dialog-anchor"),
+  "dismiss-watcher": () => import("@excom/dismiss-watcher"),
+  "dom-observer": () => import("@excom/dom-observer"),
+  "event-handler": () => import("@excom/event-handler"),
+  "gesture-handler": () => import("@excom/gesture-handler"),
+  "include-content": () => import("@excom/include-content"),
+  "network-status": () => import("@excom/network-status"),
+  "provider-fetch": () => import("@excom/provider-fetch"),
+  "provider-geolocation": () => import("@excom/provider-geolocation"),
+  "provider-orientation": () => import("@excom/provider-orientation"),
+  "provider-storage": () => import("@excom/provider-storage"),
+  "quark-sheet": () => import("@excom/quark-sheet"),
+  "scroll-into-view": () => import("@excom/scroll-into-view"),
+  "service-worker": () => import("@excom/service-worker"),
+  "spa-a": spaRoute,
+  "spa-manager": spaRoute,
+  "spa-route": spaRoute,
+  "super-form": () => import("@excom/super-form"),
+  "super-input": () => import("@excom/super-input"),
+  "web-authn": () => import("@excom/web-authn"),
+};
+
+/** Every tag the progressive entry can load. */
+export const PROGRESSIVE_TAGS: readonly string[] =
+  Object.keys(PROGRESSIVE_LOADERS);
+
+const SELECTOR = PROGRESSIVE_TAGS.join(",");
+const pending = new Map<Loader, Promise<unknown>>();
+
+/**
+ * Load (once) the package defining `tag`. Resolves when its module has
+ * evaluated, i.e. the element is defined; `undefined` for tags Nucleus Kit
+ * does not know. A failed import is logged and retried on the next call.
+ */
+export const loadElement = (tag: string): Promise<unknown> | undefined => {
+  const loader = PROGRESSIVE_LOADERS[tag];
+  if (!loader) return undefined;
+  let promise = pending.get(loader);
+  if (!promise) {
+    promise = loader().catch((error) => {
+      pending.delete(loader);
+      console.error(`[nucleus-kit] failed to load <${tag}>`, error);
+      throw error;
+    });
+    pending.set(loader, promise);
+  }
+  return promise;
+};
+
+const scan = (node: Node) => {
+  if (node instanceof Element && node.localName in PROGRESSIVE_LOADERS) {
+    loadElement(node.localName);
+  }
+  if ("querySelectorAll" in node) {
+    (node as ParentNode)
+      .querySelectorAll(SELECTOR)
+      .forEach((el) => loadElement(el.localName));
+  }
+};
+
+/**
+ * Load the Nucleus Kit elements as their tags appear under `root` (an initial
+ * scan, then every inserted subtree). Returns a disposer. The entry calls this
+ * on `document` at import time; call it yourself for a shadow root.
+ */
+export const observeElements = (
+  root: Document | Element | ShadowRoot
+): (() => void) => {
+  scan(root);
+  const observer = new MutationObserver((records) => {
+    for (const record of records) record.addedNodes.forEach(scan);
+  });
+  observer.observe(root, { childList: true, subtree: true });
+  return () => observer.disconnect();
+};
+
+observeElements(document);

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@excom/nucleus-kit",
+  "version": "0.1.0",
+  "description": "The whole Nucleus Stack in one package — elements, Quark, Valence.css",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "type": "module",
+  "dependencies": {
+    "@excom/content-carousel": "^0.1.0",
+    "@excom/content-drawer": "^0.1.0",
+    "@excom/content-tabs": "^0.1.0",
+    "@excom/data-table": "^0.1.0",
+    "@excom/detect-browser": "^0.1.0",
+    "@excom/detect-features": "^0.1.0",
+    "@excom/detect-media": "^0.1.0",
+    "@excom/dismiss-watcher": "^0.1.0",
+    "@excom/dom-observer": "^0.1.0",
+    "@excom/event-handler": "^0.1.0",
+    "@excom/include-content": "^0.1.0",
+    "@excom/gesture-handler": "^0.1.0",
+    "@excom/dialog-anchor": "^0.1.0",
+    "@excom/network-status": "^0.1.0",
+    "@excom/neutron": "^0.1.0",
+    "@excom/provider-fetch": "^0.1.0",
+    "@excom/provider-orientation": "^0.1.0",
+    "@excom/provider-geolocation": "^0.1.0",
+    "@excom/provider-storage": "^0.1.0",
+    "@excom/quark": "^0.1.0",
+    "@excom/quark-sheet": "^0.1.0",
+    "@excom/scroll-into-view": "^0.1.0",
+    "@excom/service-worker": "^0.1.0",
+    "@excom/spa-route": "^0.1.0",
+    "@excom/super-form": "^0.1.0",
+    "@excom/super-input": "^0.1.0",
+    "@excom/valence": "^0.1.0",
+    "@excom/web-authn": "^0.1.0"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@excom/heft-rig": "^0.1.0"
+  },
+  "repository": {
+    "url": "excom-dev/nucleus",
+    "directory": "packages/nucleus-kit"
+  },
+  "homepage": "https://github.com/excom-dev/nucleus/tree/main/packages/nucleus-kit/support/docs/README.md",
+  "bugs": "https://github.com/excom-dev/nucleus/issues",
+  "keywords": [
+    "nucleus-kit"
+  ],
+  "excom": {
+    "packageType": "library",
+    "sideEffectImport": true
+  },
+  "scripts": {
+    "build": "node node_modules/@excom/heft-rig/scripts/vite-build.mjs",
+    "build:watch": "node node_modules/@excom/heft-rig/scripts/vite-build-watch.mjs",
+    "format": "node node_modules/@excom/heft-rig/scripts/format.mjs",
+    "test": "node node_modules/@excom/heft-rig/scripts/vitest.mjs",
+    "coverage": "node node_modules/@excom/heft-rig/scripts/coverage.mjs",
+    "dev": "node node_modules/@excom/heft-rig/scripts/vite-dev.mjs",
+    "preview": "node node_modules/@excom/heft-rig/scripts/vite-preview.mjs",
+    "build:package-metas": "node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs",
+    "build:docs": "node node_modules/@excom/heft-rig/scripts/build-docs.mjs"
+  }
+}

package/rush-logs/nucleus-kit.apply-exports.cache.log

@@ -0,0 +1 @@
+Caching has been disabled for this project's "apply-exports" command.

package/rush-logs/nucleus-kit.apply-exports.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/rush-logs/nucleus-kit.build_docs.cache.log

@@ -0,0 +1 @@
+This project does not define the caching behavior of the "build:docs" command, so caching has been disabled.

package/rush-logs/nucleus-kit.build_docs.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs 

package/rush-logs/nucleus-kit.build_package-metas.cache.log

@@ -0,0 +1 @@
+This project does not define the caching behavior of the "build:package-metas" command, so caching has been disabled.

package/rush-logs/nucleus-kit.build_package-metas.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/support/dist-docs/docs/breaking_changes.md

@@ -0,0 +1,2 @@
+- Renamed web-authn attrs
+- Command-style events became native commands (2026-09-13): `provider-fetch-trigger` → `--fetch`; `super-form-trigger` / `web-authn-trigger` → `--submit`; `content-drawer-open` / `-close` / `-toggle` → `--open` / `--close` / `--toggle` (per-open props from the invoker's `data-*`, not `detail`); `content-carousel-next` / `-back` → `--next` / `--back`; `include-content-reload` / `spa-route-reload` / `quark-sheet-reload` → `--reload`; `provider-geolocation-request` / `provider-orientation-request` → `--request`; `data-table-export` → `--export` (options as `data-file-type` / `data-file-name` / `data-full` on the invoker); `data-table-filter` removed — write `filter-value` / `filter-casing`. Invoke with `<button command="--verb" commandfor="id">`, `<event-handler command-name="--verb" target-ref="…">`, `<dismiss-watcher command-name="--close">`, or `new CommandEvent()`.

package/support/dist-docs/docs/readme.md

@@ -0,0 +1,119 @@
+# Nucleus Kit
+
+The whole Nucleus Stack in one package — every element, provider, Quark, and Valence.css behind a single import.
+
+## Features
+
+- **One JS import** Registers every Nucleus Kit element
+- **One CSS import** Valence.css theme + shared element styles (`basic.css`)
+- **App-ready** Routing, sheets, forms, drawers, providers, and more
+- **À la carte** Every package is published on its own; if you only use a few elements, install just those
+
+## Installation
+
+<include-content is-active template-ref="/views/install-section/install-section.html"></include-content>
+
+## Usage
+
+```js
+import "@excom/nucleus-kit";
+```
+
+```css
+@import "@excom/nucleus-kit/basic.css";
+```
+
+That loads Valence.css (`basic` theme) plus element CSS and registers the
+packages below.
+
+### Progressive bundle (experimental)
+
+`nucleus-kit.progressive.min.js` registers nothing up front. It watches the
+document for Nucleus Kit element tags and imports each element's package the
+first time its tag appears (initial scan, then every inserted subtree), so a
+page pays only for the elements it uses. Packages shared by several elements
+(`neutron`, `kit-utils`, `quark`, the element bases) are separate chunks
+under `dist/progressive/`, fetched once. The entry is 3 kB; a page using
+`quark-sheet` and `content-drawer` loads ~55 kB gzip less than the all-in
+build.
+
+```html
+<script type="module" src="/node_modules/@excom/nucleus-kit/nucleus-kit.progressive.min.js"></script>
+```
+
+Trade-offs: elements upgrade one network round-trip later (style the
+pre-upgrade state with `:not(:defined)`), it is ES modules only, and elements
+inside a shadow root need `observeElements(shadowRoot)` from the same module.
+The all-in `index.umd.min.js` and the ESM `index.js` are unchanged.
+
+### À la carte
+
+Nucleus Kit is a convenience, not a requirement. If you find you are not using
+most of its elements, install the packages you do use individually and drop it:
+
+```sh
+npm install @excom/quark-sheet @excom/provider-fetch @excom/content-drawer
+```
+
+```js
+import "@excom/quark-sheet";
+import "@excom/provider-fetch";
+import "@excom/content-drawer";
+```
+
+Each package is self-contained — same elements, same versions, same CSS hooks —
+and its README documents the slim install. Valence.css is `@excom/valence`.
+
+### What's included
+
+**Core**
+
+- [`neutron`](/nucleus/packages/neutron) — custom element factory
+- [`quark`](/nucleus/packages/quark) / [`quark-sheet`](/nucleus/packages/quark-sheet) — DOM
+  orchestration
+- [`valence`](/nucleus/packages/valence) — Valence.css, semantic CSS (via `basic.css`)
+
+**Layout / chrome**
+
+- [`content-carousel`](/nucleus/packages/content-carousel)
+- [`content-drawer`](/nucleus/packages/content-drawer)
+- [`content-tabs`](/nucleus/packages/content-tabs)
+- [`dialog-anchor`](/nucleus/packages/dialog-anchor)
+- [`dismiss-watcher`](/nucleus/packages/dismiss-watcher)
+- [`data-table`](/nucleus/packages/data-table)
+
+**Content / routing**
+
+- [`include-content`](/nucleus/packages/include-content)
+- [`spa-route`](/nucleus/packages/spa-route)
+- [`scroll-into-view`](/nucleus/packages/scroll-into-view)
+
+**Forms / auth**
+
+- [`super-form`](/nucleus/packages/super-form)
+- [`super-input`](/nucleus/packages/super-input)
+- [`web-authn`](/nucleus/packages/web-authn)
+
+**Providers**
+
+- [`provider-fetch`](/nucleus/packages/provider-fetch)
+- [`provider-geolocation`](/nucleus/packages/provider-geolocation)
+- [`provider-orientation`](/nucleus/packages/provider-orientation)
+- [`provider-storage`](/nucleus/packages/provider-storage)
+
+**Platform**
+
+- [`detect-browser`](/nucleus/packages/detect-browser)
+- [`detect-features`](/nucleus/packages/detect-features)
+- [`detect-media`](/nucleus/packages/detect-media)
+- [`dom-observer`](/nucleus/packages/dom-observer)
+- [`event-handler`](/nucleus/packages/event-handler)
+- [`gesture-handler`](/nucleus/packages/gesture-handler)
+- [`network-status`](/nucleus/packages/network-status)
+- [`service-worker`](/nucleus/packages/service-worker)
+
+### Not in Nucleus Kit
+
+Install separately when needed: `mapbox-view`, `super-img`, element bases
+(`abortable-element`, `fetchable-element`, …), and editor tooling such as
+[`nucleus-quark-highlighter`](/nucleus/packages/nucleus-quark-highlighter).

package/support/docs/BREAKING_CHANGES.md

@@ -0,0 +1,2 @@
+- Renamed web-authn attrs
+- Command-style events became native commands (2026-09-13): `provider-fetch-trigger` → `--fetch`; `super-form-trigger` / `web-authn-trigger` → `--submit`; `content-drawer-open` / `-close` / `-toggle` → `--open` / `--close` / `--toggle` (per-open props from the invoker's `data-*`, not `detail`); `content-carousel-next` / `-back` → `--next` / `--back`; `include-content-reload` / `spa-route-reload` / `quark-sheet-reload` → `--reload`; `provider-geolocation-request` / `provider-orientation-request` → `--request`; `data-table-export` → `--export` (options as `data-file-type` / `data-file-name` / `data-full` on the invoker); `data-table-filter` removed — write `filter-value` / `filter-casing`. Invoke with `<button command="--verb" commandfor="id">`, `<event-handler command-name="--verb" target-ref="…">`, `<dismiss-watcher command-name="--close">`, or `new CommandEvent()`.

package/support/docs/README.md

@@ -0,0 +1,119 @@
+# Nucleus Kit
+
+The whole Nucleus Stack in one package — every element, provider, Quark, and Valence.css behind a single import.
+
+## Features
+
+- **One JS import** Registers every Nucleus Kit element
+- **One CSS import** Valence.css theme + shared element styles (`basic.css`)
+- **App-ready** Routing, sheets, forms, drawers, providers, and more
+- **À la carte** Every package is published on its own; if you only use a few elements, install just those
+
+## Installation
+
+<include-content is-active template-ref="/views/install-section/install-section.html"></include-content>
+
+## Usage
+
+```js
+import "@excom/nucleus-kit";
+```
+
+```css
+@import "@excom/nucleus-kit/basic.css";
+```
+
+That loads Valence.css (`basic` theme) plus element CSS and registers the
+packages below.
+
+### Progressive bundle (experimental)
+
+`nucleus-kit.progressive.min.js` registers nothing up front. It watches the
+document for Nucleus Kit element tags and imports each element's package the
+first time its tag appears (initial scan, then every inserted subtree), so a
+page pays only for the elements it uses. Packages shared by several elements
+(`neutron`, `kit-utils`, `quark`, the element bases) are separate chunks
+under `dist/progressive/`, fetched once. The entry is 3 kB; a page using
+`quark-sheet` and `content-drawer` loads ~55 kB gzip less than the all-in
+build.
+
+```html
+<script type="module" src="/node_modules/@excom/nucleus-kit/nucleus-kit.progressive.min.js"></script>
+```
+
+Trade-offs: elements upgrade one network round-trip later (style the
+pre-upgrade state with `:not(:defined)`), it is ES modules only, and elements
+inside a shadow root need `observeElements(shadowRoot)` from the same module.
+The all-in `index.umd.min.js` and the ESM `index.js` are unchanged.
+
+### À la carte
+
+Nucleus Kit is a convenience, not a requirement. If you find you are not using
+most of its elements, install the packages you do use individually and drop it:
+
+```sh
+npm install @excom/quark-sheet @excom/provider-fetch @excom/content-drawer
+```
+
+```js
+import "@excom/quark-sheet";
+import "@excom/provider-fetch";
+import "@excom/content-drawer";
+```
+
+Each package is self-contained — same elements, same versions, same CSS hooks —
+and its README documents the slim install. Valence.css is `@excom/valence`.
+
+### What's included
+
+**Core**
+
+- [`neutron`](/nucleus/packages/neutron) — custom element factory
+- [`quark`](/nucleus/packages/quark) / [`quark-sheet`](/nucleus/packages/quark-sheet) — DOM
+  orchestration
+- [`valence`](/nucleus/packages/valence) — Valence.css, semantic CSS (via `basic.css`)
+
+**Layout / chrome**
+
+- [`content-carousel`](/nucleus/packages/content-carousel)
+- [`content-drawer`](/nucleus/packages/content-drawer)
+- [`content-tabs`](/nucleus/packages/content-tabs)
+- [`dialog-anchor`](/nucleus/packages/dialog-anchor)
+- [`dismiss-watcher`](/nucleus/packages/dismiss-watcher)
+- [`data-table`](/nucleus/packages/data-table)
+
+**Content / routing**
+
+- [`include-content`](/nucleus/packages/include-content)
+- [`spa-route`](/nucleus/packages/spa-route)
+- [`scroll-into-view`](/nucleus/packages/scroll-into-view)
+
+**Forms / auth**
+
+- [`super-form`](/nucleus/packages/super-form)
+- [`super-input`](/nucleus/packages/super-input)
+- [`web-authn`](/nucleus/packages/web-authn)
+
+**Providers**
+
+- [`provider-fetch`](/nucleus/packages/provider-fetch)
+- [`provider-geolocation`](/nucleus/packages/provider-geolocation)
+- [`provider-orientation`](/nucleus/packages/provider-orientation)
+- [`provider-storage`](/nucleus/packages/provider-storage)
+
+**Platform**
+
+- [`detect-browser`](/nucleus/packages/detect-browser)
+- [`detect-features`](/nucleus/packages/detect-features)
+- [`detect-media`](/nucleus/packages/detect-media)
+- [`dom-observer`](/nucleus/packages/dom-observer)
+- [`event-handler`](/nucleus/packages/event-handler)
+- [`gesture-handler`](/nucleus/packages/gesture-handler)
+- [`network-status`](/nucleus/packages/network-status)
+- [`service-worker`](/nucleus/packages/service-worker)
+
+### Not in Nucleus Kit
+
+Install separately when needed: `mapbox-view`, `super-img`, element bases
+(`abortable-element`, `fetchable-element`, …), and editor tooling such as
+[`nucleus-quark-highlighter`](/nucleus/packages/nucleus-quark-highlighter).

package/support/package-meta.json

@@ -0,0 +1,36 @@
+{
+  "shortName": "nucleus-kit",
+  "package": {
+    "name": "@excom/nucleus-kit",
+    "version": "0.1.0",
+    "description": "The whole Nucleus Stack in one package — elements, Quark, Valence.css",
+    "peerDependencies": {},
+    "excom": {
+      "packageType": "library",
+      "sideEffectImport": true
+    }
+  },
+  "demos": {},
+  "readme": "<h1 id=\"md-nucleus-kit\">Nucleus Kit</h1>\n<p>The whole Nucleus Stack in one package — every element, provider, Quark, and Valence.css behind a single import.</p>\n<h2 id=\"md-features\">Features</h2>\n<ul>\n<li><strong>One JS import</strong> Registers every Nucleus Kit element</li>\n<li><strong>One CSS import</strong> Valence.css theme + shared element styles (<code>basic.css</code>)</li>\n<li><strong>App-ready</strong> Routing, sheets, forms, drawers, providers, and more</li>\n<li><strong>À la carte</strong> Every package is published on its own; if you only use a few elements, install just those</li>\n</ul>\n<h2 id=\"md-installation\">Installation</h2>\n<p><include-content is-active template-ref=\"/views/install-section/install-section.html\"></include-content></p>\n<h2 id=\"md-usage\">Usage</h2>\n<include-content data-language=\"js\"><template>import \"@excom/nucleus-kit\";</template></include-content>\n<include-content data-language=\"css\"><template>@import \"@excom/nucleus-kit/basic.css\";</template></include-content>\n<p>That loads Valence.css (<code>basic</code> theme) plus element CSS and registers the\npackages below.</p>\n<h3 id=\"md-progressive-bundle-experimental\">Progressive bundle (experimental)</h3>\n<p><code>nucleus-kit.progressive.min.js</code> registers nothing up front. It watches the\ndocument for Nucleus Kit element tags and imports each element&#39;s package the\nfirst time its tag appears (initial scan, then every inserted subtree), so a\npage pays only for the elements it uses. Packages shared by several elements\n(<code>neutron</code>, <code>kit-utils</code>, <code>quark</code>, the element bases) are separate chunks\nunder <code>dist/progressive/</code>, fetched once. The entry is 3 kB; a page using\n<code>quark-sheet</code> and <code>content-drawer</code> loads ~55 kB gzip less than the all-in\nbuild.</p>\n<include-content data-language=\"html\"><template>&lt;script type=\"module\" src=\"/node_modules/@excom/nucleus-kit/nucleus-kit.progressive.min.js\"&gt;&lt;/script&gt;</template></include-content>\n<p>Trade-offs: elements upgrade one network round-trip later (style the\npre-upgrade state with <code>:not(:defined)</code>), it is ES modules only, and elements\ninside a shadow root need <code>observeElements(shadowRoot)</code> from the same module.\nThe all-in <code>index.umd.min.js</code> and the ESM <code>index.js</code> are unchanged.</p>\n<h3 id=\"md-la-carte\">À la carte</h3>\n<p>Nucleus Kit is a convenience, not a requirement. If you find you are not using\nmost of its elements, install the packages you do use individually and drop it:</p>\n<include-content data-language=\"sh\"><template>npm install @excom/quark-sheet @excom/provider-fetch @excom/content-drawer</template></include-content>\n<include-content data-language=\"js\"><template>import \"@excom/quark-sheet\";\nimport \"@excom/provider-fetch\";\nimport \"@excom/content-drawer\";</template></include-content>\n<p>Each package is self-contained — same elements, same versions, same CSS hooks —\nand its README documents the slim install. Valence.css is <code>@excom/valence</code>.</p>\n<h3 id=\"md-what-39-s-included\">What&#39;s included</h3>\n<p><strong>Core</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/neutron\" role=\"link\"><code>neutron</code></spa-a> — custom element factory</li>\n<li><spa-a route-href=\"/nucleus/packages/quark\" role=\"link\"><code>quark</code></spa-a> / <spa-a route-href=\"/nucleus/packages/quark-sheet\" role=\"link\"><code>quark-sheet</code></spa-a> — DOM\norchestration</li>\n<li><spa-a route-href=\"/nucleus/packages/valence\" role=\"link\"><code>valence</code></spa-a> — Valence.css, semantic CSS (via <code>basic.css</code>)</li>\n</ul>\n<p><strong>Layout / chrome</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/content-carousel\" role=\"link\"><code>content-carousel</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/content-drawer\" role=\"link\"><code>content-drawer</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/content-tabs\" role=\"link\"><code>content-tabs</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/dialog-anchor\" role=\"link\"><code>dialog-anchor</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/dismiss-watcher\" role=\"link\"><code>dismiss-watcher</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/data-table\" role=\"link\"><code>data-table</code></spa-a></li>\n</ul>\n<p><strong>Content / routing</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/include-content\" role=\"link\"><code>include-content</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/spa-route\" role=\"link\"><code>spa-route</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/scroll-into-view\" role=\"link\"><code>scroll-into-view</code></spa-a></li>\n</ul>\n<p><strong>Forms / auth</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/super-form\" role=\"link\"><code>super-form</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/super-input\" role=\"link\"><code>super-input</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/web-authn\" role=\"link\"><code>web-authn</code></spa-a></li>\n</ul>\n<p><strong>Providers</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/provider-fetch\" role=\"link\"><code>provider-fetch</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/provider-geolocation\" role=\"link\"><code>provider-geolocation</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/provider-orientation\" role=\"link\"><code>provider-orientation</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/provider-storage\" role=\"link\"><code>provider-storage</code></spa-a></li>\n</ul>\n<p><strong>Platform</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/detect-browser\" role=\"link\"><code>detect-browser</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/detect-features\" role=\"link\"><code>detect-features</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/detect-media\" role=\"link\"><code>detect-media</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/dom-observer\" role=\"link\"><code>dom-observer</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/event-handler\" role=\"link\"><code>event-handler</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/gesture-handler\" role=\"link\"><code>gesture-handler</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/network-status\" role=\"link\"><code>network-status</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/service-worker\" role=\"link\"><code>service-worker</code></spa-a></li>\n</ul>\n<h3 id=\"md-not-in-nucleus-kit\">Not in Nucleus Kit</h3>\n<p>Install separately when needed: <code>mapbox-view</code>, <code>super-img</code>, element bases\n(<code>abortable-element</code>, <code>fetchable-element</code>, …), and editor tooling such as\n<spa-a route-href=\"/nucleus/packages/nucleus-quark-highlighter\" role=\"link\"><code>nucleus-quark-highlighter</code></spa-a>.</p>\n",
+  "docs": {
+    "breaking_changes": "<ul>\n<li>Renamed web-authn attrs</li>\n<li>Command-style events became native commands (2026-09-13): <code>provider-fetch-trigger</code> → <code>--fetch</code>; <code>super-form-trigger</code> / <code>web-authn-trigger</code> → <code>--submit</code>; <code>content-drawer-open</code> / <code>-close</code> / <code>-toggle</code> → <code>--open</code> / <code>--close</code> / <code>--toggle</code> (per-open props from the invoker&#39;s <code>data-*</code>, not <code>detail</code>); <code>content-carousel-next</code> / <code>-back</code> → <code>--next</code> / <code>--back</code>; <code>include-content-reload</code> / <code>spa-route-reload</code> / <code>quark-sheet-reload</code> → <code>--reload</code>; <code>provider-geolocation-request</code> / <code>provider-orientation-request</code> → <code>--request</code>; <code>data-table-export</code> → <code>--export</code> (options as <code>data-file-type</code> / <code>data-file-name</code> / <code>data-full</code> on the invoker); <code>data-table-filter</code> removed — write <code>filter-value</code> / <code>filter-casing</code>. Invoke with <code>&lt;button command=&quot;--verb&quot; commandfor=&quot;id&quot;&gt;</code>, <code>&lt;event-handler command-name=&quot;--verb&quot; target-ref=&quot;…&quot;&gt;</code>, <code>&lt;dismiss-watcher command-name=&quot;--close&quot;&gt;</code>, or <code>new CommandEvent()</code>.</li>\n</ul>\n",
+    "readme": "<h1 id=\"md-nucleus-kit\">Nucleus Kit</h1>\n<p>The whole Nucleus Stack in one package — every element, provider, Quark, and Valence.css behind a single import.</p>\n<h2 id=\"md-features\">Features</h2>\n<ul>\n<li><strong>One JS import</strong> Registers every Nucleus Kit element</li>\n<li><strong>One CSS import</strong> Valence.css theme + shared element styles (<code>basic.css</code>)</li>\n<li><strong>App-ready</strong> Routing, sheets, forms, drawers, providers, and more</li>\n<li><strong>À la carte</strong> Every package is published on its own; if you only use a few elements, install just those</li>\n</ul>\n<h2 id=\"md-installation\">Installation</h2>\n<p><include-content is-active template-ref=\"/views/install-section/install-section.html\"></include-content></p>\n<h2 id=\"md-usage\">Usage</h2>\n<include-content data-language=\"js\"><template>import \"@excom/nucleus-kit\";</template></include-content>\n<include-content data-language=\"css\"><template>@import \"@excom/nucleus-kit/basic.css\";</template></include-content>\n<p>That loads Valence.css (<code>basic</code> theme) plus element CSS and registers the\npackages below.</p>\n<h3 id=\"md-progressive-bundle-experimental\">Progressive bundle (experimental)</h3>\n<p><code>nucleus-kit.progressive.min.js</code> registers nothing up front. It watches the\ndocument for Nucleus Kit element tags and imports each element&#39;s package the\nfirst time its tag appears (initial scan, then every inserted subtree), so a\npage pays only for the elements it uses. Packages shared by several elements\n(<code>neutron</code>, <code>kit-utils</code>, <code>quark</code>, the element bases) are separate chunks\nunder <code>dist/progressive/</code>, fetched once. The entry is 3 kB; a page using\n<code>quark-sheet</code> and <code>content-drawer</code> loads ~55 kB gzip less than the all-in\nbuild.</p>\n<include-content data-language=\"html\"><template>&lt;script type=\"module\" src=\"/node_modules/@excom/nucleus-kit/nucleus-kit.progressive.min.js\"&gt;&lt;/script&gt;</template></include-content>\n<p>Trade-offs: elements upgrade one network round-trip later (style the\npre-upgrade state with <code>:not(:defined)</code>), it is ES modules only, and elements\ninside a shadow root need <code>observeElements(shadowRoot)</code> from the same module.\nThe all-in <code>index.umd.min.js</code> and the ESM <code>index.js</code> are unchanged.</p>\n<h3 id=\"md-la-carte\">À la carte</h3>\n<p>Nucleus Kit is a convenience, not a requirement. If you find you are not using\nmost of its elements, install the packages you do use individually and drop it:</p>\n<include-content data-language=\"sh\"><template>npm install @excom/quark-sheet @excom/provider-fetch @excom/content-drawer</template></include-content>\n<include-content data-language=\"js\"><template>import \"@excom/quark-sheet\";\nimport \"@excom/provider-fetch\";\nimport \"@excom/content-drawer\";</template></include-content>\n<p>Each package is self-contained — same elements, same versions, same CSS hooks —\nand its README documents the slim install. Valence.css is <code>@excom/valence</code>.</p>\n<h3 id=\"md-what-39-s-included\">What&#39;s included</h3>\n<p><strong>Core</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/neutron\" role=\"link\"><code>neutron</code></spa-a> — custom element factory</li>\n<li><spa-a route-href=\"/nucleus/packages/quark\" role=\"link\"><code>quark</code></spa-a> / <spa-a route-href=\"/nucleus/packages/quark-sheet\" role=\"link\"><code>quark-sheet</code></spa-a> — DOM\norchestration</li>\n<li><spa-a route-href=\"/nucleus/packages/valence\" role=\"link\"><code>valence</code></spa-a> — Valence.css, semantic CSS (via <code>basic.css</code>)</li>\n</ul>\n<p><strong>Layout / chrome</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/content-carousel\" role=\"link\"><code>content-carousel</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/content-drawer\" role=\"link\"><code>content-drawer</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/content-tabs\" role=\"link\"><code>content-tabs</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/dialog-anchor\" role=\"link\"><code>dialog-anchor</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/dismiss-watcher\" role=\"link\"><code>dismiss-watcher</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/data-table\" role=\"link\"><code>data-table</code></spa-a></li>\n</ul>\n<p><strong>Content / routing</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/include-content\" role=\"link\"><code>include-content</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/spa-route\" role=\"link\"><code>spa-route</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/scroll-into-view\" role=\"link\"><code>scroll-into-view</code></spa-a></li>\n</ul>\n<p><strong>Forms / auth</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/super-form\" role=\"link\"><code>super-form</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/super-input\" role=\"link\"><code>super-input</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/web-authn\" role=\"link\"><code>web-authn</code></spa-a></li>\n</ul>\n<p><strong>Providers</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/provider-fetch\" role=\"link\"><code>provider-fetch</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/provider-geolocation\" role=\"link\"><code>provider-geolocation</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/provider-orientation\" role=\"link\"><code>provider-orientation</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/provider-storage\" role=\"link\"><code>provider-storage</code></spa-a></li>\n</ul>\n<p><strong>Platform</strong></p>\n<ul>\n<li><spa-a route-href=\"/nucleus/packages/detect-browser\" role=\"link\"><code>detect-browser</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/detect-features\" role=\"link\"><code>detect-features</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/detect-media\" role=\"link\"><code>detect-media</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/dom-observer\" role=\"link\"><code>dom-observer</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/event-handler\" role=\"link\"><code>event-handler</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/gesture-handler\" role=\"link\"><code>gesture-handler</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/network-status\" role=\"link\"><code>network-status</code></spa-a></li>\n<li><spa-a route-href=\"/nucleus/packages/service-worker\" role=\"link\"><code>service-worker</code></spa-a></li>\n</ul>\n<h3 id=\"md-not-in-nucleus-kit\">Not in Nucleus Kit</h3>\n<p>Install separately when needed: <code>mapbox-view</code>, <code>super-img</code>, element bases\n(<code>abortable-element</code>, <code>fetchable-element</code>, …), and editor tooling such as\n<spa-a route-href=\"/nucleus/packages/nucleus-quark-highlighter\" role=\"link\"><code>nucleus-quark-highlighter</code></spa-a>.</p>\n"
+  },
+  "installation": {
+    "name": "@excom/nucleus-kit",
+    "shortName": "nucleus-kit",
+    "version": "0.1.0",
+    "description": "The whole Nucleus Stack in one package — elements, Quark, Valence.css",
+    "packageType": "library",
+    "install": {
+      "npm": "npm install @excom/nucleus-kit"
+    },
+    "imports": {
+      "js": "import \"@excom/nucleus-kit\";",
+      "css": "@import \"@excom/nucleus-kit/basic.css\";"
+    },
+    "peerDependencies": []
+  },
+  "elementApis": [],
+  "exportedFiles": {}
+}

package/support/tests/loop-guard.test.ts

@@ -0,0 +1,92 @@
+/**
+ * Cross-package loop: an event-emitting Adapter (`dom-observer`) and a Quark
+ * `@on` block that writes the attribute the Adapter observes. Every hop is
+ * asynchronous (MutationObserver → event → deferred paint), so only the
+ * shared loop guard's address-carried depth can see it as one chain.
+ */
+import "../../index";
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  fixture,
+  it,
+  wait,
+} from "@excom/heft-rig/profiles/default/config/test-utils";
+import { LoopGuard, type LoopGuardTrip } from "@excom/kit-utils";
+
+describe("nucleus-kit: loop guard across elements and Quark", () => {
+  let trips: LoopGuardTrip[];
+  let off: () => void;
+
+  beforeEach(() => {
+    LoopGuard.reset();
+    LoopGuard.configure({ limit: 6, log: () => {} });
+    trips = [];
+    off = LoopGuard.onTrip((trip) => trips.push(trip));
+  });
+
+  afterEach(() => {
+    off();
+    LoopGuard.reset();
+    document.body.innerHTML = "";
+  });
+
+  const settle = async (done: () => boolean, ticks = 400) => {
+    for (let i = 0; i < ticks && !done(); i++) await wait(0);
+  };
+
+  it("cuts an attribute → event → @on block → attribute cycle", async () => {
+    const root = fixture<HTMLElement>(
+      `<section>
+        <quark-sheet>
+          dom-observer {
+            @on dom-observer-change {
+              #box { data-n: attr("data-n") + "x"; }
+            }
+          }
+        </quark-sheet>
+        <dom-observer target-ref="#box"><div id="box" data-n=""></div></dom-observer>
+      </section>`
+    );
+    const box = root.querySelector("#box")!;
+    await wait(0);
+    await wait(0);
+    // kick the cycle from outside: one mutation → change event → block
+    // writes `data-n` → another mutation → …
+    box.setAttribute("data-n", "start");
+    await settle(() => trips.length > 0);
+    expect(trips.length).toBeGreaterThanOrEqual(1);
+    expect(trips[0]).toMatchObject({ kind: "depth", target: box, name: "data-n" });
+    const value = box.getAttribute("data-n")!;
+    expect(value.length).toBeLessThanOrEqual("start".length + LoopGuard.limit);
+    // dead: nothing changes any more
+    for (let i = 0; i < 10; i++) await wait(0);
+    expect(box.getAttribute("data-n")).toBe(value);
+  });
+
+  it("does not trip when each change is an external one", async () => {
+    const root = fixture<HTMLElement>(
+      `<section>
+        <quark-sheet>
+          dom-observer {
+            @on dom-observer-change {
+              #box { data-seen: attr("data-n"); }
+            }
+          }
+        </quark-sheet>
+        <dom-observer target-ref="#box"><div id="box" data-n=""></div></dom-observer>
+      </section>`
+    );
+    const box = root.querySelector("#box")!;
+    await wait(0);
+    await wait(0);
+    for (let i = 1; i <= 10; i++) {
+      box.setAttribute("data-n", String(i));
+      await settle(() => box.getAttribute("data-seen") === String(i), 40);
+    }
+    expect(box.getAttribute("data-seen")).toBe("10");
+    expect(trips).toEqual([]);
+  });
+});

package/support/tests/nucleus-kit.test.ts

@@ -0,0 +1,19 @@
+import "../../index";
+import {
+  afterEach,
+  describe,
+  expect,
+  it,
+} from "@excom/heft-rig/node_modules/vitest";
+
+describe("nucleus-kit", () => {
+  afterEach(() => {
+    document.body.innerHTML = "";
+  });
+
+  it("registers a few shared elements", () => {
+    expect(customElements.get("content-drawer")).toBeTruthy();
+    expect(customElements.get("detect-browser")).toBeTruthy();
+    expect(customElements.get("dom-observer")).toBeTruthy();
+  });
+});

package/support/tests/progressive.test.ts

@@ -0,0 +1,129 @@
+/**
+ * The progressive entry: nothing registered up front, each package imported
+ * the first time one of its tags appears in the document.
+ */
+import {
+  loadElement,
+  observeElements,
+  PROGRESSIVE_LOADERS,
+  PROGRESSIVE_TAGS,
+} from "../../nucleus-kit.progressive";
+import {
+  afterEach,
+  describe,
+  expect,
+  it,
+  vi,
+  wait,
+} from "@excom/heft-rig/profiles/default/config/test-utils";
+
+const settle = async () => {
+  await wait(0);
+  await wait(0);
+};
+
+describe("nucleus-kit progressive entry", () => {
+  afterEach(() => {
+    document.body.innerHTML = "";
+    vi.restoreAllMocks();
+  });
+
+  it("covers every tag Nucleus Kit defines", () => {
+    expect([...PROGRESSIVE_TAGS].sort()).toEqual(
+      [
+        "content-carousel",
+        "content-carousel-slide",
+        "content-drawer",
+        "content-tabs",
+        "content-tabs-body",
+        "content-tabs-header",
+        "data-table",
+        "data-th",
+        "detect-browser",
+        "detect-features",
+        "detect-media",
+        "dialog-anchor",
+        "dismiss-watcher",
+        "dom-observer",
+        "event-handler",
+        "gesture-handler",
+        "include-content",
+        "network-status",
+        "provider-fetch",
+        "provider-geolocation",
+        "provider-orientation",
+        "provider-storage",
+        "quark-sheet",
+        "scroll-into-view",
+        "service-worker",
+        "spa-a",
+        "spa-manager",
+        "spa-route",
+        "super-form",
+        "super-input",
+        "web-authn",
+      ].sort()
+    );
+    // sub-adapters share their parent's loader so a family is one import
+    expect(PROGRESSIVE_LOADERS["content-tabs-header"]).toBe(PROGRESSIVE_LOADERS["content-tabs"]);
+    expect(PROGRESSIVE_LOADERS["spa-a"]).toBe(PROGRESSIVE_LOADERS["spa-route"]);
+  });
+
+  it("defines every tag it maps", async () => {
+    await Promise.all(PROGRESSIVE_TAGS.map((tag) => loadElement(tag)));
+    for (const tag of PROGRESSIVE_TAGS) {
+      expect(customElements.get(tag), tag).toBeDefined();
+    }
+  });
+
+  it("loads a package once on demand and defines its elements", async () => {
+    const first = loadElement("content-drawer");
+    expect(loadElement("content-drawer")).toBe(first);
+    await first;
+    expect(customElements.get("content-drawer")).toBeDefined();
+    expect(loadElement("not-a-kit-tag")).toBeUndefined();
+  });
+
+  it("loads elements inserted into the document, including nested ones", async () => {
+    document.body.innerHTML = `<div>text <section><super-form></super-form></section></div>`;
+    document.body.appendChild(document.createTextNode("loose text"));
+    await settle();
+    await loadElement("super-form");
+    expect(customElements.get("super-form")).toBeDefined();
+
+    const el = document.createElement("dialog-anchor");
+    document.body.appendChild(el);
+    await settle();
+    await loadElement("dialog-anchor");
+    expect(customElements.get("dialog-anchor")).toBeDefined();
+  });
+
+  it("observes a shadow root on request and stops when disposed", async () => {
+    const host = document.createElement("div");
+    const shadow = host.attachShadow({ mode: "open" });
+    shadow.innerHTML = `<network-status></network-status>`;
+    document.body.appendChild(host);
+    const stop = observeElements(shadow);
+    await loadElement("network-status");
+    expect(customElements.get("network-status")).toBeDefined();
+    stop();
+    const spy = vi.spyOn(PROGRESSIVE_LOADERS as Record<string, () => Promise<unknown>>, "scroll-into-view");
+    shadow.appendChild(document.createElement("scroll-into-view"));
+    await settle();
+    expect(spy).not.toHaveBeenCalled();
+  });
+
+  it("logs a failed import and retries on the next call", async () => {
+    const error = vi.spyOn(console, "error").mockImplementation(() => {});
+    let attempts = 0;
+    (PROGRESSIVE_LOADERS as Record<string, () => Promise<unknown>>)["x-broken"] = () => {
+      attempts++;
+      return attempts === 1 ? Promise.reject(new Error("nope")) : Promise.resolve("ok");
+    };
+    await expect(loadElement("x-broken")).rejects.toThrow("nope");
+    expect(error).toHaveBeenCalledWith("[nucleus-kit] failed to load <x-broken>", expect.any(Error));
+    await expect(loadElement("x-broken")).resolves.toBe("ok");
+    expect(attempts).toBe(2);
+    delete (PROGRESSIVE_LOADERS as Record<string, unknown>)["x-broken"];
+  });
+});

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "@excom/heft-rig/profiles/default/config/tsconfig.json",
+  "include": ["./*.ts"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}