@signal9/era-ui 21.0.0 → 23.0.0

package/dist/utils/index.d.ts

@@ -1,6 +1,6 @@
 import { type ClassValue } from 'clsx';
 import type { Snippet } from 'svelte';
-import type { WithoutChildrenOrChild } from 'bits-ui';
+import type { WithoutChildren, WithoutChildrenOrChild } from 'bits-ui';
 /**
  * Merges class lists with Tailwind conflict resolution (last wins).
  * Accepts Svelte's full `ClassValue` shape (strings, arrays, objects).
@@ -9,8 +9,41 @@ export declare function cn(...inputs: ClassValue[]): string;
 /** `tv` preconfigured with this library's tailwind-merge settings. */
 export declare const tv: import("tailwind-variants").TV;
 export type { VariantProps } from 'tailwind-variants';
-/** Props for a bits-ui part wrapper that renders its own `children`. */
-export type PartProps<T> = WithoutChildrenOrChild<T> & {
+/**
+ * Props for a bits-ui part that era only RESTYLES — it forwards `children` and
+ * adds classes, and renders no markup of its own.
+ *
+ * `child` is kept. It is bits-ui's escape hatch: the snippet receives the props
+ * the part would have rendered, and the caller renders their own element with
+ * them — a Trigger as an `<a>`, a Content as a custom component. era used to
+ * strip it from every part, which made the whole library strictly less capable
+ * than the primitives it wraps, for no reason on these 18: era contributes a
+ * class string, and bits-ui hands that class straight to the `child` snippet's
+ * props, so the escape hatch keeps era's styling on the way out. It already
+ * worked at runtime — `child` rode in on restProps and bits-ui checks it before
+ * `children` — so the only thing stopping anyone was this type.
+ *
+ * A part where era renders chrome of its own takes {@link OwnedPartProps}.
+ */
+export type PartProps<T> = WithoutChildren<T> & {
+    children?: Snippet;
+};
+/**
+ * Props for a bits-ui part whose markup era OWNS — a trigger that renders its
+ * own chevron, a content that renders its own overlay, a summary with a status
+ * spinner.
+ *
+ * `child` is withheld here, and the reason is that it cannot be honoured. The
+ * snippet replaces the element era was going to render, and era's extra markup
+ * lives INSIDE that element, so taking over rendering drops the chevron, the
+ * overlay or the indicator with no error and no visual clue — era's signature
+ * failure mode. Better to refuse it in the type than to accept it and quietly
+ * render something else.
+ *
+ * If you need the underlying element, reach for the primitive directly:
+ * `import { Select } from 'bits-ui'`. era wraps, it does not replace.
+ */
+export type OwnedPartProps<T> = WithoutChildrenOrChild<T> & {
     children?: Snippet;
 };
 export { hotkeys, keys, parseKeybinding, matchKeyBindingPress, createKeybindingsHandler, formatKeybinding, isApplePlatform, modKey, type KeyBindingMap, type KeyBindingPress, type KeyBindingOptions } from './hotkeys.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@signal9/era-ui",
-	"version": "21.0.0",
+	"version": "23.0.0",
 	"scripts": {
 		"dev": "vite dev --host",
 		"build": "vite build && npm run prepack",
@@ -25,10 +25,12 @@
 		"check:classes": "node --experimental-strip-types scripts/check-classes.ts",
 		"check:twmerge": "node --experimental-strip-types scripts/check-twmerge.ts",
 		"build:llm-docs": "node --experimental-strip-types scripts/build-llm-docs.ts",
-		"prebuild": "npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run build:llm-docs",
-		"validate": "npm run check && npm run lint && npm run format:check && npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens",
+		"prebuild": "npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run check:audit-controls && npm run check:specimen-coverage && npm run build:llm-docs",
+		"validate": "npm run check && npm run lint && npm run format:check && npm run check:surfaces && npm run check:tokens && npm run check:routes && npm run check:canonical && npm run check:layers && npm run check:themes && npm run check:classes && npm run check:twmerge && npm run check:doc-tokens && npm run check:audit-controls && npm run check:specimen-coverage",
 		"test": "npm run test:visual",
-		"check:doc-tokens": "node --experimental-strip-types scripts/check-doc-tokens.ts"
+		"check:doc-tokens": "node --experimental-strip-types scripts/check-doc-tokens.ts",
+		"check:audit-controls": "node --experimental-strip-types scripts/check-audit-controls.ts",
+		"check:specimen-coverage": "node --experimental-strip-types scripts/check-specimen-coverage.ts"
 	},
 	"files": [
 		"dist",