@slotted/react 0.0.0-stage → 0.1.0-beta.0

package/dist/types/field/field.types.d.ts

@@ -0,0 +1,249 @@
+import type { FamilyTranslator, FieldMessages, PartialMessages } from '@slotted/core/i18n';
+import type { AllHTMLAttributes, AriaAttributes, ComponentPropsWithRef, HTMLAttributes, ReactNode } from 'react';
+import type { InlineMessageProps } from '../inline-message';
+import type { TooltipChangeRequest, TooltipSide } from '../tooltip';
+/** The type step the field sits at, matching the control it wraps. */
+export type FieldSize = 'sm' | 'md' | 'lg';
+/**
+ * Where the label sits relative to the control. `side` reflows to `top` when
+ * the field's own inline size falls below 320 pixels, so a field in a drawer
+ * stacks while the same field in a page grid stays beside its control.
+ */
+export type FieldLabelPlacement = 'top' | 'side';
+/**
+ * How necessity is said. `mark` draws the asterisk every surveyed
+ * implementation draws on a required field; `optional` writes `(optional)` on
+ * the fields a reader may skip and nothing on the others, which is what GOV.UK
+ * and Carbon recommend for a form where most fields are required; `words`
+ * writes `(required)` on a required field and `(optional)` on one that is not;
+ * `none` says nothing, for a form where every field is required and the form
+ * says so once.
+ */
+export type FieldNecessity = 'mark' | 'optional' | 'words' | 'none';
+/**
+ * What a control tells the field about its own value, so the field can draw the
+ * count in the spare column of its label row. The control counts and the field
+ * places it: the number belongs to the value, and the row belongs to the field.
+ *
+ * `length` is in UTF-16 code units, which is what `maxLength` counts, so an
+ * emoji counts as two. A counter that disagreed with the limit the browser
+ * enforces would be wrong at exactly the moment it is read.
+ */
+export interface FieldCount {
+    length: number;
+    max: number | undefined;
+}
+/** The identifiers a field derives from one base. */
+export interface FieldIds {
+    control: string;
+    counter: string;
+    description: string;
+    error: string;
+    help: string;
+    indicator: string;
+    label: string;
+}
+/**
+ * The parts that join the control's `aria-describedby`, in the order the
+ * contract reads them: what qualifies the field, the help behind the icon, the
+ * description, the count, the error.
+ */
+export type FieldDescribedSlot = 'indicator' | 'help' | 'description' | 'counter' | 'error';
+/** What an application sets once for every field under it. */
+export interface FieldDefaults {
+    disabled: boolean | undefined;
+    labelPlacement: FieldLabelPlacement;
+    necessity: FieldNecessity;
+    readOnly: boolean | undefined;
+    size: FieldSize;
+}
+export interface FieldDefaultsProviderProps {
+    children?: ReactNode | undefined;
+    disabled?: boolean | undefined;
+    labelPlacement?: FieldLabelPlacement | undefined;
+    necessity?: FieldNecessity | undefined;
+    readOnly?: boolean | undefined;
+    size?: FieldSize | undefined;
+}
+/** What a field hands its label, its control, its messages and its counter. */
+export interface FieldContextValue {
+    /** What the control inside has published about its value, if anything. */
+    count: FieldCount | undefined;
+    describedBy: string | undefined;
+    disabled: boolean | undefined;
+    /** Whether the page wrote a counter of its own; the field then draws none. */
+    hasCounter: boolean;
+    /** Whether the page wrote a header; the header then draws the published count. */
+    hasHeader: boolean;
+    ids: FieldIds;
+    invalid: boolean | undefined;
+    messageSize: 'sm' | 'md';
+    necessity: FieldNecessity;
+    readOnly: boolean | undefined;
+    registerControl: () => void;
+    /**
+     * Whether the page wrote a counter of its own. It does, and the field draws
+     * none: a count the page computes — words, bytes, line items — is the only
+     * count the control cannot know.
+     */
+    registerCounter: (present: boolean) => void;
+    registerHeader: (present: boolean) => void;
+    registerMessage: (slot: FieldDescribedSlot, present: boolean) => void;
+    required: boolean | undefined;
+    /** Called by a control this library ships, whenever its value changes. */
+    setCount: (count: FieldCount | undefined) => void;
+    size: FieldSize;
+    /**
+     * The field's words in the language in force, with this field's `messages`
+     * laid over them: the necessity words and the help control's name.
+     */
+    t: FamilyTranslator<FieldMessages>;
+}
+/**
+ * What `render` receives. It is written against `HTMLAttributes<HTMLElement>`
+ * rather than against the element the part renders by default, because that is
+ * what makes substitution real: a props object typed for a `div` cannot be
+ * spread onto a `ul` or a `textarea`.
+ *
+ * `ref` is not among them. A consumer who substitutes the element writes the
+ * element, so they attach their own ref to it; `ref` on the component reaches
+ * the default element.
+ */
+export interface FieldRootProps extends HTMLAttributes<HTMLElement> {
+    'data-disabled'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-label-placement': FieldLabelPlacement;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-necessity': FieldNecessity;
+    'data-required'?: '' | undefined;
+    'data-size': FieldSize;
+    'data-ui': string;
+}
+export interface FieldProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
+    children?: ReactNode | undefined;
+    /**
+     * Unstated rather than `false`, so the field defers to its `FieldGroup` and
+     * the group to the application. Stated, it wins, and it is the native
+     * attribute on the control: removing it from the tab order and from
+     * submission is what the word means.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * The base every identifier is derived from — `<id>-control`, `<id>-label`,
+     * `<id>-description`, `<id>-error`. Generated with `useId` when unstated.
+     */
+    id?: string | undefined;
+    /** Unstated rather than `false`. Writes `aria-invalid` on the control. */
+    invalid?: boolean | undefined;
+    /** Defaults to the provider, then to `top`. */
+    labelPlacement?: FieldLabelPlacement | undefined;
+    /** Defaults to the provider, then to `mark`. */
+    necessity?: FieldNecessity | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * necessity words (`optional`, `required`) and the help control's name (`help`).
+     */
+    messages?: PartialMessages<FieldMessages> | undefined;
+    /** Unstated rather than `false`. Writes the native `readonly` on the control. */
+    readOnly?: boolean | undefined;
+    /**
+     * Unstated rather than `false`. Writes `aria-required` on the control and
+     * never the native `required`, which would engage browser constraint
+     * validation and change submit behaviour.
+     */
+    required?: boolean | undefined;
+    /** Renders the field into another element. */
+    render?: ((props: FieldRootProps) => ReactNode) | undefined;
+    /** Defaults to the provider, then to `md`. */
+    size?: FieldSize | undefined;
+}
+export interface FieldLabelRootProps extends HTMLAttributes<HTMLElement> {
+    'data-part': string;
+    htmlFor: string | undefined;
+}
+export interface FieldLabelProps extends ComponentPropsWithRef<'label'> {
+    render?: ((props: FieldLabelRootProps) => ReactNode) | undefined;
+}
+export interface FieldControlRootProps extends AllHTMLAttributes<HTMLElement> {
+    'aria-describedby': string | undefined;
+    'aria-invalid': AriaAttributes['aria-invalid'];
+    'aria-required': AriaAttributes['aria-required'];
+    'data-part': string;
+}
+export interface FieldControlProps extends ComponentPropsWithRef<'input'> {
+    render?: ((props: FieldControlRootProps) => ReactNode) | undefined;
+}
+/**
+ * The field's own message props. `id`, `size` and `disabled` come from the
+ * field and are not accepted here; everything else `inline-message` takes —
+ * `tone`, `live`, `mark`, `prefix`, `icon`, `hideIcon`, `reserve`, `render` —
+ * passes through, which is what makes a warning that does not block submission
+ * `tone="warning"` on the same part rather than a member of its own.
+ *
+ * `mark` is the one the field answers rather than passes: a field's messages
+ * draw no mark at all, so `none` is what they draw unless the page asks for
+ * `glyph` or `dot`.
+ */
+export type FieldMessageProps = Omit<InlineMessageProps, 'disabled' | 'id' | 'size'>;
+export interface FieldCounterRootProps extends HTMLAttributes<HTMLElement> {
+    'data-invalid'?: '' | undefined;
+    'data-part': string;
+    id: string | undefined;
+}
+export interface FieldCounterProps extends ComponentPropsWithRef<'span'> {
+    /**
+     * The count has passed its limit. It is the counter's own state rather than
+     * the field's: a count can pass its maximum while validation has not run, and
+     * a counter that only turned at submit would say nothing at the moment it is
+     * being read.
+     *
+     * Unstated, it is read from the count the control published, so a counter
+     * with no children needs nothing written on it at all.
+     */
+    invalid?: boolean | undefined;
+    render?: ((props: FieldCounterRootProps) => ReactNode) | undefined;
+}
+export interface FieldHeaderRootProps extends HTMLAttributes<HTMLElement> {
+    'data-part': string;
+}
+export interface FieldHeaderProps extends ComponentPropsWithRef<'div'> {
+    render?: ((props: FieldHeaderRootProps) => ReactNode) | undefined;
+}
+export interface FieldIndicatorRootProps extends HTMLAttributes<HTMLElement> {
+    'data-part': string;
+    id: string | undefined;
+}
+export interface FieldIndicatorProps extends ComponentPropsWithRef<'span'> {
+    render?: ((props: FieldIndicatorRootProps) => ReactNode) | undefined;
+}
+/**
+ * What `render` receives for the action. It is a `button` by default, and
+ * `type` is only written there: a link substituted through `render` takes the
+ * props without it.
+ */
+export interface FieldActionRootProps extends AllHTMLAttributes<HTMLElement> {
+    'data-part': string;
+}
+export interface FieldActionProps extends ComponentPropsWithRef<'button'> {
+    render?: ((props: FieldActionRootProps) => ReactNode) | undefined;
+}
+/**
+ * The help beside the label: a button with the family's glyph, and the hint in
+ * a tooltip. Its element is fixed rather than substitutable, because the button
+ * carries the name, the description and the control of the layer, and every one
+ * of them is the family's.
+ */
+export interface FieldHelpProps extends Omit<ComponentPropsWithRef<'button'>, 'children' | 'type'> {
+    /** The hint. It is written once and reaches the tooltip and the description. */
+    children?: ReactNode | undefined;
+    /** The hint's state, uncontrolled. */
+    defaultOpen?: boolean | undefined;
+    /** Asked before the hint opens or closes, with the reason. */
+    onOpenChange?: ((open: boolean, request: TooltipChangeRequest) => void) | undefined;
+    /** The hint's state, controlled. */
+    open?: boolean | undefined;
+    /** Where the hint opens. Defaults to the tooltip provider, then `top`. */
+    side?: TooltipSide | undefined;
+}
+//# sourceMappingURL=field.types.d.ts.map

package/dist/types/field/field.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.types.d.ts","sourceRoot":"","sources":["../../../src/field/field.types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+export { deriveFieldIds, FIELD_DESCRIBED_ORDER, formatFieldCount, isFieldCountOver, necessityMark, useField, } from './field-context';
+export { Field } from './field';
+export { FieldAction, FieldControl, FieldCounter, FieldDescription, FieldError, FieldHeader, FieldHelp, FieldIndicator, FieldLabel, } from './field-parts';
+export { FieldDefaultsProvider, useFieldDefaults } from './field-defaults';
+export type { FieldActionProps, FieldActionRootProps, FieldContextValue, FieldControlProps, FieldControlRootProps, FieldCount, FieldCounterProps, FieldCounterRootProps, FieldDefaults, FieldDefaultsProviderProps, FieldDescribedSlot, FieldHeaderProps, FieldHeaderRootProps, FieldHelpProps, FieldIds, FieldIndicatorProps, FieldIndicatorRootProps, FieldLabelPlacement, FieldLabelProps, FieldLabelRootProps, FieldMessageProps, FieldNecessity, FieldProps, FieldRootProps, FieldSize, } from './field.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/field/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/field/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,GACV,MAAM,eAAe,CAAC"}

package/dist/types/field-group/field-group-parts.d.ts

@@ -0,0 +1,30 @@
+import type { FieldGroupContentProps, FieldGroupLegendProps, FieldGroupMessageProps } from './field-group.types';
+/** Whether a message has anything to say; an empty one describes nothing. */
+export declare const hasContent: (children: unknown) => boolean;
+/**
+ * The name of the set, and whether the set has to be answered.
+ *
+ * It holds whatever the page puts in it. On a page asking one question GOV.UK
+ * recommends the legend contain the page's own heading, so a reader hears the
+ * question once rather than twice; the family removes the heading's block break
+ * and its margins and leaves its type alone, because a page heading is a page's
+ * decision rather than a control's.
+ */
+export declare function FieldGroupLegend({ children, id, ref, render, ...nativeProps }: FieldGroupLegendProps): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+/**
+ * The box that lays the fields out.
+ *
+ * It exists because a `legend` inside a grid or flex container is laid out by
+ * rules of its own in every engine: the fieldset stays a block, and this is the
+ * element `orientation` arranges.
+ */
+export declare function FieldGroupContent({ ref, render, ...nativeProps }: FieldGroupContentProps): string | number | bigint | boolean | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+/** Help about the whole set, joining the fieldset's own `aria-describedby`. */
+export declare function FieldGroupDescription({ children, mark, tone, ...rest }: FieldGroupMessageProps): import("react").JSX.Element;
+/**
+ * What is wrong with the set — the case a single field cannot state, because
+ * "choose at least one" is a fact about the group rather than about any control
+ * in it. GOV.UK's error-message-with-legend example is the same arrangement.
+ */
+export declare function FieldGroupError({ children, mark, tone, ...rest }: FieldGroupMessageProps): import("react").JSX.Element;
+//# sourceMappingURL=field-group-parts.d.ts.map

package/dist/types/field-group/field-group-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-group-parts.d.ts","sourceRoot":"","sources":["../../../src/field-group/field-group-parts.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,sBAAsB,EAEtB,qBAAqB,EAErB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAa7B,6EAA6E;AAC7E,eAAO,MAAM,UAAU,GAAI,UAAU,OAAO,YAC0C,CAAC;AAEvF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,EAAE,EACF,GAAG,EACH,MAAM,EACN,GAAG,WAAW,EACf,EAAE,qBAAqB,+VAsBvB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,sBAAsB,+VAGxF;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,sBAAsB,+BAe9F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,sBAAsB,+BAexF"}

package/dist/types/field-group/field-group.d.ts

@@ -0,0 +1,34 @@
+
+import type { FieldGroupContextValue, FieldGroupIds, FieldGroupProps } from './field-group.types';
+export declare const FieldGroupContext: import("react").Context<FieldGroupContextValue | undefined>;
+/** What the group around this component says, or `undefined` if there is none. */
+export declare function useFieldGroup(): FieldGroupContextValue | undefined;
+/** The three identifiers a group derives from its base, in one place. */
+export declare function deriveFieldGroupIds(base: string): FieldGroupIds;
+/**
+ * A set of fields under one name.
+ *
+ * **The platform does the work.** The element is a native `fieldset` and the
+ * name is a native `legend` — the technique the APG's naming practice calls for
+ * under its Rule 3, prefer native techniques — so the `group` role and the
+ * accessible name arrive without a single ARIA attribute. `disabled` is the
+ * native attribute, and every control inside is disabled by the browser with
+ * nothing passed down.
+ *
+ * **What is said about the set is said before the set.** The description and
+ * the error come between the legend and the fields, which is where GOV.UK's
+ * fieldset example puts a hint and an error, and the opposite of where a single
+ * field puts its own.
+ *
+ * **`aria-describedby` goes on the fieldset.** A reader entering any control in
+ * the group hears the group's hint and its error once, from the element that
+ * names them both.
+ *
+ * **The group provides for its fields.** `size`, `labelPlacement`,
+ * `necessity`, `disabled` and `readOnly` reach every
+ * field inside through the same provider an application uses, so a compact
+ * section is one attribute rather than one per field. `required` is not
+ * provided: it is a fact about one value, and a section cannot know it.
+ */
+export declare function FieldGroup({ 'aria-describedby': describedBy, children, disabled, id, invalid, labelPlacement, messages: words, necessity, orientation, readOnly, ref, render, required, size, ...nativeProps }: FieldGroupProps): import("react").JSX.Element;
+//# sourceMappingURL=field-group.d.ts.map

package/dist/types/field-group/field-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-group.d.ts","sourceRoot":"","sources":["../../../src/field-group/field-group.tsx"],"names":[],"mappings":"AAAA,OAAO,6CAA6C,CAAC;AAkBrD,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,iBAAiB,6DAA+D,CAAC;AAE9F,kFAAkF;AAClF,wBAAgB,aAAa,IAAI,sBAAsB,GAAG,SAAS,CAElE;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAM/D;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,EACzB,kBAAkB,EAAE,WAAW,EAC/B,QAAQ,EACR,QAAQ,EACR,EAAE,EACF,OAAO,EACP,cAAc,EACd,QAAQ,EAAE,KAAK,EACf,SAAS,EACT,WAAW,EACX,QAAQ,EACR,GAAG,EACH,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,GAAG,WAAW,EACf,EAAE,eAAe,+BAyFjB"}

package/dist/types/field-group/field-group.types.d.ts

@@ -0,0 +1,87 @@
+import type { FamilyTranslator, FieldMessages, PartialMessages } from '@slotted/core/i18n';
+import type { ComponentPropsWithRef, HTMLAttributes, ReactNode } from 'react';
+import type { FieldLabelPlacement, FieldMessageProps, FieldNecessity, FieldSize } from '../field';
+/** How the fields inside the group flow. */
+export type FieldGroupOrientation = 'vertical' | 'horizontal';
+/** The three identifiers a group derives from one base. */
+export interface FieldGroupIds {
+    description: string;
+    error: string;
+    legend: string;
+}
+export interface FieldGroupContextValue {
+    ids: FieldGroupIds;
+    messageSize: 'sm' | 'md';
+    registerMessage: (slot: 'description' | 'error', present: boolean) => void;
+    necessity: FieldNecessity;
+    /** Unset unless the page states it; a member with no `invalid` of its own defers to it. */
+    invalid: boolean | undefined;
+    required: boolean | undefined;
+    size: FieldSize;
+    /** The field family's words in the language in force, with the group's `messages` laid over them. */
+    t: FamilyTranslator<FieldMessages>;
+}
+/**
+ * What `render` receives, written against `HTMLAttributes<HTMLElement>` for the
+ * reason the field's own root props record: a props object typed for a
+ * `fieldset` cannot be spread onto anything else, which is what `render` is for.
+ */
+export interface FieldGroupRootProps extends HTMLAttributes<HTMLElement> {
+    disabled: boolean | undefined;
+    'data-disabled'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-orientation': FieldGroupOrientation;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-required'?: '' | undefined;
+    'data-necessity': FieldNecessity;
+    'data-size': FieldSize;
+    'data-ui': string;
+}
+export interface FieldGroupProps extends Omit<ComponentPropsWithRef<'fieldset'>, 'children'> {
+    children?: ReactNode | undefined;
+    /**
+     * The native attribute on the `fieldset`, which the platform propagates to
+     * every control inside with nothing passed down. The group still provides
+     * `disabled` to its fields, because the platform disables controls and a
+     * label is not one.
+     */
+    disabled?: boolean | undefined;
+    /** The base for `<id>-legend`, `<id>-description` and `<id>-error`. */
+    id?: string | undefined;
+    /** Unstated rather than `false`. Writes `data-invalid` on the fieldset. */
+    invalid?: boolean | undefined;
+    /** Provided to every field inside, unless the field states its own. */
+    labelPlacement?: FieldLabelPlacement | undefined;
+    /**
+     * Words laid over the field catalog of the language in force for the
+     * legend's own necessity word (`optional`, `required`). A field inside
+     * states its own `messages`.
+     */
+    messages?: PartialMessages<FieldMessages> | undefined;
+    /** How the fields inside flow. Defaults to `vertical`. */
+    orientation?: FieldGroupOrientation | undefined;
+    /** Provided to every field inside, unless the field states its own. */
+    readOnly?: boolean | undefined;
+    /** Draws the necessity marker on the legend, and is not provided to the fields. */
+    required?: boolean | undefined;
+    /** Provided to every field inside. Defaults to the field provider, then `mark`. */
+    necessity?: FieldNecessity | undefined;
+    render?: ((props: FieldGroupRootProps) => ReactNode) | undefined;
+    /** Provided to every field inside. Defaults to `md`. */
+    size?: FieldSize | undefined;
+}
+export interface FieldGroupLegendRootProps extends HTMLAttributes<HTMLElement> {
+    'data-part': string;
+}
+export interface FieldGroupLegendProps extends ComponentPropsWithRef<'legend'> {
+    render?: ((props: FieldGroupLegendRootProps) => ReactNode) | undefined;
+}
+export interface FieldGroupContentRootProps extends HTMLAttributes<HTMLElement> {
+    'data-part': string;
+}
+export interface FieldGroupContentProps extends ComponentPropsWithRef<'div'> {
+    render?: ((props: FieldGroupContentRootProps) => ReactNode) | undefined;
+}
+export type FieldGroupMessageProps = FieldMessageProps;
+//# sourceMappingURL=field-group.types.d.ts.map

package/dist/types/field-group/field-group.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-group.types.d.ts","sourceRoot":"","sources":["../../../src/field-group/field-group.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAElG,4CAA4C;AAC5C,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE9D,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3E,SAAS,EAAE,cAAc,CAAC;IAC1B,2FAA2F;IAC3F,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,qGAAqG;IACrG,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACtE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,eAAe,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;IAChC,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;IACjC,eAAe,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;IACjC,gBAAgB,EAAE,cAAc,CAAC;IACjC,WAAW,EAAE,SAAS,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IAC1F,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,uEAAuE;IACvE,cAAc,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IACtD,0DAA0D;IAC1D,WAAW,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAChD,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,mFAAmF;IACnF,SAAS,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;IACjE,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,yBAA0B,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB,CAAC,QAAQ,CAAC;IAC5E,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,yBAAyB,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,WAAW,0BAA2B,SAAQ,cAAc,CAAC,WAAW,CAAC;IAC7E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IAC1E,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;CACzE;AAED,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC"}

package/dist/types/field-group/index.d.ts

@@ -0,0 +1,4 @@
+export { deriveFieldGroupIds, FieldGroup, useFieldGroup } from './field-group';
+export { FieldGroupContent, FieldGroupDescription, FieldGroupError, FieldGroupLegend, } from './field-group-parts';
+export type { FieldGroupContentProps, FieldGroupContentRootProps, FieldGroupContextValue, FieldGroupIds, FieldGroupLegendProps, FieldGroupLegendRootProps, FieldGroupMessageProps, FieldGroupOrientation, FieldGroupProps, FieldGroupRootProps, } from './field-group.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/field-group/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/field-group/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/types/filter-bar/filter-bar-defaults.d.ts

@@ -0,0 +1,10 @@
+import type { FilterBarDefaults, FilterBarDefaultsProviderProps } from './filter-bar.types';
+export declare function useFilterBarDefaults(): FilterBarDefaults;
+/**
+ * An application decides once how its bars apply, how long the query waits,
+ * how many chips show, and which key reaches the search. A bar that states any
+ * of those itself still wins. Its words come from the language in force
+ * (`SlottedProvider`).
+ */
+export declare function FilterBarDefaultsProvider({ children, ...defaults }: FilterBarDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=filter-bar-defaults.d.ts.map

package/dist/types/filter-bar/filter-bar-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-bar-defaults.d.ts","sourceRoot":"","sources":["../../../src/filter-bar/filter-bar-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAI5F,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,QAAQ,EACR,GAAG,QAAQ,EACZ,EAAE,8BAA8B,+BAgBhC"}

package/dist/types/filter-bar/filter-bar-rules.d.ts

@@ -0,0 +1,108 @@
+import type { FilterCondition, FilterDescriptor, FilterGroup, FilterPath, FilterRule } from '@slotted/core/filter';
+import type { FamilyTranslator, FilterBarMessages } from '@slotted/core/i18n';
+import type { KeyboardEvent, ReactNode } from 'react';
+import type { FilterBarField, FilterBarOperandProps, FilterBarSize } from './filter-bar.types';
+type Condition = FilterCondition<string, unknown>;
+/** What every editor in the family shares: the fields, the words, the size, the consumer's operand. */
+export interface RuleEnvironment {
+    fields: readonly FilterBarField[];
+    /** The family's words in the language in force, with the bar's `messages` laid over them. */
+    t: FamilyTranslator<FilterBarMessages>;
+    size: FilterBarSize;
+    renderOperand: ((props: FilterBarOperandProps) => ReactNode) | undefined;
+    /** What `Enter` in an operand does in the surface the rule is drawn in. */
+    apply: () => void;
+    /** The one rule card open in the builder's card form, by its path joined with dots. */
+    expanded?: string | null | undefined;
+    onExpandedChange?: ((path: string | null) => void) | undefined;
+}
+export declare function fieldByKey(fields: readonly FilterBarField[], key: string): FilterBarField | undefined;
+/** An operator's name, or the operator itself when the catalog names no such operator. */
+export declare function operatorName(t: FamilyTranslator<FilterBarMessages>, operator: string): string;
+/**
+ * A message's text on either side of one slot, for a sentence that holds a
+ * control: the join chooser stands where `{join}` stands, in the order the
+ * language writes it.
+ */
+export declare function aroundSlot(written: (mark: string) => string): [string, string];
+/** The rule a field starts with: its default, else one empty condition on its default operator. */
+export declare function blankRule(field: FilterBarField): FilterDescriptor;
+/**
+ * A condition in the words a chip and a rule card write it with: the operator
+ * as the sentence reads it, and the value — a list of more than two written as
+ * its first two and a count, the whole list kept in `full` for the name and the
+ * title.
+ */
+export declare function ruleWords(t: FamilyTranslator<FilterBarMessages>, field: FilterBarField | undefined, filter: FilterDescriptor | null | undefined): {
+    operator: string;
+    value: string;
+    full: string;
+    operands: number;
+};
+/** A field's glyph: a name from the glyph set, or the consumer's own node. */
+export declare function FieldIcon({ icon }: {
+    icon: FilterBarField['icon'];
+}): import("react").JSX.Element | null;
+/** `Enter` applies, and the consumer's own handler ran first. */
+export declare function applyOnEnter(apply: () => void): (event: KeyboardEvent) => void;
+/**
+ * The operand control a kind draws, the same choice `table`'s five typed
+ * filters make: a text field, a number field, the whole date picker, a list
+ * of the two truths, a multi-select over the field's options. Replaceable by
+ * the consumer through `renderOperand`, which is the seam round 12 uses.
+ */
+export declare function Operand(props: FilterBarOperandProps & {
+    render?: RuleEnvironment['renderOperand'];
+}): import("react").JSX.Element;
+export interface ConditionEditorProps {
+    environment: RuleEnvironment;
+    field: FilterBarField;
+    condition: Condition;
+    onConditionChange: (condition: Condition) => void;
+    /** Draws the operator control. A chip's value popover leaves it to the chip's operator segment. */
+    withOperator?: boolean | undefined;
+    /** Ids for the two parts, which a rule card's sentence names in `aria-controls`. */
+    ids?: {
+        operator: string;
+        operand: string;
+    } | undefined;
+    /** The rule is invalid: the operator select says so itself, edge and ring. */
+    invalid?: boolean | undefined;
+}
+/**
+ * One condition: the operator and its operands. An operand the new operator
+ * still takes survives the change, `table`'s rule.
+ */
+export declare function ConditionEditor({ condition, environment, field, ids, invalid, onConditionChange, withOperator, }: ConditionEditorProps): import("react").JSX.Element;
+export interface RuleEditorProps {
+    environment: RuleEnvironment;
+    rule: FilterRule;
+    /** The rule's path inside the root, which names its card. */
+    path: FilterPath;
+    /** Which fields the field chooser lists. Defaults to every field. */
+    choices?: readonly FilterBarField[] | undefined;
+    onRuleChange: (rule: FilterRule) => void;
+    onRemove?: (() => void) | undefined;
+    invalid?: boolean | undefined;
+}
+/** One rule row in the builder: field, operator, operand, remove. */
+export declare function RuleEditor({ choices, environment, invalid, onRemove, onRuleChange, path, rule, }: RuleEditorProps): import("react").JSX.Element;
+export interface GroupEditorProps {
+    environment: RuleEnvironment;
+    group: FilterGroup;
+    /** The path of this group inside the root, `[]` for the root. */
+    path: FilterPath;
+    root: FilterGroup;
+    onRootChange: (root: FilterGroup) => void;
+    /** The field a new rule starts with. */
+    firstField: FilterBarField | undefined;
+    extra?: ReactNode;
+}
+/**
+ * A group: its join, its rules and groups in order, and the controls that grow
+ * it. Recursive, so a group holds a group; the depth is on the element for the
+ * rail the stylesheet draws.
+ */
+export declare function GroupEditor({ environment, extra, firstField, group, onRootChange, path, root, }: GroupEditorProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=filter-bar-rules.d.ts.map

package/dist/types/filter-bar/filter-bar-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-bar-rules.d.ts","sourceRoot":"","sources":["../../../src/filter-bar/filter-bar-rules.tsx"],"names":[],"mappings":"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"}

package/dist/types/filter-bar/filter-bar.d.ts

@@ -0,0 +1,11 @@
+
+import type { FilterBarProps } from './filter-bar.types';
+export declare const FILTER_BAR_FALLBACK: {
+    readonly apply: "live";
+    readonly chipLimit: 6;
+    readonly queryDelay: 320;
+    readonly shortcut: null;
+    readonly size: "md";
+};
+export declare function FilterBar({ apply: applyProp, children, chipLimit: chipLimitProp, count, defaultOpen, defaultPreset, defaultQuery, defaultRevealed, defaultValue, disabled, fields, loading, messages, onOpenChange, onPresetChange, onPresetSave, onQueryChange, onRevealedChange, onValueChange, open: openProp, preset: presetProp, presets, query: queryProp, queryDelay: queryDelayProp, readOnly, ref, renderOperand, revealed: revealedProp, shortcut: shortcutProp, size: sizeProp, sticky, container, total, value: valueProp, ...nativeProps }: FilterBarProps): import("react").JSX.Element;
+//# sourceMappingURL=filter-bar.d.ts.map

package/dist/types/filter-bar/filter-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-bar.d.ts","sourceRoot":"","sources":["../../../src/filter-bar/filter-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,2CAA2C,CAAC;AAuFnD,OAAO,KAAK,EAIV,cAAc,EAIf,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAC;AAwGX,wBAAgB,SAAS,CAAC,EACxB,KAAK,EAAE,SAAS,EAChB,QAAQ,EACR,SAAS,EAAE,aAAa,EACxB,KAAK,EACL,WAAW,EACX,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,QAAgB,EAChB,MAAM,EACN,OAAe,EACf,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,OAAO,EACP,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,QAAgB,EAChB,GAAG,EACH,aAAa,EACb,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,EACd,MAAc,EACd,SAAS,EACT,KAAK,EACL,KAAK,EAAE,SAAS,EAChB,GAAG,WAAW,EACf,EAAE,cAAc,+BAupChB"}