@imfusion/web-ui 0.5.1-dev.21.g2accd17d → 0.5.1-dev.24.g5b275132

package/README.md

@@ -115,23 +115,28 @@ npm run git:config   # hooks path + rebase-only pull/merge
 These skills are shipped with a `/web-ui-dev-*` prefix, so to make their names identifiable and not pollute the skill
 namespace.
 
-| Skill                                     | What it does                                                                          |
-| ----------------------------------------- | ------------------------------------------------------------------------------------- |
-| `/web-ui-dev-getting-started`             | Interactive intro — gauges your experience, works out your goal, routes you.          |
-| `/web-ui-dev-start`                       | Starting ritual for any task: Jira context, `master` vs. a worktree, context summary. |
-| `/web-ui-dev-new-component`               | Scaffolds an architecture-compliant primitive (adapted or absorbed).                  |
-| `/web-ui-dev-update-component`            | Pointers to every file a prop, variant, or sub-component change touches.              |
-| `/web-ui-dev-design-component`            | Brand design pass for a component that works but isn't styled yet.                    |
-| `/web-ui-dev-story`                       | Author or update a Storybook story.                                                   |
-| `/web-ui-dev-commit`                      | Commit workflow: staged docs audit, CI-parity checks, house commit format.            |
-| `/web-ui-dev-audit-docs`                  | Audit docs against staged or recent changes for staleness, gaps, and drift.           |
-| `/web-ui-dev-audit-pass-through-defaults` | Check `@default` annotations on pass-through props against Base UI upstream.          |
-| `/web-ui-dev-teardown-worktree`           | Tear down a worktree, wherever it lives — merging its branch first or dropping it.    |
-| `/web-ui-dev-refresh-design-reference`    | Refresh the committed brand snapshots in `design/` from the Figma styleguide.         |
-| `/web-ui-dev-mcp`                         | Set up or recover Storybook, DevTools, Atlassian, or Figma MCP access.                |
+| Skill                                     | What it does                                                                                                            |
+| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `/web-ui-dev-getting-started`             | Interactive intro — gauges your experience, works out your goal, routes you.                                            |
+| `/web-ui-dev-start`                       | Starting ritual for any task: Jira context, `master` vs. a worktree, context summary.                                   |
+| `/web-ui-dev-new-component`               | Scaffolds an architecture-compliant primitive (adapted or absorbed).                                                    |
+| `/web-ui-dev-update-component`            | Pointers to every file a prop, variant, or sub-component change touches.                                                |
+| `/web-ui-dev-design-component`            | Brand design pass for a component that works but isn't styled yet.                                                      |
+| `/web-ui-dev-story`                       | Author or update a Storybook story.                                                                                     |
+| `/web-ui-dev-commit`                      | Commit workflow: changelog skill, staged docs audit, CI-parity checks, house commit format.                             |
+| `/web-ui-dev-changelog`                   | Generate and validate the required one-line CHANGELOG.md entry for a web-ui change, including direct commits to master. |
+| `/web-ui-dev-audit-docs`                  | Audit docs against staged or recent changes for staleness, gaps, and drift.                                             |
+| `/web-ui-dev-audit-pass-through-defaults` | Check `@default` annotations on pass-through props against Base UI upstream.                                            |
+| `/web-ui-dev-teardown-worktree`           | Tear down a worktree, wherever it lives — merging its branch first or dropping it.                                      |
+| `/web-ui-dev-refresh-design-reference`    | Refresh the committed brand snapshots in `design/` from the Figma styleguide.                                           |
+| `/web-ui-dev-mcp`                         | Set up or recover Storybook, DevTools, Atlassian, or Figma MCP access.                                                  |
 
 ## Releasing
 
+Release-facing changes are recorded as one-line entries in [`CHANGELOG.md`](./CHANGELOG.md) under `## [Unreleased]`. The
+commit workflow requires an entry for pull-request commits and direct commits to `master`, with only narrow mechanical
+exceptions.
+
 The published version is derived from git tags, not from `package.json`.
 
 The `version` field stays at `0.0.0` in the repository and he CI computes the real number with

package/dist/components/field/field.d.ts

@@ -0,0 +1,104 @@
+import { Field as FieldPrimitive } from '@base-ui/react/field';
+type UpstreamRoot = React.ComponentProps<typeof FieldPrimitive.Root>;
+type UpstreamItem = React.ComponentProps<typeof FieldPrimitive.Item>;
+type UpstreamLabel = React.ComponentProps<typeof FieldPrimitive.Label>;
+type UpstreamDescription = React.ComponentProps<typeof FieldPrimitive.Description>;
+type UpstreamControl = React.ComponentProps<typeof FieldPrimitive.Control>;
+type UpstreamError = React.ComponentProps<typeof FieldPrimitive.Error>;
+type UpstreamValidity = React.ComponentProps<typeof FieldPrimitive.Validity>;
+type RootProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "style"> & {
+    name?: string;
+    actionsRef?: UpstreamRoot["actionsRef"];
+    dirty?: boolean;
+    touched?: boolean;
+    /** @default false */
+    disabled?: boolean;
+    invalid?: boolean;
+    validate?: UpstreamRoot["validate"];
+    /** @default "onSubmit" */
+    validationMode?: UpstreamRoot["validationMode"];
+    /** @default 0 */
+    validationDebounceTime?: number;
+    className?: UpstreamRoot["className"];
+    style?: UpstreamRoot["style"];
+    render?: UpstreamRoot["render"];
+};
+/**
+ * Field.Root — groups a label, control, validation state, and supporting copy.
+ *
+ * @doc https://base-ui.com/react/components/field
+ * @llm https://base-ui.com/react/components/field.md
+ */
+export declare function Root({ className, ...props }: RootProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Root {
+    var displayName: string;
+}
+type ItemProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "style"> & {
+    /** @default false */
+    disabled?: boolean;
+    className?: UpstreamItem["className"];
+    style?: UpstreamItem["style"];
+    render?: UpstreamItem["render"];
+};
+/** Field.Item — groups one checkable option with its label and description. */
+export declare function Item({ className, ...props }: ItemProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Item {
+    var displayName: string;
+}
+type LabelProps = Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "className" | "style"> & {
+    /** @default true */
+    nativeLabel?: boolean;
+    className?: UpstreamLabel["className"];
+    style?: UpstreamLabel["style"];
+    render?: UpstreamLabel["render"];
+};
+/** Field.Label — an accessible label automatically associated with the control. */
+export declare function Label({ className, ...props }: LabelProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Label {
+    var displayName: string;
+}
+type DescriptionProps = Omit<React.HTMLAttributes<HTMLParagraphElement>, "className" | "style"> & {
+    className?: UpstreamDescription["className"];
+    style?: UpstreamDescription["style"];
+    render?: UpstreamDescription["render"];
+};
+/** Field.Description — supporting information for a field. */
+export declare function Description({ className, ...props }: DescriptionProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Description {
+    var displayName: string;
+}
+type ControlProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, "className" | "style" | "defaultValue"> & {
+    defaultValue?: UpstreamControl["defaultValue"];
+    onValueChange?: UpstreamControl["onValueChange"];
+    className?: UpstreamControl["className"];
+    style?: UpstreamControl["style"];
+    render?: UpstreamControl["render"];
+};
+/** Field.Control — a native input control with Field labeling and validation. */
+export declare function Control({ className, ...props }: ControlProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Control {
+    var displayName: string;
+}
+type ErrorProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "style"> & {
+    match?: UpstreamError["match"];
+    className?: UpstreamError["className"];
+    style?: UpstreamError["style"];
+    render?: UpstreamError["render"];
+};
+/** Field.Error — an inline validation message shown when its match condition fails. */
+export declare function Error({ className, ...props }: ErrorProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Error {
+    var displayName: string;
+}
+type ValidityProps = {
+    children: UpstreamValidity["children"];
+};
+/**
+ * Field.Validity — renderless access to the field validity data for custom messages.
+ * Its function child owns the rendered element and therefore its identity and styling.
+ */
+export declare function Validity({ children }: ValidityProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Validity {
+    var displayName: string;
+}
+export {};

package/dist/components/field/field.meta.d.ts

@@ -0,0 +1,2 @@
+import { ComponentMeta } from '../../types/meta';
+export declare const fieldMeta: ComponentMeta;

package/dist/components/field/index.d.ts

@@ -0,0 +1,2 @@
+export * as Field from './field';
+export { fieldMeta } from './field.meta';

package/dist/components/fieldset/fieldset.d.ts

@@ -0,0 +1,29 @@
+import { Fieldset as FieldsetPrimitive } from '@base-ui/react/fieldset';
+type UpstreamRoot = React.ComponentProps<typeof FieldsetPrimitive.Root>;
+type UpstreamLegend = React.ComponentProps<typeof FieldsetPrimitive.Legend>;
+type RootProps = Omit<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, "className" | "style"> & {
+    className?: UpstreamRoot["className"];
+    style?: UpstreamRoot["style"];
+    render?: UpstreamRoot["render"];
+};
+/**
+ * Fieldset.Root — semantic grouping for related form controls and a shared legend.
+ *
+ * @doc https://base-ui.com/react/components/fieldset
+ * @llm https://base-ui.com/react/components/fieldset.md
+ */
+export declare function Root({ className, ...props }: RootProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Root {
+    var displayName: string;
+}
+type LegendProps = Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "style"> & {
+    className?: UpstreamLegend["className"];
+    style?: UpstreamLegend["style"];
+    render?: UpstreamLegend["render"];
+};
+/** Fieldset.Legend — the accessible label for its related controls. */
+export declare function Legend({ className, ...props }: LegendProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Legend {
+    var displayName: string;
+}
+export {};

package/dist/components/fieldset/fieldset.meta.d.ts

@@ -0,0 +1,2 @@
+import { ComponentMeta } from '../../types/meta';
+export declare const fieldsetMeta: ComponentMeta;

package/dist/components/fieldset/index.d.ts

@@ -0,0 +1,2 @@
+export * as Fieldset from './fieldset';
+export { fieldsetMeta } from './fieldset.meta';

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { Button, buttonMeta } from './components/button';
 export { ChipLink, chipLinkMeta } from './components/chip-link';
 export { CopyButton, copyButtonMeta } from './components/copy-button';
 export { Checkbox, checkboxMeta } from './components/checkbox';
+export { Field, fieldMeta } from './components/field';
+export { Fieldset, fieldsetMeta } from './components/fieldset';
 export { Input, inputMeta } from './components/input';
 export { Select, selectMeta } from './components/select';
 export { Slider, sliderMeta } from './components/slider';