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

package/dist/types/progress-indicator/progress-bar.d.ts

@@ -0,0 +1,30 @@
+
+
+import type { ProgressBarProps } from './progress-indicator.types';
+/**
+ * The linear recipe: a quantity along a track, or a wait travelling it.
+ *
+ * The shape is M3's from 2024 onward — a fully rounded indicator, a gap of one
+ * thickness before the track it has not reached, and a stop indicator marking
+ * where the bar is going. The gap and the dot are what make a bar at four per
+ * cent read as four per cent of something rather than as a stray mark, and no
+ * other surveyed implementation draws either.
+ *
+ * `placement="page"` is the whole of what the deleted `loading-bar` family
+ * was: the same bar pinned to the top edge of the viewport, with no corner to
+ * round and a transparent track, because a permanent grey band across the top
+ * of a page reads as a rule under the header rather than as a wait.
+ * `edge-start` and `edge-end` are the same bar on an edge of the nearest
+ * positioned box, which is the frame `app-shell` and `page-header` render as
+ * their `progress` part.
+ *
+ * With `wave` the indicator is an `svg` over the whole track and one stroked
+ * path inside it, M3's sine from `@slotted/core/progress`: the stylesheet
+ * shows a window of it with a dash, so the bar ends in its own crest with a
+ * round cap. The viewBox states one unit as one thickness and `pathLength`
+ * states the path's reach along the inline axis, which is what makes a dash of
+ * one unit one thickness of travel whatever the amplitude. An indeterminate
+ * bar carries the tighter wave M3 draws while the value is unknown.
+ */
+export declare function ProgressBar({ 'aria-hidden': ariaHidden, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, buffer, decorative, delay, format, hideLabel, label, loading, locale, max, min, minDuration, onWithdraw, placement, render, showValue, size, style, tone, value, valueText, wave, ...nativeProps }: ProgressBarProps): 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;
+//# sourceMappingURL=progress-bar.d.ts.map

package/dist/types/progress-indicator/progress-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar.d.ts","sourceRoot":"","sources":["../../../src/progress-indicator/progress-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,2DAA2D,CAAC;AACnE,OAAO,qDAAqD,CAAC;AAU7D,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,4BAA4B,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,aAAa,EAAE,UAAU,EACzB,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,MAAM,EACN,UAAkB,EAClB,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAc,EACd,MAAM,EACN,GAAG,EACH,GAAG,EACH,WAAW,EACX,UAAU,EACV,SAAoB,EACpB,MAAM,EACN,SAAS,EACT,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,KAAK,EACL,SAAS,EACT,IAAY,EACZ,GAAG,WAAW,EACf,EAAE,gBAAgB,+VAgElB"}

package/dist/types/progress-indicator/progress-circle.d.ts

@@ -0,0 +1,25 @@
+
+
+import type { ProgressCircleProps } from './progress-indicator.types';
+/**
+ * The circular recipe, and with no value the spinner every surveyed library
+ * ships under that name.
+ *
+ * Two concentric shapes in one `48 48` box, each carrying `pathLength="100"`
+ * so a dash length *is* the percentage and the stylesheet needs no arithmetic
+ * of its own. The stroke is stated in the viewBox's own units, which makes it
+ * one eighth of the diameter at every size — the ratio `button` derived for
+ * its own loading ring, so the ring in a button and this circle are the same
+ * object.
+ *
+ * The number sits beside the ring rather than inside it: the largest ring this
+ * family draws is 38 pixels across with a 4.75-pixel stroke, which leaves 28
+ * pixels of hole, and a percentage centred in it would be four-pixel type. Ant
+ * Design and MUI both put it inside because both draw rings twice this size.
+ *
+ * With `wave` the indicator is M3's wavy ring from `@slotted/core/progress`
+ * and the track stays a circle, which is what `CircularWavyProgressModifiers`
+ * draws: only the active indicator morphs.
+ */
+export declare function ProgressCircle({ 'aria-hidden': ariaHidden, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, decorative, delay, format, hideLabel, label, loading, locale, max, min, minDuration, onWithdraw, render, showValue, size, style, tone, value, valueText, wave, ...nativeProps }: ProgressCircleProps): 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;
+//# sourceMappingURL=progress-circle.d.ts.map

package/dist/types/progress-indicator/progress-circle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-circle.d.ts","sourceRoot":"","sources":["../../../src/progress-indicator/progress-circle.tsx"],"names":[],"mappings":"AAAA,OAAO,2DAA2D,CAAC;AACnE,OAAO,qDAAqD,CAAC;AAM7D,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EAAE,UAAU,EACzB,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,UAAkB,EAClB,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAc,EACd,MAAM,EACN,GAAG,EACH,GAAG,EACH,WAAW,EACX,UAAU,EACV,MAAM,EACN,SAAS,EACT,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,KAAK,EACL,SAAS,EACT,IAAY,EACZ,GAAG,WAAW,EACf,EAAE,mBAAmB,+VAuDrB"}

package/dist/types/progress-indicator/progress-indicator-defaults.d.ts

@@ -0,0 +1,16 @@
+import type { ProgressIndicatorDefaults, ProgressIndicatorDefaultsProviderProps } from './progress-indicator.types';
+export declare function useProgressIndicatorDefaults(): ProgressIndicatorDefaults;
+/**
+ * An application decides once how its indicators are sized and toned, how long
+ * a wait has to last before one appears, how long one is held once it has, and
+ * which language writes the digits. An indicator that states any of those still
+ * wins: an explicit prop is never overridden by context.
+ *
+ * The timing belongs here more than anywhere else, for the reason `skeleton`
+ * recorded about the same machine: it is a policy about latency, and latency is
+ * a property of the application rather than of the bar. The reference page
+ * recommends `delay={200} minDuration={400}` set once, and the family ships
+ * both at zero because it cannot know.
+ */
+export declare function ProgressIndicatorDefaultsProvider({ children, ...defaults }: ProgressIndicatorDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=progress-indicator-defaults.d.ts.map

package/dist/types/progress-indicator/progress-indicator-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-indicator-defaults.d.ts","sourceRoot":"","sources":["../../../src/progress-indicator/progress-indicator-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,yBAAyB,EACzB,sCAAsC,EACvC,MAAM,4BAA4B,CAAC;AAIpC,wBAAgB,4BAA4B,IAAI,yBAAyB,CAExE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iCAAiC,CAAC,EAChD,QAAQ,EACR,GAAG,QAAQ,EACZ,EAAE,sCAAsC,+BAiBxC"}

package/dist/types/progress-indicator/progress-indicator.types.d.ts

@@ -0,0 +1,117 @@
+import type { ComponentPropsWithRef, ReactNode } from 'react';
+export type ProgressSize = 'sm' | 'md' | 'lg';
+export type ProgressTone = 'accent' | 'secondary' | 'success' | 'warning' | 'danger';
+export type ProgressPlacement = 'inline' | 'page' | 'edge-start' | 'edge-end';
+/** The geometry a component draws. Written to `data-shape`, never chosen. */
+export type ProgressShape = 'linear' | 'circular' | 'morph';
+/**
+ * What every indicator in an application looks like, and how a wait is timed,
+ * before any of them states anything of its own.
+ *
+ * The two durations are here rather than on an indicator because the policy is
+ * an application's: a team decides once that a wait under two hundred
+ * milliseconds is not worth reporting, and every bar inherits it. `locale` is
+ * here for the same reason — the digits of a percentage belong to the
+ * application's language, not to one upload.
+ */
+export interface ProgressIndicatorDefaults {
+    delay?: number | undefined;
+    label?: string | undefined;
+    locale?: string | undefined;
+    minDuration?: number | undefined;
+    size?: ProgressSize | undefined;
+    tone?: ProgressTone | undefined;
+}
+export interface ProgressIndicatorDefaultsProviderProps extends ProgressIndicatorDefaults {
+    children?: ReactNode;
+}
+/** What all three components share. */
+interface ProgressCommonProps {
+    /**
+     * Whether the wait is still on. `false` withdraws the indicator, honouring
+     * `minDuration`.
+     */
+    loading?: boolean;
+    /** Milliseconds the wait must last before anything is painted. */
+    delay?: number;
+    /** Milliseconds an indicator that did appear is held before it is withdrawn. */
+    minDuration?: number;
+    /**
+     * The moment the indicator actually leaves the page, which is later than
+     * `loading` turning false whenever `minDuration` is holding it. It is what an
+     * application unmounts the surrounding card on.
+     */
+    onWithdraw?: () => void;
+    /** The rendered accessible name. */
+    label?: string;
+    /** Clips the label and keeps it as the name. Implied by every placement but `inline`. */
+    hideLabel?: boolean;
+    /**
+     * Takes the indicator out of the accessibility tree: no role, no range, no
+     * name. For the one case the feature guide names — a spinner beside text
+     * that already says what is happening.
+     */
+    decorative?: boolean;
+    size?: ProgressSize;
+    tone?: ProgressTone;
+}
+/** What the two measured components add. */
+interface ProgressMeasuredProps extends ProgressCommonProps {
+    /** The quantity. `null` — the default — is indeterminate. */
+    value?: number | null;
+    min?: number;
+    max?: number;
+    /** Whether the formatted number is rendered beside the name. */
+    showValue?: boolean;
+    /** A string the family cannot compute: “3 of 7 files”, “about a minute left”. */
+    valueText?: string;
+    /** How the number is written. Absent, the ratio is written as a percentage. */
+    format?: Intl.NumberFormatOptions;
+    /** BCP 47. Absent, the provider's, then the runtime's own. */
+    locale?: string;
+    /** M3 Expressive's wavy active indicator. */
+    wave?: boolean;
+}
+/**
+ * The attributes every root carries. A `render` prop receives exactly this, so
+ * a substituted element keeps the identity, the role, the range and the state.
+ */
+export interface ProgressRootProps extends ComponentPropsWithRef<'div'> {
+    'aria-hidden': boolean | 'true' | 'false' | undefined;
+    'aria-labelledby': string | undefined;
+    'aria-valuemax': number | undefined;
+    'aria-valuemin': number | undefined;
+    'aria-valuenow': number | undefined;
+    'aria-valuetext': string | undefined;
+    children: ReactNode;
+    'data-complete': '' | undefined;
+    'data-indeterminate': '' | undefined;
+    'data-part': string;
+    'data-shape': ProgressShape;
+    'data-size': ProgressSize;
+    'data-tone': ProgressTone;
+    'data-ui': string;
+    hidden: true | undefined;
+    role: 'progressbar' | undefined;
+}
+export interface ProgressBarProps extends Omit<ComponentPropsWithRef<'div'>, 'children'>, ProgressMeasuredProps {
+    /** A second, further quantity: received but not yet processed. */
+    buffer?: number | null;
+    /**
+     * `page` pins the bar to the top edge of the viewport; `edge-start` and
+     * `edge-end` stand it on the block-start or block-end edge of the nearest
+     * positioned box, over the line that edge draws.
+     */
+    placement?: ProgressPlacement;
+    render?: (props: ProgressRootProps) => ReactNode;
+}
+export interface ProgressCircleProps extends Omit<ComponentPropsWithRef<'div'>, 'children'>, ProgressMeasuredProps {
+    render?: (props: ProgressRootProps) => ReactNode;
+}
+export interface LoaderProps extends Omit<ComponentPropsWithRef<'div'>, 'children'>, ProgressCommonProps {
+    /** M3's fully rounded container behind the morphing shape. */
+    contained?: boolean;
+    render?: (props: ProgressRootProps) => ReactNode;
+}
+export {};
+//# sourceMappingURL=progress-indicator.types.d.ts.map

package/dist/types/progress-indicator/progress-indicator.types.d.ts.map

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

package/dist/types/progress-indicator/progress-parts.d.ts

@@ -0,0 +1,24 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { ResolvedProgressIndicator } from './use-progress-indicator';
+/**
+ * The name, rendered. It is a real element rather than an `aria-label` for the
+ * reason `spinner` recorded: a string in the template is the one a translation
+ * pass finds. `hideLabel` clips it with another family's one authored rule
+ * instead of a copy of the clip technique, which is the mechanism
+ * `status-indicator` established for its own announcement.
+ */
+export declare function progressLabel(resolved: ResolvedProgressIndicator): ReactNode;
+/**
+ * The formatted number, and only when there is one: an indeterminate indicator
+ * has no value to write, so the part is absent from the DOM rather than
+ * present and empty — which is what lets the grid's first row collapse.
+ */
+export declare function progressValue(resolved: ResolvedProgressIndicator): ReactNode;
+/**
+ * The percentage, as the custom properties every part of the stylesheet reads.
+ * It is a style rather than an attribute because it is a number the browser
+ * interpolates: the properties are registered, so one transition on the root
+ * moves the fill, the gap, the arc and the buffer together.
+ */
+export declare function progressStyle(resolved: ResolvedProgressIndicator, style: CSSProperties | undefined): CSSProperties;
+//# sourceMappingURL=progress-parts.d.ts.map

package/dist/types/progress-indicator/progress-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-parts.d.ts","sourceRoot":"","sources":["../../../src/progress-indicator/progress-parts.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAY5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAG5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,aAAa,CAQf"}

package/dist/types/progress-indicator/use-loading-visibility.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Drives the shared timing machine from React's clock, and reports the moment
+ * an indicator that was painted is withdrawn.
+ *
+ * The first answer is computed during render rather than in an effect, because
+ * an effect would paint one frame of the wrong state: with no delay set — the
+ * default — an indicator would flash absent for a frame on every mount, which
+ * is the defect this whole mechanism exists to prevent, reintroduced by the
+ * mechanism itself. `skeleton` recorded the finding for the same machine.
+ *
+ * A timer is scheduled only when the machine asks for one, so an application
+ * that sets neither duration pays for no timer at all.
+ */
+export declare function useLoadingVisibility({ delay, loading, minDuration, onWithdraw, }: {
+    delay: number;
+    loading: boolean;
+    minDuration: number;
+    onWithdraw?: (() => void) | undefined;
+}): boolean;
+//# sourceMappingURL=use-loading-visibility.d.ts.map

package/dist/types/progress-indicator/use-loading-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-loading-visibility.d.ts","sourceRoot":"","sources":["../../../src/progress-indicator/use-loading-visibility.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,OAAO,EACP,WAAW,EACX,UAAU,GACX,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACvC,GAAG,OAAO,CAiCV"}

package/dist/types/progress-indicator/use-progress-indicator.d.ts

@@ -0,0 +1,76 @@
+import type { ProgressGeometry } from '@slotted/core/progress';
+import type { ProgressShape, ProgressSize, ProgressTone } from './progress-indicator.types';
+export declare const PROGRESS_DEFAULT_SIZE: ProgressSize;
+export declare const PROGRESS_DEFAULT_TONE: ProgressTone;
+interface Request {
+    shape: ProgressShape;
+    /** The name of the component, for the one warning this family emits. */
+    component: string;
+    ariaHidden: boolean | 'true' | 'false' | undefined;
+    ariaLabel: string | undefined;
+    ariaLabelledBy: string | undefined;
+    decorative: boolean;
+    delay: number | undefined;
+    hideLabel: boolean | undefined;
+    label: string | undefined;
+    loading: boolean;
+    locale: string | undefined;
+    minDuration: number | undefined;
+    onWithdraw: (() => void) | undefined;
+    size: ProgressSize | undefined;
+    tone: ProgressTone | undefined;
+    /** Absent on the loader, which measures nothing. */
+    measure: {
+        value: number | null | undefined;
+        min: number | undefined;
+        max: number | undefined;
+        buffer: number | null | undefined;
+        format: Intl.NumberFormatOptions | undefined;
+        showValue: boolean | undefined;
+        valueText: string | undefined;
+    } | undefined;
+}
+export interface ResolvedProgressIndicator {
+    geometry: ProgressGeometry;
+    /** Whether anything is painted at all: `delay` may still be running. */
+    painted: boolean;
+    labelId: string;
+    labelText: string | undefined;
+    labelHidden: boolean;
+    /** The formatted number, or `undefined` when there is nothing to write. */
+    valueText: string | undefined;
+    showValue: boolean;
+    size: ProgressSize;
+    tone: ProgressTone;
+    /** Everything the root carries that does not depend on the shape. */
+    identity: {
+        'aria-hidden': boolean | 'true' | 'false' | undefined;
+        'aria-labelledby': string | undefined;
+        'aria-valuemax': number | undefined;
+        'aria-valuemin': number | undefined;
+        'aria-valuenow': number | undefined;
+        'aria-valuetext': string | undefined;
+        'data-complete': '' | undefined;
+        'data-indeterminate': '' | undefined;
+        'data-part': string;
+        'data-shape': ProgressShape;
+        'data-size': ProgressSize;
+        'data-tone': ProgressTone;
+        'data-ui': string;
+        hidden: true | undefined;
+        role: 'progressbar' | undefined;
+    };
+}
+/**
+ * One resolution for three components: the defaults, the timing, the geometry,
+ * the text and the identity.
+ *
+ * It is a hook rather than three copies because every one of those answers has
+ * to be the same in a bar, a ring and a loader — and because the two that are
+ * easiest to get subtly wrong are the two a test cannot see from outside: which
+ * `aria-value*` attributes are absent while a wait is indeterminate, and
+ * whether the painted percentage came from the same call as the announced one.
+ */
+export declare function useProgressIndicator({ ariaHidden, ariaLabel, ariaLabelledBy, component, decorative, delay, hideLabel, label, loading, locale, measure, minDuration, onWithdraw, shape, size, tone, }: Request): ResolvedProgressIndicator;
+export {};
+//# sourceMappingURL=use-progress-indicator.d.ts.map

package/dist/types/progress-indicator/use-progress-indicator.d.ts.map

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

package/dist/types/prompt-composer/index.d.ts

@@ -0,0 +1,4 @@
+export { PromptComposer, PromptComposerAction, PromptComposerAttach, PromptComposerFooter, PromptComposerHeader, PromptComposerInput, PromptComposerSubmit, } from './prompt-composer';
+export { PromptComposerDefaultsProvider, usePromptComposerDefaults, } from './prompt-composer-defaults';
+export type { PromptComposerActionProps, PromptComposerAttachDetail, PromptComposerAttachProps, PromptComposerBandProps, PromptComposerDefaults, PromptComposerDefaultsProviderProps, PromptComposerInputProps, PromptComposerProps, PromptComposerRootProps, PromptComposerSize, PromptComposerStatus, PromptComposerSubmitOn, PromptComposerSubmitProps, PromptComposerSubmitReason, PromptComposerValueReason, PromptComposerVariant, } from './prompt-composer.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/prompt-composer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompt-composer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,mCAAmC,EACnC,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/types/prompt-composer/prompt-composer-defaults.d.ts

@@ -0,0 +1,9 @@
+import type { PromptComposerDefaults, PromptComposerDefaultsProviderProps } from './prompt-composer.types';
+export declare function usePromptComposerDefaults(): PromptComposerDefaults;
+/**
+ * An application decides once how its composers look and which key sends. A
+ * composer that states any of them itself still wins. What the buttons say
+ * comes from the language in force (`SlottedProvider`).
+ */
+export declare function PromptComposerDefaultsProvider({ children, ...defaults }: PromptComposerDefaultsProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=prompt-composer-defaults.d.ts.map

package/dist/types/prompt-composer/prompt-composer-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer-defaults.d.ts","sourceRoot":"","sources":["../../../src/prompt-composer/prompt-composer-defaults.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,mCAAmC,EACpC,MAAM,yBAAyB,CAAC;AAUjC,wBAAgB,yBAAyB,IAAI,sBAAsB,CAElE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,QAAQ,EACR,GAAG,QAAQ,EACZ,EAAE,mCAAmC,+BAWrC"}

package/dist/types/prompt-composer/prompt-composer-demo.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+/**
+ * One demonstration: what it is called, what to look at, and the stage that
+ * owns the distance between the examples on it. Every story composes this
+ * rather than laying itself out, so no two examples can end up against each
+ * other and no story reaches for an inline style.
+ */
+export declare function Scene({ children, label, layout, note, }: {
+    children: ReactNode;
+    label: string;
+    layout?: 'block' | 'row' | 'stack' | 'prose';
+    note: ReactNode;
+}): import("react").JSX.Element;
+export declare function Grid({ children, columns }: {
+    children: ReactNode;
+    columns: 1 | 2 | 3;
+}): import("react").JSX.Element;
+/** A narrow column, for showing what a control does below 320 pixels. */
+export declare function Measure({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=prompt-composer-demo.d.ts.map

package/dist/types/prompt-composer/prompt-composer-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer-demo.d.ts","sourceRoot":"","sources":["../../../src/prompt-composer/prompt-composer-demo.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EACpB,QAAQ,EACR,KAAK,EACL,MAAgB,EAChB,IAAI,GACL,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,IAAI,EAAE,SAAS,CAAC;CACjB,+BAYA;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAAE,+BAMtF;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE5D"}

package/dist/types/prompt-composer/prompt-composer.d.ts

@@ -0,0 +1,43 @@
+
+
+import type { PromptComposerActionProps, PromptComposerAttachProps, PromptComposerBandProps, PromptComposerInputProps, PromptComposerProps, PromptComposerSubmitProps } from './prompt-composer.types';
+/**
+ * A message being written: a form around a textarea, a band above for what
+ * the message carries and a band below for what it is sent with.
+ *
+ * **The value is the composer's.** The textarea is controlled from here, so an
+ * accepted send can clear it with its own reason and a refused one leaves it
+ * untouched. **The status is the application's**, because only the
+ * application knows whether an answer is streaming; the send turns into a stop
+ * while it is. **The attachments are the application's too**: they upload
+ * while the reader writes, so the composer hands over the files — from its
+ * button, a paste or a drop, after the selection rules `upload` applies — and
+ * draws nothing of them.
+ */
+export declare function PromptComposer({ accept, canSubmit, children, className, defaultValue, disabled, invalid, maxFiles, maxSize, messages, multiple, onAttach, onDragLeave, onDragOver, onDrop, onMouseDown, onStop, onSubmit, onValueChange, onValueSubmit, readOnly, render, size, status, style, submitOn, value, variant, ...nativeProps }: PromptComposerProps): import("react").JSX.Element;
+/** The band above the value: attachments, a quoted reply, a context chip. */
+export declare function PromptComposerHeader({ render, ...nativeProps }: PromptComposerBandProps): 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 band below the value: tools on the start, the send at the end. */
+export declare function PromptComposerFooter({ render, ...nativeProps }: PromptComposerBandProps): 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 value. Enter sends unless `submitOn` is `mod-enter`; Mod+Enter always
+ * sends; Shift+Enter is the platform's line break; and nothing is sent while
+ * an input method is composing, because there Enter confirms the composition.
+ */
+export declare function PromptComposerInput({ 'aria-describedby': describedBy, 'aria-invalid': ariaInvalid, 'aria-required': ariaRequired, id, maxLength, maxRows, onChange, onKeyDown, onPaste, rows, showCount, style, ...nativeProps }: PromptComposerInputProps): import("react").JSX.Element;
+/**
+ * A button of the consumer's in a band: a model menu, a tool, Cancelar.
+ * Square when named by `aria-label`, padded when named by its words; a
+ * `MenuTrigger` hands it its wiring through its own `render`.
+ */
+export declare function PromptComposerAction({ render, type, ...nativeProps }: PromptComposerActionProps): 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 paperclip: opens the file chooser, with the composer's `accept` and `multiple`. */
+export declare function PromptComposerAttach({ 'aria-label': ariaLabel, children, disabled, onClick, ...nativeProps }: PromptComposerAttachProps): import("react").JSX.Element;
+/**
+ * The send. Round and named by the provider's label for the status it is in;
+ * a padded word when given children. It turns into a busy ring while the
+ * request travels, a stop inside the ring while the answer streams, and a
+ * retry after an error.
+ */
+export declare function PromptComposerSubmit({ 'aria-label': ariaLabel, children, disabled, onClick, ...nativeProps }: PromptComposerSubmitProps): import("react").JSX.Element;
+//# sourceMappingURL=prompt-composer.d.ts.map

package/dist/types/prompt-composer/prompt-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer.d.ts","sourceRoot":"","sources":["../../../src/prompt-composer/prompt-composer.tsx"],"names":[],"mappings":"AAAA,OAAO,qDAAqD,CAAC;AAC7D,OAAO,qCAAqC,CAAC;AAyB7C,OAAO,KAAK,EACV,yBAAyB,EAEzB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EAInB,yBAAyB,EAE1B,MAAM,yBAAyB,CAAC;AA8CjC;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAe,EACf,QAAQ,EACR,WAAW,EACX,UAAU,EACV,MAAM,EACN,WAAW,EACX,MAAM,EACN,QAAQ,EACR,aAAa,EACb,aAAa,EACb,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,MAAgB,EAChB,KAAK,EACL,QAAQ,EACR,KAAK,EACL,OAAO,EACP,GAAG,WAAW,EACf,EAAE,mBAAmB,+BAgKrB;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,uBAAuB,+VAGvF;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,EAAE,uBAAuB,+VAGvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,kBAAkB,EAAE,WAAW,EAC/B,cAAc,EAAE,WAAW,EAC3B,eAAe,EAAE,YAAY,EAC7B,EAAE,EACF,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,IAAI,EACJ,SAAiB,EACjB,KAAK,EACL,GAAG,WAAW,EACf,EAAE,wBAAwB,+BA4D1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,IAAe,EACf,GAAG,WAAW,EACf,EAAE,yBAAyB,+VAG3B;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EAAE,SAAS,EACvB,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,GAAG,WAAW,EACf,EAAE,yBAAyB,+BA2C3B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EAAE,SAAS,EACvB,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,GAAG,WAAW,EACf,EAAE,yBAAyB,+BAgD3B"}

package/dist/types/prompt-composer/prompt-composer.types.d.ts

@@ -0,0 +1,144 @@
+import type { PartialMessages, PromptComposerMessages } from '@slotted/core/i18n';
+import type { ChangeRequest } from '@slotted/core/state';
+import type { UploadFile } from '@slotted/core/upload';
+import type { ComponentPropsWithRef, ReactNode } from 'react';
+/** The type step, matching the field around the composer. */
+export type PromptComposerSize = 'sm' | 'md' | 'lg';
+/**
+ * `raised` is the chat composer, a surface lifted off the page; `outline` and
+ * `subtle` are a composer inside a form, with a one-line control's geometry.
+ */
+export type PromptComposerVariant = 'raised' | 'outline' | 'subtle';
+/** Whether Enter sends, or only Mod+Enter does. Shift+Enter always breaks a line. */
+export type PromptComposerSubmitOn = 'enter' | 'mod-enter';
+/**
+ * Where the request the composer sent stands. The application owns it,
+ * because only the application knows whether an answer is streaming.
+ */
+export type PromptComposerStatus = 'ready' | 'submitted' | 'streaming' | 'error';
+/** Why the value moved: an edit, or the clearing that follows an accepted send. */
+export type PromptComposerValueReason = Extract<ChangeRequest<string>['reason'], 'keyboard' | 'submit'>;
+/** Why a send or a stop was asked for. */
+export type PromptComposerSubmitReason = Extract<ChangeRequest<string>['reason'], 'keyboard' | 'pointer'>;
+/** Where files came from, and what the selection rules refused. */
+export interface PromptComposerAttachDetail {
+    reason: 'pointer' | 'paste' | 'drop';
+    rejected: UploadFile[];
+    source: unknown;
+}
+/** What an application sets once for every composer under it. */
+export interface PromptComposerDefaults {
+    size: PromptComposerSize;
+    submitOn: PromptComposerSubmitOn;
+    variant: PromptComposerVariant;
+}
+export interface PromptComposerDefaultsProviderProps extends Partial<PromptComposerDefaults> {
+    children?: ReactNode | undefined;
+}
+/** What `render` receives for the root. */
+export interface PromptComposerRootProps extends ComponentPropsWithRef<'form'> {
+    'data-disabled'?: '' | undefined;
+    'data-drop-target'?: '' | undefined;
+    'data-invalid'?: '' | undefined;
+    'data-loading'?: '' | undefined;
+    'data-part': 'root';
+    'data-readonly'?: '' | undefined;
+    'data-size': PromptComposerSize;
+    'data-status': PromptComposerStatus;
+    'data-ui': 'prompt-composer';
+    'data-variant': PromptComposerVariant;
+}
+/**
+ * The root is a `form`, and every native prop reaches it; `onSubmit` stays
+ * the form's own event. The composer's own send is `onValueSubmit`.
+ */
+export interface PromptComposerProps extends Omit<ComponentPropsWithRef<'form'>, 'defaultValue' | 'onChange'> {
+    /** The file types the attach button, a paste and a drop accept, as `accept` reads. */
+    accept?: string | undefined;
+    /**
+     * Whether the send is available. Defaults to "the value has something
+     * besides white space"; an application with attachments ready says `true`.
+     */
+    canSubmit?: boolean | undefined;
+    children?: ReactNode | undefined;
+    /** The value an uncontrolled composer starts from, read once. */
+    defaultValue?: string | undefined;
+    /** Unstated rather than `false`, so the composer defers to its field. */
+    disabled?: boolean | undefined;
+    invalid?: boolean | undefined;
+    /** The most files one attach may bring. */
+    maxFiles?: number | undefined;
+    /** The largest file, in bytes. */
+    maxSize?: number | undefined;
+    /**
+     * Words laid over the catalog of the language in force, key by key: the
+     * names of the attach and submit buttons for each status (`send`, `sending`,
+     * `stop`, `retry`), and the `sending` and `stopped` announcements.
+     */
+    messages?: PartialMessages<PromptComposerMessages> | undefined;
+    /** Whether one attach may bring more than one file. Defaults to `true`. */
+    multiple?: boolean | undefined;
+    /** Files from the attach button, a paste or a drop, after the selection rules. */
+    onAttach?: ((files: File[], detail: PromptComposerAttachDetail) => void) | undefined;
+    /** The stop button, while `status` is `streaming`. */
+    onStop?: ((detail: {
+        reason: PromptComposerSubmitReason;
+        source: unknown;
+    }) => void) | undefined;
+    /** Called before the value moves, with the request that carries the reason. */
+    onValueChange?: ((value: string, request: ChangeRequest<string>) => void) | undefined;
+    /**
+     * Called before the message is sent. `request.cancel()` keeps the value
+     * where it is; otherwise an uncontrolled composer clears it, with reason
+     * `submit`.
+     */
+    onValueSubmit?: ((value: string, request: ChangeRequest<string>) => void) | undefined;
+    readOnly?: boolean | undefined;
+    /** Renders the root into another element. */
+    render?: ((props: PromptComposerRootProps) => ReactNode) | undefined;
+    /** Defaults to the field, then to the provider, then to `md`. */
+    size?: PromptComposerSize | undefined;
+    /** Defaults to `ready`. */
+    status?: PromptComposerStatus | undefined;
+    /** Defaults to the provider, then to `enter`. */
+    submitOn?: PromptComposerSubmitOn | undefined;
+    /** Present means controlled, for the life of the component. */
+    value?: string | undefined;
+    /** Defaults to the provider, then to `raised`. */
+    variant?: PromptComposerVariant | undefined;
+}
+/**
+ * The textarea. Every native prop reaches it; `value`, `defaultValue` and
+ * `onChange` are the composer's, because the composer owns the value.
+ */
+export interface PromptComposerInputProps extends Omit<ComponentPropsWithRef<'textarea'>, 'defaultValue' | 'value'> {
+    /** The most lines the value grows to before it scrolls. Defaults to 8. */
+    maxRows?: number | undefined;
+    /** The fewest lines it shows. Defaults to 1. */
+    rows?: number | undefined;
+    /** Publishes the length of the value to the field, which draws the count. */
+    showCount?: boolean | undefined;
+}
+export type PromptComposerBandProps = ComponentPropsWithRef<'div'> & {
+    render?: ((props: ComponentPropsWithRef<'div'> & {
+        'data-part': string;
+    }) => ReactNode) | undefined;
+};
+export interface PromptComposerActionProps extends ComponentPropsWithRef<'button'> {
+    render?: ((props: ComponentPropsWithRef<'button'> & {
+        'data-part': 'action';
+    }) => ReactNode) | undefined;
+}
+export interface PromptComposerAttachProps extends Omit<ComponentPropsWithRef<'button'>, 'children'> {
+    /** The mark; defaults to the paperclip. */
+    children?: ReactNode | undefined;
+}
+export interface PromptComposerSubmitProps extends Omit<ComponentPropsWithRef<'button'>, 'type'> {
+    /**
+     * The send named by a word — Comentar, Publicar — instead of the round mark.
+     * Absent, the button is the mark and its name is the provider's label for
+     * the current status.
+     */
+    children?: ReactNode | undefined;
+}
+//# sourceMappingURL=prompt-composer.types.d.ts.map

package/dist/types/prompt-composer/prompt-composer.types.d.ts.map

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

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

@@ -0,0 +1,6 @@
+export { Prose } from './prose';
+export { ProseDefaultsProvider, useProseDefaults } from './prose-defaults';
+export { ProseAnchor, ProseExclude, ProseFootnotes, ProseLead } from './prose-parts';
+export { ProseScroll } from './prose-scroll';
+export type { ProseAnchorProps, ProseDefaults, ProseDefaultsProviderProps, ProseExcludeProps, ProseFlow, ProseFootnotesProps, ProseLeadProps, ProsePartProps, ProseProps, ProseRootProps, ProseScrollHandle, ProseScrollHandleRef, ProseScrollProps, ProseScrollRootProps, ProseSize, } from './prose.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prose/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,EACjB,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,GACV,MAAM,eAAe,CAAC"}