altitude-design 0.2.1 → 0.3.0

package/dist/types/edit-region.d.ts

@@ -0,0 +1,121 @@
+import * as React from 'react';
+type Fields<T> = Partial<Record<keyof T, string>>;
+export type EditRegionSaveResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+    fieldErrors?: Fields<T>;
+};
+export interface EditRegionProps<T extends Record<string, unknown>> {
+    /** Names the region: “Edit <label>”. */
+    label: string;
+    /** The committed record. */
+    value: T;
+    /** Publishes the accepted canonical record, synchronously and without a network write. */
+    onValueChange: (canonical: T) => void;
+    /** The sole write. `changed` lists only the fields that differ, so you can send a patch. */
+    onSave: (draft: T, context: {
+        previousValue: T;
+        changed: (keyof T)[];
+    }) => EditRegionSaveResult<T> | Promise<EditRegionSaveResult<T>>;
+    /** Runs on Save. Return an error per field, or undefined. */
+    validate?: (draft: T) => Fields<T> | undefined | Promise<Fields<T> | undefined>;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    /** The field focused on opening. Default: the first control in the form. */
+    initialFocus?: keyof T;
+    /** Used only when completion still owns focus and the Edit button cannot receive it. */
+    focusFallback?: () => HTMLElement | null;
+    /** Compares one field's values. Default Object.is. */
+    isEqual?: (a: unknown, b: unknown) => boolean;
+    editLabel?: string;
+    saveLabel?: string;
+    cancelLabel?: string;
+    /** How long the region's afterglow takes to fade after a save, in ms. Default 5000. */
+    settleDuration?: number;
+    /**
+     * 'form' (default): editing opens a form laid out your way. 'in-place': each value's well opens where its text is: mark
+     * read values with EditRegionValue, and lay the fields out where the values were. Controls take the value's font and
+     * reach 13px past their column on each side (the inset their text sits at), so leave 26px between columns.
+     */
+    layout?: 'form' | 'in-place';
+    className?: string;
+    /** EditRegionView and EditRegionForm. */
+    children: React.ReactNode;
+}
+/** Binds one field of the draft to a control. Spread the result onto it. */
+export interface EditRegionBinder<T> {
+    /** Text controls (Input, Textarea): value + onChange. */
+    <K extends keyof T>(key: K): {
+        name: string;
+        value: T[K];
+        onChange: (event: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+        readOnly: boolean;
+        disabled?: boolean;
+        'data-field': string;
+    };
+    /** Value controls (Select, Combobox, Slider): value + onValueChange. */
+    value<K extends keyof T>(key: K): {
+        name: string;
+        value: T[K];
+        onValueChange: (value: T[K]) => void;
+        disabled?: boolean;
+        'data-field': string;
+    };
+    /** Toggles (Switch, Checkbox): checked + onCheckedChange. */
+    checked<K extends keyof T>(key: K): {
+        checked: boolean;
+        onCheckedChange: (checked: boolean) => void;
+        disabled?: boolean;
+        'data-field': string;
+    };
+    /** The field's error, for its Field. */
+    error(key: keyof T): string | undefined;
+    /** The current draft. */
+    draft: T;
+}
+/**
+ * Several fields of one record, edited where the record is shown and saved together as one write. Read mode is the
+ * record on the ground; Edit lifts it into a static raised editor holding the fields. The editor's padding is there in
+ * both modes (with a negative margin), so lifting changes colour and shadow, never position. The session follows
+ * InlineEdit: no save on blur, one write in flight, a known failure keeps the draft, and an outside change blocks Save.
+ */
+export declare function EditRegion<T extends Record<string, unknown>>({ label, value, onValueChange, onSave, validate, open: openProp, defaultOpen, onOpenChange, disabled, initialFocus, focusFallback, isEqual, editLabel, saveLabel, cancelLabel, settleDuration, layout, className, children }: EditRegionProps<T>): React.JSX.Element;
+/** Read mode: the record as text. Shows an Edit button after it unless `trigger={false}` (then place EditRegionTrigger yourself). */
+export declare function EditRegionView({ children, trigger, className }: {
+    children?: React.ReactNode;
+    trigger?: boolean;
+    className?: string;
+}): React.JSX.Element | null;
+/**
+ * One value in read mode, named by the field that edits it. With layout 'in-place', a field whose text opens where its
+ * value was simply appears; one that opens elsewhere fades in. `reserve` gives the value its control's height and inset
+ * now, so in a list of labelled rows nothing moves at all when Edit opens.
+ */
+export declare function EditRegionValue({ field, reserve, children, className }: {
+    field: string;
+    reserve?: boolean;
+    children?: React.ReactNode;
+    className?: string;
+}): React.JSX.Element;
+/** The visible Edit button. Rendered by EditRegionView by default. */
+export declare function EditRegionTrigger({ children, className }: {
+    children?: React.ReactNode;
+    className?: string;
+}): React.JSX.Element | null;
+/**
+ * Edit mode: a form (or a group, inside another form) named “Edit <label>”, holding your fields, then any error and
+ * Save/Cancel. Children may be a function of the draft binder: `{(field) => <Input {...field('name')} />}`.
+ */
+export declare function EditRegionForm<T extends Record<string, unknown> = Record<string, unknown>>({ children, actions, className }: {
+    children: React.ReactNode | ((field: EditRegionBinder<T>) => React.ReactNode);
+    actions?: boolean;
+    className?: string;
+}): React.JSX.Element | null;
+/** Any error, the conflict notice and Save/Cancel. EditRegionForm renders them after the fields unless `actions={false}`. */
+export declare function EditRegionActions(): React.ReactNode;
+export {};

package/dist/types/feature-gate.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+export interface FeatureGateProps {
+    /** The plan it needs ("Business"). */
+    requires: string;
+    /** What the feature does, in the explanation. */
+    description?: React.ReactNode;
+    /** Opens the upgrade. */
+    onUpgrade?: () => void;
+    /** Where the plans are compared. */
+    compareHref?: string;
+    /** False when this person can't upgrade (not an admin): the button becomes "Ask an admin to upgrade". Default true. */
+    canUpgrade?: boolean;
+    /** The control that needs the plan: one element (a Button). It stays live. */
+    children: React.ReactElement<any>;
+    className?: string;
+}
+/**
+ * A feature that needs another plan, shown as locked rather than disabled. Disabled means nothing happens; a locked
+ * control does something (it explains the plan and offers the upgrade), so it stays live: normal ink, it lifts when
+ * pointed at, it's reachable, and it carries a lock and a plan plate. Pressing it opens a Popover.
+ */
+export declare function FeatureGate({ requires, description, onUpgrade, compareHref, canUpgrade, children, className }: FeatureGateProps): React.JSX.Element;

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

@@ -0,0 +1,65 @@
+import * as React from 'react';
+export interface FilterOption {
+    value: string;
+    label: string;
+}
+export interface FilterField {
+    key: string;
+    label: string;
+    /** enum: choose from options. text: a phrase. number. date: an ISO 'YYYY-MM-DD' date ('between' takes two). */
+    type: 'enum' | 'text' | 'number' | 'date';
+    options?: FilterOption[];
+    /** Enum lists get a search field. Default: when there are more than 8 options. */
+    searchable?: boolean;
+    /** Default by type: enum ['is', 'is not'], text ['contains', 'does not contain'], number ['=', '>', '<'], date ['before', 'after', 'between']. */
+    operators?: string[];
+}
+export type FilterValue = string | number | {
+    start: string;
+    end: string;
+} | undefined;
+export interface Filter {
+    id: string;
+    field: string;
+    operator: string;
+    value: FilterValue;
+}
+/** Nested logic: conditions and, with nesting={2}, groups of conditions, each with its own all/any. */
+export interface FilterTree {
+    match: 'all' | 'any';
+    items: (Filter | FilterGroup)[];
+}
+export interface FilterGroup {
+    id: string;
+    match: 'all' | 'any';
+    items: Filter[];
+}
+export interface FilterBarProps {
+    fields: FilterField[];
+    /** The conditions; or a FilterTree for nested logic ("Plan is Pro and any of: …"). */
+    value: Filter[] | FilterTree;
+    onValueChange: ((filters: Filter[]) => void) | ((tree: FilterTree) => void);
+    /** With a FilterTree: 2 allows groups one level deep. Default 1 (no groups). */
+    nesting?: 1 | 2;
+    /** Show the all/any segment even with one condition (a group's own switch). */
+    matchAlways?: boolean;
+    /** Shown as a segment when there's more than one filter. Omit to hide it. */
+    match?: 'all' | 'any';
+    onMatchChange?: (match: 'all' | 'any') => void;
+    /** Announced after each change: “Status is Done. 12 results”. */
+    resultCount?: number;
+    /** Ids for new filters. Default: a counter. */
+    createId?: () => string;
+    'aria-label'?: string;
+    className?: string;
+}
+/** The value as words, or undefined while there isn't one. */
+export declare const filterValueText: (f: FilterField, v: FilterValue) => string | undefined;
+/**
+ * A query as a row of conditions. Each condition is a plate stamped into the bar (ground), split into segments that
+ * lift when pointed at because each opens its picker (level 3). A condition still waiting for a value keeps that
+ * segment as an opening, and so does Add filter. The bar is one Tab stop: a toolbar with ←/→ between segments.
+ */
+/** The whole expression in words: "Plan is Pro and any of: Country is Germany, Seats > 50". */
+export declare function filterSentence(fields: FilterField[], value: Filter[] | FilterTree, match?: 'all' | 'any'): string;
+export declare function FilterBar(props: FilterBarProps): React.JSX.Element;

package/dist/types/formatted-number.d.ts

@@ -0,0 +1,38 @@
+import * as React from 'react';
+export type NumberFormatPreset = 'number' | 'currency' | 'bytes' | 'duration' | 'percent' | 'compact';
+export type DurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+export interface FormatNumberOptions extends Omit<Intl.NumberFormatOptions, 'style' | 'unit' | 'notation'> {
+    /** Default 'number'. */
+    format?: NumberFormatPreset;
+    /** Default: the browser's. */
+    locale?: string;
+    /** currency: an ISO 4217 code. Default 'USD'. */
+    currency?: string;
+    /** currency: the value is in minor units (cents), as payment APIs send it, so 4900 is €49.00. Default true. */
+    minorUnits?: boolean;
+    /** duration: the unit the value is in. Default 'millisecond'. It's shown in the largest unit that keeps it at 1 or more. */
+    unit?: DurationUnit;
+    /** bytes: 1000 (kB, MB, GB; the default) or 1024 (KiB, MiB, GiB). */
+    base?: 1000 | 1024;
+}
+/** The text, the exact value (when the text rounds or abbreviates it) and the words for a symbol that's ambiguous read aloud. */
+export declare function describeNumber(value: number, options?: FormatNumberOptions): {
+    text: string;
+    full?: string;
+    spoken?: string;
+};
+/** Formats a number once, the way FormattedNumber does: for DataTable columns, chart formatters and plain strings. */
+export declare const formatNumber: (value: number, options?: FormatNumberOptions) => string;
+export interface FormattedNumberProps extends FormatNumberOptions {
+    value: number;
+    className?: string;
+    style?: React.CSSProperties;
+    id?: string;
+    /** Default: the exact value, when the text rounds or abbreviates it. */
+    title?: string;
+}
+/**
+ * A number is the record, so it lies flush: tabular figures, the exact value on hand when it's rounded or abbreviated,
+ * and units spoken in words. A changed value cross-fades and settles with the afterglow; it never counts.
+ */
+export declare function FormattedNumber({ value, className, style, id, title, ...options }: FormattedNumberProps): React.JSX.Element;

package/dist/types/heatmap.d.ts

@@ -0,0 +1,64 @@
+import * as React from 'react';
+import { type ChartConfig, type ChartContextValue, type ChartDatum, type ChartEmpty, type ChartInfo, type ChartReadout } from './chart.js';
+export interface HeatmapProps {
+    /** The records: one per cell. Cells with no record, or a null value, are drawn as "No data". */
+    data: ChartDatum[] | null | undefined | PromiseLike<ChartDatum[] | null>;
+    /** 'grid' (default): x across, y down. 'calendar': a cell per day, a column per week, wrapping by week when it's narrow. */
+    variant?: 'grid' | 'calendar';
+    /** The grid's column key (hour, region). */
+    x?: string;
+    /** The grid's row key (weekday, service). */
+    y?: string;
+    /** The calendar's day key: an ISO date, a timestamp or a Date. */
+    date?: string;
+    /** The key of each cell's value. It must also be a key of the container's config, which names and formats it. */
+    value: string;
+    /**
+     * Where each step starts, lowest first: `[0, 1, 4, 10]` gives "0", "1–3", "4–9" and "10+". Two to seven steps.
+     * Default: five to seven even steps over the values, with zero a step of its own for counts.
+     */
+    bins?: number[];
+    /** 'sequential' (default): how much, on the data-seq ramp. 'diverging': which side of `midpoint`, on the data-div ramp. */
+    scale?: 'sequential' | 'diverging';
+    /** The diverging scale's neutral value. Default 0. */
+    midpoint?: number;
+    /** Formats the grid's column values (14 → "14:00"). */
+    xFormat?: (value: unknown) => string;
+    /** Formats the grid's row values. */
+    yFormat?: (value: unknown) => string;
+    /** The calendar's first day of the week: 0 Sunday (default) or 1 Monday. */
+    weekStart?: 0 | 1;
+    /** The steps as swatches with their ranges in words, under the cells. Default true. */
+    legend?: boolean;
+    /** The readout. Default true. */
+    tooltip?: boolean;
+    /** Filter in place: which cells match. Misses recede to 35%, keeping their place and colour. */
+    relevance?: (d: ChartDatum) => 'match' | 'miss' | undefined;
+    /** The selected cell: its record, or its id ("14|Tue" for a grid's x and y, "2026-03-14" for a calendar's day). */
+    selected?: ChartDatum | string | null;
+    /** Makes cells selectable: called with the chosen record, or null when the selection clears. */
+    onSelect?: (d: ChartDatum | null) => void;
+    /** Makes cells open a level down, inside a Drilldown: return the id of the current node's child this cell opens. */
+    drill?: (d: ChartDatum) => string | null | undefined;
+    /** What the plot says when there's no data. */
+    empty?: ChartEmpty;
+    /** A ChartTooltip, to change what the readout shows. */
+    children?: React.ReactNode;
+}
+/**
+ * A value per cell across two dimensions: load by hour and weekday, activity by day over a year. The cells are the
+ * record, so they lie flat on the plot: a data-seq step (or data-div around a midpoint), parted by 2px of the plot's
+ * own colour, never raised, never shaded. Each step also has a pattern density for forced colours and print, and its
+ * range in words in the legend, the cell's name and the table.
+ */
+export declare function Heatmap(props: HeatmapProps): React.JSX.Element | null;
+export declare namespace Heatmap {
+    var chartPoint: (props: Record<string, unknown>, ctx: ChartContextValue, d: ChartDatum) => [number, number];
+    var chartBox: (props: Record<string, unknown>, ctx: ChartContextValue, d: ChartDatum) => [number, number, number, number] | null;
+    var chartMark: (props: Record<string, unknown>, ctx: ChartContextValue, d: ChartDatum) => string | null;
+    var chartNearest: (props: Record<string, unknown>, ctx: ChartContextValue, px: number, py: number) => number | null;
+    var chartMove: (props: Record<string, unknown>, ctx: ChartContextValue, i: number, e: React.KeyboardEvent) => number | null;
+    var chartName: (props: Record<string, unknown>, ctx: ChartContextValue, d: ChartDatum) => string;
+    var chartReadout: (props: Record<string, unknown>, ctx: ChartContextValue, d: ChartDatum) => ChartReadout;
+    var chartInfo: (props: Record<string, unknown>, config: ChartConfig) => ChartInfo;
+}

package/dist/types/in-place.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+/** A change of size at one level: dur-travel-3 up to 120px, then a little longer per pixel (capped), so a long push stays readable. */
+export declare const glideMs: (el: Element, distance: number) => number;
+/** Where a value's text starts: an input's content box, or the first line of text inside anything else. */
+export declare function textOrigin(el: Element): {
+    x: number;
+    y: number;
+};
+/**
+ * Call the returned capture() just before a state change that alters the box. After that render:
+ * - the box's own height glides from the old value to the new one, so everything below is pushed continuously, not jumped;
+ * - with `widths`, the box's one [data-slot] glides its width, even when the read slot was replaced by the editor's (a
+ *   well growing sideways from its text). Only for a slot whose siblings don't depend on its width;
+ * - parts marked [data-arrive] fade in as the moving edge reaches them;
+ * - with `values`, each [data-field] control whose read value ([data-value-for]) was somewhere else fades in, while
+ *   controls whose text lands where their value was simply appear: nothing slides, so nothing seems to jump around.
+ * Under reduced motion (--alt-travel 0) the new layout applies at once.
+ */
+export declare function useInPlaceMotion(box: React.RefObject<HTMLElement | null>, { widths, values }?: {
+    widths?: boolean | undefined;
+    values?: boolean | undefined;
+}): () => void;
+/** A polite status for assistive technology, cleared after dur-linger so nothing lingers in the accessibility tree. */
+export declare function useLingeringStatus(): readonly [string, (next: string) => void];

package/dist/types/index.d.ts

@@ -1,20 +1,163 @@
 /**
- * altitude-design: a React component library where height is the interface.
+ * altitude-design: a design framework where height is the interface.
+ * Task guidance: altitude-design/guidance (or dist/guidance/README.md).
+ * Discover patterns: altitude patterns "edit settings". Connect agents: altitude init --client codex.
+ * Pattern hooks are exported here, sharing the same AltitudeProvider instance.
  * Docs and live previews: https://richlaconte.github.io/altitude/storybook/
  * Bugs, feature requests and new components: https://github.com/richlaconte/altitude/issues/new/choose
  * Agents: you may file issues too; see https://github.com/richlaconte/altitude/blob/main/AGENTS.md
  */
-export { AltitudeProvider, useAltitude, useDepth, useApproach, riseDelay, Layer, Surface, Kbd, Icons, Spinner, deriveAccent, contrast, checkScheme, usePresence } from './core';
-export type { Scheme, BuiltInScheme, CustomScheme, SchemeColorToken, SchemeShadowToken } from './core';
-export { Button, Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, Input, Textarea, Field, Checkbox, RadioGroup, Radio, Switch, Tabs, TabsList, TabsTrigger, TabsContent, Slider, Progress, Badge, Avatar, AvatarGroup, Skeleton, Alert, AlertStack, Accordion, HoldButton, ScrollArea, DropZone, SortableList, } from './controls';
-export { Pile } from './pile';
-export { Tooltip, HoverCard, Popover, DropdownMenu, Dialog, Toaster, toast } from './overlays';
-export { Drilldown } from './nav';
-export { Sheet, SheetHeader, SheetTitle, SheetDescription, SheetFooter } from './sheet';
-export { CommandPalette, commandScore } from './command';
-export { Select, SelectItem, Combobox } from './select';
-export { Stepper } from './stepper';
-export { EmptyState } from './empty';
-export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, DataTable, Board, BoardColumn, BoardCard } from './collections';
-export { Await, RevealGroup, readPromised, LoadingScope } from './suspense';
-export type { Promised, Pending, SkeletonOption, AwaitProps } from './suspense';
+export { ModeContext } from './core.js';
+export type { AppMode } from './core.js';
+export { PrimaryScope } from './core.js';
+export { AltitudeProvider, useAltitude, useDepth, useApproach, riseDelay, Layer, Surface, Kbd, useKeyboardLikely, Icons, Spinner, deriveAccent, contrast, checkScheme, usePresence } from './core.js';
+export type { Scheme, BuiltInScheme, RetiredScheme, CustomScheme, SchemeColorToken, SchemeShadowToken, DataColorToken, SchemeCheck } from './core.js';
+export { Button, Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, Input, Textarea, Field, Checkbox, RadioGroup, Radio, Switch, Tabs, TabsList, TabsTrigger, TabsContent, Slider, Progress, Badge, Avatar, AvatarGroup, Skeleton, Alert, AlertStack, Accordion, HoldButton, ScrollArea, DropZone, SortableList, } from './controls.js';
+export type { UploadItem } from './controls.js';
+export { Pile } from './pile.js';
+export { Separator } from './separator.js';
+export { Link } from './link.js';
+export { FormattedNumber, formatNumber, describeNumber } from './formatted-number.js';
+export type { FormatNumberOptions, NumberFormatPreset, DurationUnit } from './formatted-number.js';
+export { RelativeTime, formatRelativeTime } from './relative-time.js';
+export { Timeline, TimelineItem } from './timeline.js';
+export { NotificationCenter, NotificationList } from './notifications.js';
+export type { NotificationEntry } from './notifications.js';
+export { SyncIndicator } from './sync-indicator.js';
+export type { SyncState } from './sync-indicator.js';
+export { DiffView, diffChanges, diffLines } from './diff-view.js';
+export type { DiffField } from './diff-view.js';
+export { SaveBar } from './save-bar.js';
+export { SettingsSection, SettingsRow } from './settings.js';
+export { PermissionMatrix } from './permission-matrix.js';
+export type { MatrixRole, MatrixPermission, MatrixInherited } from './permission-matrix.js';
+export { PlanPicker } from './plan-picker.js';
+export type { Plan } from './plan-picker.js';
+export { FeatureGate } from './feature-gate.js';
+export { CommentThread } from './comment-thread.js';
+export type { ThreadComment, Mentionable } from './comment-thread.js';
+export { Tour } from './tour.js';
+export type { TourStep } from './tour.js';
+export { PromptInput, PromptInputTextarea, PromptInputAttachments, PromptInputToolbar, PromptInputAttach, PromptInputSubmit, PromptInputDictate } from './prompt-input.js';
+export type { PromptStatus, PromptAttachment, PromptMessage } from './prompt-input.js';
+export { Conversation, ConversationContent, ConversationScrollButton, Message, MessageContent, MessageActions, MessageAttachments, ConversationQueue, ConversationCheckpoint } from './conversation.js';
+export type { MessageStatus } from './conversation.js';
+export { Confirmation } from './confirmation.js';
+export type { ConfirmationState } from './confirmation.js';
+export { Trace, TraceParallel, TraceStep, TraceToolCall, TraceReasoning } from './trace.js';
+export type { TraceStepStatus } from './trace.js';
+export type { SuggestionProps } from './controls.js';
+export { AILabel } from './ai-label.js';
+export type { AISource } from './ai-label.js';
+export { InlineCitation, Sources } from './inline-citation.js';
+export { Artifact, ArtifactHeader, ArtifactVersions, ArtifactContent, ArtifactReference } from './artifact.js';
+export type { ArtifactProps, ArtifactHeaderProps, ArtifactVersionsProps, ArtifactContentProps, ArtifactReferenceProps, ArtifactStatus } from './artifact.js';
+export { ThreadList, ThreadListGroup, ThreadListItem, ThreadListNew, groupByDate } from './thread-list.js';
+export type { ThreadListProps, ThreadListItemProps, ThreadListGroupProps, ThreadStatus } from './thread-list.js';
+export { AgentFleet, AgentFleetGroup, AgentFleetItem, AgentRequests, AgentRequest, AgentLanes, summarizeFleet, groupAgents, needsYou, formatSpan } from './agent-fleet.js';
+export type { AgentFleetProps, AgentFleetGroupProps, AgentFleetItemProps, AgentRequestsProps, AgentRequestProps, AgentLanesProps, AgentLane, AgentLaneState, AgentState, AgentNeeds } from './agent-fleet.js';
+export { Question, QuestionOption, QuestionSet } from './question.js';
+export type { QuestionProps, QuestionOptionProps, QuestionSetProps, QuestionAnswer, QuestionState } from './question.js';
+export { Terminal } from './terminal.js';
+export type { TerminalProps, TerminalChunk } from './terminal.js';
+export { Suggestions, Suggestion } from './suggestions.js';
+export type { SuggestionsProps, SuggestionItemProps } from './suggestions.js';
+export { Markdown, parseMarkdown, safeUrl } from './markdown.js';
+export type { MarkdownProps, MarkdownComponents } from './markdown.js';
+export type { CitationSource } from './inline-citation.js';
+export type { RelativeTimeOptions } from './relative-time.js';
+export { CopyButton } from './copy-button.js';
+export { Toggle, ToggleGroup, ToggleGroupItem } from './toggle.js';
+export { Toolbar, ToolbarGroup, ToolbarSeparator, ToolbarButton, ToolbarToggle } from './toolbar.js';
+export { SplitButton } from './split-button.js';
+export { NumberInput, parseNumber } from './number-input.js';
+export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator } from './input-otp.js';
+export { TimeInput } from './time-input.js';
+export { PasswordInput } from './password-input.js';
+export type { PasswordRequirement } from './password-input.js';
+export { SecretField } from './secret-field.js';
+export { CodeBlock } from './code-block.js';
+export type { CodeBlockTab } from './code-block.js';
+export { ColorPicker, ColorSwatchPicker } from './color-picker.js';
+export type { ColorSwatch } from './color-picker.js';
+export { Tooltip, HoverCard, Popover, DropdownMenu, Dialog, Toaster, toast } from './overlays.js';
+export { Drilldown, useDrilldown } from './nav.js';
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis } from './breadcrumb.js';
+export type { BreadcrumbEntry } from './breadcrumb.js';
+export { Pagination, pageRange } from './pagination.js';
+export { PageHeader, PageHeaderTitle, PageHeaderDescription } from './page-header.js';
+export { AppShell, SidebarProvider, Sidebar, SidebarHeader, SidebarContent, SidebarGroup, SidebarGroupLabel, SidebarMenu, SidebarMenuItem, SidebarMenuButton, SidebarMenuBadge, SidebarFooter, SidebarTrigger, SidebarInset, useSidebar } from './app-shell.js';
+export { Sheet, SheetHeader, SheetTitle, SheetDescription, SheetFooter } from './sheet.js';
+export { ResizablePanelGroup, ResizablePanel, ResizableHandle } from './resizable.js';
+export { ContextMenu } from './context-menu.js';
+export { CommandPalette, commandScore } from './command.js';
+export { Select, SelectItem, Combobox } from './select.js';
+export { Stepper } from './stepper.js';
+export { EmptyState } from './empty.js';
+export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, DataTable, Board, BoardColumn, BoardCard } from './collections.js';
+export type { DataTablePaging, TableSelection } from './collections.js';
+export { Await, RevealGroup, readPromised, LoadingScope } from './suspense.js';
+export type { Promised, Pending, SkeletonOption, AwaitProps } from './suspense.js';
+export type { AvatarProps, AvatarGroupProps } from './controls.js';
+export { InlineEdit } from './inline-edit.js';
+export type { InlineEditControl, InlineEditProps, InlineEditSaveResult } from './inline-edit.js';
+export { EditRegion, EditRegionView, EditRegionValue, EditRegionForm, EditRegionTrigger, EditRegionActions } from './edit-region.js';
+export type { EditRegionProps, EditRegionSaveResult, EditRegionBinder } from './edit-region.js';
+export { TagInput, Tag } from './tag-input.js';
+export type { TagInputProps, TagProps, TagResult } from './tag-input.js';
+export { DatePicker, DateRangePicker, Calendar, datePresets } from './date-picker.js';
+export type { DatePickerProps, DateRangePickerProps, CalendarProps, DateRange, ISODate, DatePreset } from './date-picker.js';
+export { Tree } from './tree.js';
+export type { TreeProps, TreeHandle, TreeMove, TreeTarget, TreeResult, TreeCreateResult } from './tree.js';
+export { Checklist } from './checklist.js';
+export type { ChecklistProps, ChecklistOp, ChecklistPlace, ChecklistResult } from './checklist.js';
+export { FilterBar, filterValueText, filterSentence } from './filter-bar.js';
+export type { FilterTree, FilterGroup } from './filter-bar.js';
+export { SavedViews, useSavedViews } from './saved-views.js';
+export type { SavedView, ViewState, SavedViewsApi, SavedViewsOptions } from './saved-views.js';
+export type { FilterBarProps, FilterField, FilterOption, Filter, FilterValue } from './filter-bar.js';
+export { Schedule } from './schedule.js';
+export type { ScheduleProps, ScheduleSpan, ScheduleResult, ScheduleCreateResult, LocalDateTime } from './schedule.js';
+export { DataGrid } from './data-grid.js';
+export type { DataGridProps, DataGridColumn, DataGridChange, DataGridResult, DataGridEditorControl } from './data-grid.js';
+export { RemovalReceipt } from './removal-receipt.js';
+export type { RemovalReceiptProps } from './removal-receipt.js';
+export { ItemGroup, Item, ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemActions, ItemSeparator } from './item-group.js';
+export type { ItemGroupProps, ItemGroupRemoval, ItemGroupResult, ItemGroupCreateResult, ItemActionsApi } from './item-group.js';
+export type { BoardCreateResult, BoardRenameResult } from './collections.js';
+export { PropertyList, PropertyListItem } from './property-list.js';
+export type { PropertyListProps, PropertyListItemProps, PropertyListEditAll } from './property-list.js';
+export { ChartContainer, ChartMarker, ChartReference, ChartAnnotation, ChartRelevance, ChartStatusClip, CHART_STATUS_WORDS, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, useChart } from './chart.js';
+export { BarChart } from './bar-chart.js';
+export { LineChart, linePath, windowed } from './line-chart.js';
+export type { LineChartProps, ChartWindow } from './line-chart.js';
+export { AreaChart } from './area-chart.js';
+export { Heatmap } from './heatmap.js';
+export type { HeatmapProps } from './heatmap.js';
+export { ScatterChart } from './scatter-chart.js';
+export type { ScatterChartProps } from './scatter-chart.js';
+export { DotPlot } from './dot-plot.js';
+export type { DotPlotProps } from './dot-plot.js';
+export { ChartBrush } from './chart-brush.js';
+export type { ChartBrushProps } from './chart-brush.js';
+export type { AreaChartProps } from './area-chart.js';
+export { Sparkline } from './sparkline.js';
+export type { SparklineProps } from './sparkline.js';
+export { Stat, StatGroup } from './stat.js';
+export type { StatProps, StatChange, StatGroupProps } from './stat.js';
+export { Meter } from './meter.js';
+export type { MeterProps, MeterSegment } from './meter.js';
+export { BarList } from './bar-list.js';
+export type { BarListProps, BarListItem } from './bar-list.js';
+export type { BarChartProps } from './bar-chart.js';
+export type { ChartConfig, ChartSeriesConfig, ChartSlot, ChartSeries, ChartDatum, ChartContextValue, ChartContainerProps, ChartXScale, LinearScale, TimeScale, BandScale, ChartStage, ChartEncoding, ChartMarkerShape, ChartTooltipItem, ChartTooltipContentProps, ChartLegendItem, ChartLegendContentProps, ChartEmpty, ChartStatus, ChartReferenceProps, ChartAnnotationProps } from './chart.js';
+export { useEditRecord, ErrorSummary, WorkflowStatus } from './pattern-edit-record.js';
+export type { FieldErrors, EditRecordResult, EditRecordPhase, EditRecordOptions, LeaveReason, ErrorSummaryProps } from './pattern-edit-record.js';
+export { useAsyncCollection } from './pattern-async-collection.js';
+export type { AsyncCollectionOptions, CollectionPhase } from './pattern-async-collection.js';
+export { useConsequentialAction } from './pattern-consequential-action.js';
+export { useAssistantTurn, AssistantError, assistantErrorText } from './pattern-assistant-conversation.js';
+export type { AssistantTurn, AssistantTurnOptions, AssistantTurnState, AssistantTurnError, AssistantErrorKind } from './pattern-assistant-conversation.js';
+export type { ConsequentialActionOptions, ConsequentialPhase, ActionResult, UndoResult } from './pattern-consequential-action.js';
+export { useReviewSubmit } from './pattern-review-submit.js';
+export type { ReviewSubmitOptions, ReviewSubmitResult } from './pattern-review-submit.js';

package/dist/types/inline-citation.d.ts

@@ -0,0 +1,35 @@
+import * as React from 'react';
+export interface CitationSource {
+    title: string;
+    url?: string;
+    /** A passage from the source. */
+    excerpt?: string;
+    /** The source couldn't be verified: a caution mark and "Unverified source". */
+    unverified?: boolean;
+}
+export interface InlineCitationProps {
+    /** Its number, counted from 1, matching the Sources list. */
+    index: number;
+    source: CitationSource;
+    /** Where it goes. Default the source's entry in Sources (`#<idPrefix>-<index>`). */
+    href?: string;
+    /** Shared with Sources. Default "source". */
+    idPrefix?: string;
+    className?: string;
+}
+/**
+ * A numbered source marker in generated text. A citation is part of the record, so it's a small flush plate (the
+ * ChartAnnotation build) in the text; it acts, so it lifts one level when pointed at, and a HoverCard previews the
+ * source on hover and on focus. Named "Source 2: Billing FAQ", never "[2]".
+ */
+export declare function InlineCitation({ index, source, href, idPrefix, className }: InlineCitationProps): React.JSX.Element;
+export interface SourcesProps {
+    items: CitationSource[];
+    /** Default "Sources". */
+    heading?: string;
+    /** Shared with InlineCitation. Default "source". */
+    idPrefix?: string;
+    className?: string;
+}
+/** The sources an answer cites, as a flush ordered list under a heading; each entry is a citation's destination. */
+export declare function Sources({ items, heading, idPrefix, className }: SourcesProps): React.JSX.Element;

package/dist/types/inline-edit.d.ts

@@ -0,0 +1,71 @@
+import * as React from 'react';
+export type InlineEditSaveResult<V = string> = {
+    ok: true;
+    value: V;
+} | {
+    ok: false;
+    error: string;
+};
+/** Spread onto any Altitude control (Select, Combobox, Switch through a small adapter, a numeric Input). */
+export interface InlineEditControl<V> {
+    value: V;
+    onValueChange: (value: V) => void;
+    id: string;
+    'aria-describedby'?: string;
+    invalid: boolean;
+    /** True while checking, saving or blocked by a conflict: changes are ignored until it clears. */
+    readOnly: boolean;
+    disabled: boolean;
+    autoFocus: true;
+}
+export interface InlineEditProps<V = string> {
+    value: V;
+    onValueChange: (canonicalValue: V) => void;
+    onSave: (draft: V, context: {
+        previousValue: V;
+    }) => InlineEditSaveResult<V> | Promise<InlineEditSaveResult<V>>;
+    label: string;
+    validate?: (draft: V) => string | undefined | Promise<string | undefined>;
+    required?: boolean;
+    maxLength?: number;
+    disabled?: boolean;
+    editLabel?: string;
+    saveLabel?: string;
+    cancelLabel?: string;
+    focusFallback?: () => HTMLElement | null;
+    className?: string;
+    /** Read mode. Default: the value as text, or “Not set” when empty. */
+    renderValue?: (value: V) => React.ReactNode;
+    /** Edit mode. Default: the existing Input for a string. */
+    editor?: (control: InlineEditControl<V>) => React.ReactNode;
+    /** 'on-choose' saves as soon as a single-choice editor reports a value; Save is hidden. Default 'explicit'. */
+    commit?: 'explicit' | 'on-choose';
+    /** An unchanged draft closes without a write, and an equal observed value isn't an external change. Default Object.is. */
+    isEqual?: (a: V, b: V) => boolean;
+    /** A Textarea instead of the Input: Enter inserts a newline and Ctrl/Cmd+Enter saves. Default false. */
+    multiline?: boolean;
+    /** With multiline, the textarea's initial height in lines. Default 3. */
+    rows?: number;
+    /** With multiline, the textarea grows with its content up to this many lines, then scrolls. Default 12. */
+    maxRows?: number;
+    /**
+     * How editing starts. 'button' (default): the value, then a visible Edit button. The others make the value its own
+     * button, named “<label>: <value>. <editLabel>”: 'value' a plate that lifts on hover, 'pencil' a pencil shown on hover
+     * or focus, 'field' the input's own border and floor drawn on hover, and a click puts the caret where it landed.
+     */
+    trigger?: 'button' | 'value' | 'pencil' | 'field';
+    /** With trigger 'value', 'pencil' or 'field': 'seam' scores a faint groove under the value at rest, where its well will open, so people know to point at it. Default 'none'. */
+    hint?: 'none' | 'seam';
+    /** Shown for an empty value. Default “Not set”. */
+    emptyLabel?: string;
+    /** Single-key shortcut announced on the trigger (aria-keyshortcuts); the surrounding list handles the key. */
+    shortcut?: string;
+    /** How long a saved value's afterglow takes to fade, in ms. Default 5000. */
+    settleDuration?: number;
+}
+/**
+ * One local editing session. The application remains the sole owner of the committed value and write. Editing happens
+ * in place: the value's text sits in a slot with the control's own inset and font, so when the control opens there, the
+ * text doesn't move; only the well (floor, walls, border) fades in around it. Whatever still changes size glides.
+ */
+export declare function InlineEdit<V = string>({ value, onValueChange, onSave, label, validate, required, maxLength, disabled, editLabel, saveLabel, cancelLabel, focusFallback, className, renderValue, editor, commit, isEqual, multiline, rows, maxRows, trigger: triggerMode, hint, emptyLabel, shortcut, settleDuration }: InlineEditProps<V>): React.ReactElement;