neba 1.9.0 → 1.10.0

package/dist/types.d.ts

@@ -482,3 +482,42 @@ export interface NebaStyleProps {
     /** @default 'default' */
     density?: NebaDensity;
 }
+/**
+ * Class names for the parts of a component that its `className` cannot reach.
+ *
+ * A component that draws one element needs none of this: `className` lands on
+ * that element and there is nothing else to say. A component that draws six —
+ * a field with a label, a shell, a control and two lines of text under it — has
+ * five parts a caller can see, can want to change, and has no way to name. That
+ * is what this is for, and it is the whole of what it is for.
+ *
+ * **There is never a `root` key.** `className` is the root, on every component
+ * in the library, and a `classNames.root` beside it would be a second spelling
+ * of an idea that already has one. The rule that keeps `size` meaning one thing
+ * applies here too.
+ *
+ * A slot name is a promise about the element behind it, so the union each
+ * component declares is deliberately short. Only parts that are *structurally*
+ * there — a label is a label whatever the field is — get a name; the wrappers
+ * that exist to hold a flex direction do not, because naming one freezes a
+ * layout decision into the public API.
+ */
+export type NebaSlots<Slot extends string> = Partial<Record<Slot, string>>;
+/**
+ * The parts every field-shaped component draws, and the reason they are one
+ * type: a `classNames.label` has to mean the label on a TextField, a Select, a
+ * Checkbox and a RadioGroup alike, exactly as a `size` of `md` means one height
+ * everywhere.
+ *
+ * - `label` — the field's own name, above it or beside it.
+ * - `control` — the thing the reader actually operates: the `<input>`, the
+ *   trigger, the tick, the track.
+ * - `description` — the helper line under it.
+ * - `error` — the message that replaces it when the field is invalid.
+ *
+ * Four rather than more, because these four are the ones that exist on all of
+ * them. A shell around the control, a popup, a chip — those are real parts, but
+ * only some fields have them, and a slot offered on a component that cannot
+ * draw it is a slot that does nothing.
+ */
+export type NebaFieldSlot = 'label' | 'control' | 'description' | 'error';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neba",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "A comprehensive React UI component library — buttons, fields, menus, dialogs, tables and much more — accessible and themeable, sharing one prop vocabulary and a translucent acrylic design language. ESM only, types included, dark mode built in.",
   "type": "module",
   "types": "dist/index.d.ts",