@adia-ai/web-modules 0.5.8 → 0.5.10

package/CHANGELOG.md

@@ -10,6 +10,32 @@ Built from `@adia-ai/web-components` primitives.
 
 _No pending changes._
 
+## [0.5.10] - 2026-05-15
+
+_Lockstep ride-along (no source change)._
+
+
+## [0.5.9] - 2026-05-15
+
+### Added — §226 (v0.5.9) — `package.json` `exports` map nested-CSS sweep × 6 clusters
+
+
+`packages/web-modules/package.json` `exports` map gains 12 new entries (2 per cluster × 6 clusters: shell + chat + editor + simple + runtime + theme). Each cluster now accepts three specifier shapes parallel to v0.5.7 §204 fix on `@adia-ai/web-components`:
+
+```json
+"./<cluster>/*.css": "./<cluster>/*/*.css",            // existing
+"./<cluster>/*/*.css": "./<cluster>/*/*.css",           // NEW (nested-path mirroring JS)
+"./<cluster>/*/css/*.css": "./<cluster>/*/css/*.css"    // NEW (sub-stylesheets — editor-shell.{layout,tokens,bespoke}.css etc.)
+```
+
+Editor-shell sub-stylesheets (`editor-shell.layout.css` / `editor-shell.tokens.css` / `editor-shell.bespoke.css`) now have reachable import paths via the natural-shape specifier. Closes FEEDBACK-18 §1.
+
+### Audit ride-along — §227 (v0.5.9) — `check-styles-barrel-completeness.mjs --package=web-modules` parity audit
+
+Companion mechanical-protection for the §226 fix. `scripts/release/check-styles-barrel-completeness.mjs` graduates a `--package=web-modules` flag that walks all 6 clusters + verifies every `*.css` file under `<cluster>/<elem>/` (and `<cluster>/<elem>/css/`) matches one of the three export-map patterns. Closes the second half of drift surface #3 in the 7-surface lockdown taxonomy.
+
+No web-modules source changes from §227 — the audit lives in `@adia-ai/web-components` but enforces a property on this package.
+
 ## [0.5.8] - 2026-05-15
 
 _Lockstep ride-along (no source change)._

package/chat/chat-composer/chat-composer.d.ts

@@ -17,7 +17,7 @@ code should prefer <chat-composer>.
  * @see https://ui-kit.exe.xyz/site/components/chat-composer
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -32,7 +32,7 @@ export interface ChatComposerComposerSubmitEventDetail {
 
 export type ChatComposerComposerSubmitEvent = CustomEvent<ChatComposerComposerSubmitEventDetail>;
 
-export class UIChatComposer extends UIElement {
+export class ChatComposer extends UIElement {
   /** Reflected — set by the host while streaming, or by application
 code. Propagated to the inner input element automatically.
  */
@@ -40,7 +40,7 @@ code. Propagated to the inner input element automatically.
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIChatComposer, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: ChatComposer, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'composer-submit', listener: (ev: ChatComposerComposerSubmitEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/chat/chat-shell/chat-shell.d.ts

@@ -9,7 +9,7 @@ rendering, code-block upgrades, and an LLM integration path via proxy-url
  * @see https://ui-kit.exe.xyz/site/components/chat-shell
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -56,7 +56,7 @@ export interface ChatShellThinkingEventDetail {
 
 export type ChatShellThinkingEvent = CustomEvent<ChatShellThinkingEventDetail>;
 
-export class UIChatShell extends UIElement {
+export class ChatShell extends UIElement {
   /** Model identifier. */
   model: string;
   /** LLM provider name (anthropic | openai | google | stub). */
@@ -72,7 +72,7 @@ export class UIChatShell extends UIElement {
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIChatShell, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: ChatShell, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'abort', listener: (ev: ChatShellAbortEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/chat/chat-sidebar/chat-sidebar.d.ts

@@ -15,7 +15,7 @@ inspector rails.
  * @see https://ui-kit.exe.xyz/site/components/chat-sidebar
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -36,7 +36,7 @@ export interface ChatSidebarSidebarToggleEventDetail {
 
 export type ChatSidebarSidebarToggleEvent = CustomEvent<ChatSidebarSidebarToggleEventDetail>;
 
-export class UIChatSidebar extends UIElement {
+export class ChatSidebar extends UIElement {
   /** Reflected — set when the sidebar's measured width is at or below
 96px. Consumers query this to style "collapsed mode" without
 duplicating threshold math.
@@ -62,7 +62,7 @@ Useful for suppressing transitions while dragging.
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIChatSidebar, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: ChatSidebar, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'sidebar-resize', listener: (ev: ChatSidebarSidebarResizeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/chat/chat-thread/chat-thread.d.ts

@@ -17,7 +17,7 @@ should prefer <chat-thread>.
  * @see https://ui-kit.exe.xyz/site/components/chat-thread
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -25,7 +25,7 @@ should prefer <chat-thread>.
 
 import { UIElement } from '../../../web-components/core/element.js';
 
-export class UIChatThread extends UIElement {
+export class ChatThread extends UIElement {
   /** Reflected — set when zero message children. Drives the
 <chat-empty> visibility via CSS — no JS toggling needed.
  */

package/editor/editor-canvas/editor-canvas.d.ts

@@ -19,7 +19,7 @@ Backwards compat — <editor-shell> still recognizes the legacy
  * @see https://ui-kit.exe.xyz/site/components/editor-canvas
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -27,7 +27,7 @@ Backwards compat — <editor-shell> still recognizes the legacy
 
 import { UIElement } from '../../../web-components/core/element.js';
 
-export class UIEditorCanvas extends UIElement {
+export class EditorCanvas extends UIElement {
   /** Reflected — set when zero non-<editor-canvas-empty> children.
 Drives the <editor-canvas-empty> visibility via parent CSS —
 no JS toggling needed.

package/editor/editor-shell/editor-shell.d.ts

@@ -9,7 +9,7 @@ select-ui[data-options] for JSON-parsed option lists.
  * @see https://ui-kit.exe.xyz/site/components/editor-shell
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -17,5 +17,5 @@ select-ui[data-options] for JSON-parsed option lists.
 
 import { UIElement } from '../../../web-components/core/element.js';
 
-export class UIEditorShell extends UIElement {
+export class EditorShell extends UIElement {
 }

package/editor/editor-sidebar/editor-sidebar.d.ts

@@ -20,7 +20,7 @@ drag at the primitive tier.
  * @see https://ui-kit.exe.xyz/site/components/editor-sidebar
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -35,7 +35,7 @@ export interface EditorSidebarSidebarToggleEventDetail {
 
 export type EditorSidebarSidebarToggleEvent = CustomEvent<EditorSidebarSidebarToggleEventDetail>;
 
-export class UIEditorSidebar extends UIElement {
+export class EditorSidebar extends UIElement {
   /** Reflected — set when inner <pane-ui> width is at or below 96px snap threshold. */
   collapsed: boolean;
   /** Alias for [persist]; kept for v0.4.x back-compat. Deprecated —
@@ -56,7 +56,7 @@ that would feel laggy during drag.
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIEditorSidebar, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: EditorSidebar, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'sidebar-toggle', listener: (ev: EditorSidebarSidebarToggleEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/editor/editor-toolbar/editor-toolbar.d.ts

@@ -12,7 +12,7 @@ via slot vocabulary. The host (<editor-shell>) reads either
  * @see https://ui-kit.exe.xyz/site/components/editor-toolbar
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -26,13 +26,13 @@ export interface EditorToolbarToolbarActionEventDetail {
 
 export type EditorToolbarToolbarActionEvent = CustomEvent<EditorToolbarToolbarActionEventDetail>;
 
-export class UIEditorToolbar extends UIElement {
+export class EditorToolbar extends UIElement {
   /** Reflected — set when editor is in distraction-free / focus mode. */
   fullScreen: boolean;
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIEditorToolbar, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: EditorToolbar, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'toolbar-action', listener: (ev: EditorToolbarToolbarActionEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-modules",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "AdiaUI composite custom elements — shell, chat, editor, runtime clusters built from @adia-ai/web-components primitives. Subpath exports per cluster.",
   "type": "module",
   "exports": {
@@ -8,9 +8,13 @@
     "./shell": "./shell/index.js",
     "./shell/*": "./shell/*/*.js",
     "./shell/*.css": "./shell/*/*.css",
+    "./shell/*/*.css": "./shell/*/*.css",
+    "./shell/*/css/*.css": "./shell/*/css/*.css",
     "./chat": "./chat/index.js",
     "./chat/*": "./chat/*/*.js",
     "./chat/*.css": "./chat/*/*.css",
+    "./chat/*/*.css": "./chat/*/*.css",
+    "./chat/*/css/*.css": "./chat/*/css/*.css",
     "./editor": {
       "types": "./editor/index.d.ts",
       "default": "./editor/index.js"
@@ -21,15 +25,23 @@
     },
     "./editor/*": "./editor/*/*.js",
     "./editor/*.css": "./editor/*/*.css",
+    "./editor/*/*.css": "./editor/*/*.css",
+    "./editor/*/css/*.css": "./editor/*/css/*.css",
     "./simple": "./simple/index.js",
     "./simple/*": "./simple/*/*.js",
     "./simple/*.css": "./simple/*/*.css",
+    "./simple/*/*.css": "./simple/*/*.css",
+    "./simple/*/css/*.css": "./simple/*/css/*.css",
     "./runtime": "./runtime/index.js",
     "./runtime/*": "./runtime/*/*.js",
     "./runtime/*.css": "./runtime/*/*.css",
+    "./runtime/*/*.css": "./runtime/*/*.css",
+    "./runtime/*/css/*.css": "./runtime/*/css/*.css",
     "./theme": "./theme/index.js",
     "./theme/*": "./theme/*/*.js",
     "./theme/*.css": "./theme/*/*.css",
+    "./theme/*/*.css": "./theme/*/*.css",
+    "./theme/*/css/*.css": "./theme/*/css/*.css",
     "./package.json": "./package.json"
   },
   "files": [

package/runtime/a2ui-root/a2ui-root.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/a2ui-root
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -19,7 +19,7 @@ export type A2UIRootA2uiErrorEvent = CustomEvent<unknown>;
 export type A2UIRootA2uiMessageEvent = CustomEvent<unknown>;
 export type A2UIRootDocReplacedEvent = CustomEvent<unknown>;
 
-export class UIA2UIRoot extends UIElement {
+export class A2UIRoot extends UIElement {
   /** True while the stream is connected and receiving messages. */
   active: boolean;
   /** Batch renderer updates via requestAnimationFrame for large fan-in. */
@@ -35,7 +35,7 @@ export class UIA2UIRoot extends UIElement {
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIA2UIRoot, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: A2UIRoot, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'a2ui-action', listener: (ev: A2UIRootA2uiActionEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/runtime/gen-root/gen-root.d.ts

@@ -7,7 +7,7 @@ child chat-ui, canvas-ui, and inspector-ui elements.
  * @see https://ui-kit.exe.xyz/site/components/gen-root
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -15,7 +15,7 @@ child chat-ui, canvas-ui, and inspector-ui elements.
 
 import { UIElement } from '../../../web-components/core/element.js';
 
-export class UIGenRoot extends UIElement {
+export class GenRoot extends UIElement {
   /** Show the inspector pane (for debugging generated A2UI). */
   inspector: boolean;
   /** Layout mode — chat-only, 50/50 split, or canvas-only. */

package/shell/admin-command/admin-command.d.ts

@@ -14,7 +14,7 @@ legacy shape via :is() selector. New code should prefer <admin-command>.
  * @see https://ui-kit.exe.xyz/site/components/admin-command
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -28,7 +28,7 @@ export interface AdminCommandCommandSelectEventDetail {
 
 export type AdminCommandCommandSelectEvent = CustomEvent<AdminCommandCommandSelectEventDetail>;
 
-export class UIAdminCommand extends UIElement {
+export class AdminCommand extends UIElement {
   /** Reflected — set while the dialog is showing. Synced with both
 programmatic .show()/.hide() and native dialog close events
 (esc key, backdrop click).
@@ -43,7 +43,7 @@ cross-platform Cmd+K affordance.
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIAdminCommand, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: AdminCommand, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'command-select', listener: (ev: AdminCommandCommandSelectEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/shell/admin-shell/admin-shell.d.ts

@@ -8,7 +8,7 @@ dialog[data-command]); admin-shell binds the interactions.
  * @see https://ui-kit.exe.xyz/site/components/admin-shell
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -16,34 +16,34 @@ dialog[data-command]); admin-shell binds the interactions.
 
 import { UIElement } from '../../../web-components/core/element.js';
 
-export interface AppShellCommandSelectEventDetail {
+export interface AdminShellCommandSelectEventDetail {
   value: string;
 }
 
-export type AppShellCommandSelectEvent = CustomEvent<AppShellCommandSelectEventDetail>;
-export interface AppShellSidebarResizeEventDetail {
+export type AdminShellCommandSelectEvent = CustomEvent<AdminShellCommandSelectEventDetail>;
+export interface AdminShellSidebarResizeEventDetail {
   sidebar: string;
   width: string;
 }
 
-export type AppShellSidebarResizeEvent = CustomEvent<AppShellSidebarResizeEventDetail>;
-export interface AppShellSidebarToggleEventDetail {
+export type AdminShellSidebarResizeEvent = CustomEvent<AdminShellSidebarResizeEventDetail>;
+export interface AdminShellSidebarToggleEventDetail {
   expanded: string;
   sidebar: string;
 }
 
-export type AppShellSidebarToggleEvent = CustomEvent<AppShellSidebarToggleEventDetail>;
+export type AdminShellSidebarToggleEvent = CustomEvent<AdminShellSidebarToggleEventDetail>;
 
-export class UIAppShell extends UIElement {
+export class AdminShell extends UIElement {
   /** Layout variant — default is bordered surface; rounded softens edges; borderless removes the outer chrome. */
   mode: '' | 'rounded' | 'borderless';
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIAppShell, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: AdminShell, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
-  addEventListener(type: 'command-select', listener: (ev: AppShellCommandSelectEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener(type: 'sidebar-resize', listener: (ev: AppShellSidebarResizeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
-  addEventListener(type: 'sidebar-toggle', listener: (ev: AppShellSidebarToggleEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: 'command-select', listener: (ev: AdminShellCommandSelectEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: 'sidebar-resize', listener: (ev: AdminShellSidebarResizeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: 'sidebar-toggle', listener: (ev: AdminShellSidebarToggleEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
 }

package/shell/admin-sidebar/admin-sidebar.d.ts

@@ -13,7 +13,7 @@ shape via :is() selector for backwards compat. New code should prefer
  * @see https://ui-kit.exe.xyz/site/components/admin-sidebar
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -34,7 +34,7 @@ export interface AdminSidebarSidebarToggleEventDetail {
 
 export type AdminSidebarSidebarToggleEvent = CustomEvent<AdminSidebarSidebarToggleEventDetail>;
 
-export class UIAdminSidebar extends UIElement {
+export class AdminSidebar extends UIElement {
   /** Reflected — set when the sidebar's measured width is at or below
 96px. Consumers query this to style "collapsed mode" without
 duplicating threshold math.
@@ -60,7 +60,7 @@ Useful for suppressing transitions while dragging.
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIAdminSidebar, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: AdminSidebar, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'sidebar-resize', listener: (ev: AdminSidebarSidebarResizeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/simple/simple-shell/simple-shell.d.ts

@@ -15,7 +15,7 @@ thank-you pages, single-card flows (sign-in, password reset).
  * @see https://ui-kit.exe.xyz/site/components/simple-shell
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -23,7 +23,7 @@ thank-you pages, single-card flows (sign-in, password reset).
 
 import { UIElement } from '../../../web-components/core/element.js';
 
-export class UISimpleShell extends UIElement {
+export class SimpleShell extends UIElement {
   /** Reflected — vertically centers content in viewport. */
   centered: boolean;
 }

package/theme/theme-panel/theme-panel.d.ts

@@ -17,7 +17,7 @@ playgrounds/admin-shell/ — see docs/specs/theme-panel-module.md.
  * @see https://ui-kit.exe.xyz/site/components/theme-panel
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * run `npm run build:components`, then `npm run codegen:dts` to
  * regenerate; or hand-author this file fully if rich event types are
  * needed beyond what the yaml `events:` block can express.
@@ -35,7 +35,7 @@ export interface ThemePanelThemeChangeEventDetail {
 
 export type ThemePanelThemeChangeEvent = CustomEvent<ThemePanelThemeChangeEventDetail>;
 
-export class UIThemePanel extends UIElement {
+export class ThemePanel extends UIElement {
   /** Renders the density + radius slider block. Sliders bind to
 --a-density and --a-radius-k on the target element.
  */
@@ -70,7 +70,7 @@ regardless of whether themes.css has a matching block.
 
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
-    listener: (this: UIThemePanel, ev: HTMLElementEventMap[K]) => unknown,
+    listener: (this: ThemePanel, ev: HTMLElementEventMap[K]) => unknown,
     options?: boolean | AddEventListenerOptions,
   ): void;
   addEventListener(type: 'theme-change', listener: (ev: ThemePanelThemeChangeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;