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

package/dist/types/tree/tree.types.d.ts

@@ -0,0 +1,322 @@
+import type { ChangeReason, ChangeRequest } from '@slotted/core/state';
+import type { ComponentPropsWithRef, HTMLAttributes, MouseEvent, ReactNode, Ref } from 'react';
+/** The type step the tree and every row inside it sit at. */
+export type TreeSize = 'sm' | 'md' | 'lg';
+/**
+ * Whether the tree draws its own box. `framed` is the standalone control;
+ * `plain` is what a tree renders as inside a panel that already has an edge.
+ */
+export type TreeVariant = 'plain' | 'framed';
+/** How many nodes may be chosen at once. */
+export type TreeSelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * Which of the two models the pattern offers is in force. `toggle` is the
+ * recommended one: a plain press changes one node and holds no modifier.
+ * `replace` is the alternative, which is what a file list does.
+ */
+export type TreeSelectionBehavior = 'toggle' | 'replace';
+/**
+ * How the selection is drawn, and which attribute states it.
+ *
+ * `highlight` writes `aria-selected` and says it with the row's ground and ink;
+ * `checkbox` writes `aria-checked` and draws the box `checkbox` draws. The
+ * pattern allows one attribute or the other and never both. `auto` reads the
+ * selection mode: a box for `multiple`, a highlight for `single`, neither for
+ * `none`.
+ */
+export type TreeSelectionIndicator = 'auto' | 'highlight' | 'checkbox' | 'none';
+/** Whether pressing a branch takes its descendants with it. */
+export type TreeSelectionCascade = 'none' | 'descendants';
+/** What a press on the row does to a branch. */
+export type TreeExpandOn = 'row' | 'expander';
+/**
+ * How the keyboard's position is expressed. `auto` reads one fact — whether the
+ * set is windowed — and answers `activedescendant` when it is, because a roving
+ * tab stop cannot survive its own element being recycled.
+ */
+export type TreeFocusMode = 'auto' | 'roving' | 'activedescendant';
+/**
+ * Whether the nodes are nested in `role="group"` elements or laid flat with
+ * their level stated. A window renders a slice of the visible rows and a slice
+ * cannot preserve nesting, so `auto` answers `flat` while windowed.
+ */
+export type TreeStructure = 'auto' | 'nested' | 'flat';
+/**
+ * What the tree holds: one key in `single` and `none`, a set of them in
+ * `multiple`. The shape `listbox` settled, for the same reason.
+ */
+export type TreeValue = string | readonly string[] | null;
+/** Why the selection moved. */
+export type TreeSelectionReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'select' | 'clear' | 'programmatic'>;
+/** Why a branch opened or closed. */
+export type TreeExpansionReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'programmatic'>;
+/** Why the active node moved. */
+export type TreeActiveReason = Extract<ChangeReason, 'pointer' | 'keyboard' | 'programmatic'>;
+export type TreeChangeRequest = ChangeRequest<TreeValue>;
+export type TreeExpansionRequest = ChangeRequest<readonly string[]>;
+export type TreeActiveRequest = ChangeRequest<string | null>;
+/** Where `scrollToKey` puts the node it reveals. */
+export type TreeAlignment = 'start' | 'center' | 'end' | 'nearest';
+/** The imperative actions a consumer cannot express declaratively. */
+export interface TreeHandle {
+    /** Moves real focus into the tree, under either focus model. */
+    focus: () => void;
+    /** Reveals a node, opening the branches above it when they are closed. */
+    scrollToKey: (key: string, align?: TreeAlignment) => void;
+    /** Opens a branch, and every branch above it. */
+    expand: (key: string) => void;
+    collapse: (key: string) => void;
+    /** Opens or closes every branch the tree holds. Needs `nodes`. */
+    expandAll: () => void;
+    collapseAll: () => void;
+    /** Which node the keyboard is on, or `null`. */
+    getActiveKey: () => string | null;
+    /** The root element, for anything none of the others covers. */
+    getElement: () => HTMLDivElement | null;
+}
+/** What an application sets once for every tree under it. */
+export interface TreeDefaults {
+    size: TreeSize;
+    variant: TreeVariant;
+    structure: TreeStructure;
+    selectionMode: TreeSelectionMode;
+    selectionBehavior: TreeSelectionBehavior;
+    selectionIndicator: TreeSelectionIndicator;
+    selectionCascade: TreeSelectionCascade;
+    expandOn: TreeExpandOn;
+    focusMode: TreeFocusMode;
+    guides: boolean;
+    loop: boolean;
+    typeahead: boolean;
+    selectOnFocus: boolean;
+    navigateDisabled: boolean;
+    disallowEmptySelection: boolean;
+    disallowSelectAll: boolean;
+    virtual: boolean;
+    disabled: boolean;
+    itemSize: number;
+    overscan: number;
+    typeaheadTimeout: number;
+    pageSize: number;
+}
+export interface TreeDefaultsProviderProps extends Partial<TreeDefaults> {
+    children?: ReactNode | undefined;
+}
+/** What the tree hands every part inside it. */
+export interface TreeContextValue {
+    disabled: boolean | undefined;
+    readOnly: boolean | undefined;
+    selectionMode: TreeSelectionMode;
+    indicator: Exclude<TreeSelectionIndicator, 'auto'>;
+    expandOn: TreeExpandOn;
+    structure: Exclude<TreeStructure, 'auto'>;
+    guides: boolean;
+    isSelected: (key: string) => boolean;
+    isExpanded: (key: string) => boolean;
+    isActive: (key: string) => boolean;
+    isIndeterminate: (key: string) => boolean;
+    /** Whether a collapsed branch holds a chosen descendant. */
+    holdsSelection: (key: string) => boolean;
+    isNodeDisabled: (key: string) => boolean;
+    /** The id a node carries, so `aria-activedescendant` can name it. */
+    nodeId: (key: string) => string;
+    /** The id of the node's own label, which is what names it. */
+    labelId: (key: string) => string;
+    /** The tab stop, under the roving model. `undefined` under the other one. */
+    nodeTabIndex: (key: string) => number | undefined;
+    /** A press on a row, with the modifiers it was pressed with. */
+    press: (key: string, event: MouseEvent<HTMLElement>) => void;
+    /** A press on the chevron, which only ever opens or closes. */
+    pressExpander: (key: string, event: MouseEvent<HTMLElement>) => void;
+    /** A press on the box, which only ever selects. */
+    pressIndicator: (key: string, event: MouseEvent<HTMLElement>) => void;
+    /**
+     * How large a sibling group is and where one node sits in it. Both are
+     * `undefined` unless the flat structure is in force, which is exactly when
+     * the pattern requires them: with the nesting in the DOM the browser
+     * computes all three.
+     */
+    levelOf: (key: string) => number | undefined;
+    setSizeOf: (key: string) => number | undefined;
+    posInSetOf: (key: string) => number | undefined;
+}
+/** What `render` receives for the tree's root. */
+export interface TreeRootProps extends HTMLAttributes<HTMLElement> {
+    'data-disabled'?: '' | undefined;
+    'data-expand-on': TreeExpandOn;
+    'data-focus-mode': 'roving' | 'activedescendant';
+    'data-guides': 'true' | 'false';
+    'data-indicator': Exclude<TreeSelectionIndicator, 'auto'>;
+    'data-invalid'?: '' | undefined;
+    'data-loading'?: '' | undefined;
+    'data-part': string;
+    'data-readonly'?: '' | undefined;
+    'data-required'?: '' | undefined;
+    'data-selection': TreeSelectionMode;
+    'data-size': TreeSize;
+    'data-structure': Exclude<TreeStructure, 'auto'>;
+    'data-ui': string;
+    'data-variant': TreeVariant;
+}
+/** What `render` receives for one node. */
+export interface TreeNodeRootProps extends HTMLAttributes<HTMLLIElement> {
+    'data-branch'?: '' | undefined;
+    'data-pinned'?: '' | undefined;
+    'data-current'?: '' | undefined;
+    'data-depth': number;
+    'data-disabled'?: '' | undefined;
+    'data-expanded'?: '' | undefined;
+    'data-indeterminate'?: '' | undefined;
+    'data-key': string;
+    'data-loading'?: '' | undefined;
+    'data-match'?: 'hit' | 'ancestor' | undefined;
+    'data-part': string;
+    'data-selected'?: '' | undefined;
+    'data-selected-within'?: '' | undefined;
+}
+export interface TreePartProps extends ComponentPropsWithRef<'span'> {
+    children?: ReactNode | undefined;
+}
+export interface TreeMessageProps extends ComponentPropsWithRef<'div'> {
+    children?: ReactNode | undefined;
+}
+export interface TreeGroupProps extends Omit<ComponentPropsWithRef<'ul'>, 'children'> {
+    children?: ReactNode | undefined;
+}
+export interface TreeNodeProps extends Omit<ComponentPropsWithRef<'li'>, 'children' | 'onSelect'> {
+    /** The sub-nodes. Their presence is what makes this node a branch. */
+    children?: ReactNode | undefined;
+    /**
+     * The key this node selects and expands by. It is what `value` and
+     * `expandedKeys` hold, and it is a string: the consumer's own object never
+     * enters the contract.
+     */
+    value: string;
+    /** The node's name. What the reader sees, and what names the node. */
+    label: ReactNode;
+    /** A second line under the name. */
+    description?: ReactNode | undefined;
+    /** The leading picture, which the consumer owns whole. */
+    icon?: ReactNode | undefined;
+    /** The trailing count, size or badge. */
+    meta?: ReactNode | undefined;
+    /** The trailing controls. They stay in the DOM and stay reachable. */
+    actions?: ReactNode | undefined;
+    /**
+     * What typeahead matches and what a reader hears. Defaults to the label's own
+     * text, which is wrong exactly when the label holds a mark or a number.
+     */
+    textValue?: string | undefined;
+    /**
+     * Whether this node has children that have not been rendered yet. A branch
+     * says so before it can prove it, which is what makes lazy loading possible.
+     */
+    hasChildren?: boolean | undefined;
+    /**
+     * How deep the node sits, stated only by the flat shape. Everywhere else the
+     * markup says it: each node raises the depth by one for the nodes inside it,
+     * so the number is a fact about the tree rather than one more thing a
+     * consumer can get wrong. A window has no nesting left to count.
+     */
+    depth?: number | undefined;
+    /**
+     * Rendered at its own place on the canvas whether or not the window covers
+     * it. The tree pins the active node and the range anchor; nothing else sets
+     * it, because an `aria-activedescendant` whose target has been recycled names
+     * an id that is not in the document.
+     */
+    pinned?: boolean | undefined;
+    /** Where the node sits on the canvas, in pixels. Windowed rows only. */
+    offset?: number | undefined;
+    /** Whether the children are on their way. Writes `aria-busy` on the group. */
+    loading?: boolean | undefined;
+    /**
+     * Unstated rather than `false`, so the node defers to the tree. It is
+     * `aria-disabled` and never the native attribute: a disabled node keeps its
+     * place in the set.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Whether a query matched this node's own name or one below it. It is a fact
+     * rather than a state — the reader did not put the node in it — and the tree
+     * writes it when it filters.
+     */
+    match?: 'hit' | 'ancestor' | undefined;
+    render?: ((props: TreeNodeRootProps) => ReactNode) | undefined;
+}
+export interface TreeProps<T = unknown> extends Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'onChange' | 'children'> {
+    children?: ReactNode | undefined;
+    /** Present means controlled, for the life of the component. */
+    value?: TreeValue | undefined;
+    defaultValue?: TreeValue | undefined;
+    onValueChange?: ((value: TreeValue, request: TreeChangeRequest) => void) | undefined;
+    /** Which branches are open. Present means controlled. */
+    expandedKeys?: readonly string[] | undefined;
+    defaultExpandedKeys?: readonly string[] | undefined;
+    onExpandedKeysChange?: ((keys: readonly string[], request: TreeExpansionRequest) => void) | undefined;
+    /** Which node the keyboard is on. Present means controlled. */
+    activeKey?: string | null | undefined;
+    defaultActiveKey?: string | null | undefined;
+    onActiveKeyChange?: ((key: string | null, request: TreeActiveRequest) => void) | undefined;
+    /** A node was activated: pressed, or `Enter` on the keyboard. */
+    onNodeActivate?: ((key: string, reason: 'pointer' | 'keyboard') => void) | undefined;
+    selectionMode?: TreeSelectionMode | undefined;
+    selectionBehavior?: TreeSelectionBehavior | undefined;
+    selectionIndicator?: TreeSelectionIndicator | undefined;
+    selectionCascade?: TreeSelectionCascade | undefined;
+    expandOn?: TreeExpandOn | undefined;
+    structure?: TreeStructure | undefined;
+    size?: TreeSize | undefined;
+    variant?: TreeVariant | undefined;
+    focusMode?: TreeFocusMode | undefined;
+    guides?: boolean | undefined;
+    loop?: boolean | undefined;
+    typeahead?: boolean | undefined;
+    typeaheadTimeout?: number | undefined;
+    selectOnFocus?: boolean | undefined;
+    navigateDisabled?: boolean | undefined;
+    disallowEmptySelection?: boolean | undefined;
+    disallowSelectAll?: boolean | undefined;
+    pageSize?: number | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    required?: boolean | undefined;
+    invalid?: boolean | undefined;
+    /** Whether the set is still arriving. Writes `aria-busy` on the tree. */
+    loading?: boolean | undefined;
+    /** Submits one hidden input per chosen key, so a bare form carries the set. */
+    name?: string | undefined;
+    /**
+     * The hierarchy, when the tree is to hold it rather than be written out. It
+     * is what a cascade needs — a collapsed branch's descendants are not in the
+     * DOM — and what `expandAll` and the filter read.
+     */
+    nodes?: readonly T[] | undefined;
+    getKey?: ((node: T) => string) | undefined;
+    getLabel?: ((node: T) => string) | undefined;
+    getChildren?: ((node: T) => readonly T[] | undefined) | undefined;
+    /** The already-flat shape, each row carrying its own level. */
+    getLevel?: ((node: T) => number) | undefined;
+    hasChildren?: ((node: T) => boolean) | undefined;
+    getChildrenCount?: ((node: T) => number | undefined) | undefined;
+    isNodeDisabled?: ((node: T) => boolean) | undefined;
+    isNodeLoading?: ((node: T) => boolean) | undefined;
+    /** The content of one row. The family renders the row around it. */
+    renderNode?: ((node: T, key: string) => ReactNode) | undefined;
+    /**
+     * A query the tree filters by. The consumer owns the string and the control
+     * it is typed into; the tree keeps the ancestors of every hit and marks the
+     * matched span. Needs `nodes`.
+     */
+    query?: string | undefined;
+    /** Renders only the rows the viewport covers. Forces the flat structure. */
+    virtual?: boolean | undefined;
+    itemSize?: number | undefined;
+    overscan?: number | undefined;
+    /** What the tree shows when it holds nothing. */
+    emptyContent?: ReactNode | undefined;
+    ref?: Ref<HTMLDivElement> | undefined;
+    handleRef?: Ref<TreeHandle> | undefined;
+    render?: ((props: TreeRootProps) => ReactNode) | undefined;
+}
+//# sourceMappingURL=tree.types.d.ts.map

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

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

package/dist/types/typography/heading-level.d.ts

@@ -0,0 +1,12 @@
+import type { HeadingLevelProps, HeadingLevelValue } from './typography.types';
+/** The rank a heading takes here when it states none of its own. */
+export declare function useHeadingLevel(): HeadingLevelValue;
+/**
+ * One section deeper. A heading inside takes the next rank, which is how the
+ * outline stays correct in a tree the consumer assembles from components that
+ * cannot see each other: the HTML Standard requires each heading to be less
+ * than, equal to, or one greater than the heading before it, and stepping by
+ * exactly one is the only way to guarantee that without reading the document.
+ */
+export declare function HeadingLevel({ children }: HeadingLevelProps): import("react").JSX.Element;
+//# sourceMappingURL=heading-level.d.ts.map

package/dist/types/typography/heading-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-level.d.ts","sourceRoot":"","sources":["../../../src/typography/heading-level.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM/E,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAW3D"}