@mastra/playground-ui 67.0.0 → 68.0.0-alpha.1

package/dist/src/domains/knowledge/pageTypes.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Wire payloads for the schema-4 Knowledge explorer: pages, notes and pins as
+ * host routes return them (dates as ISO strings). Mirrors the storage
+ * contract in `@mastra/core` (`storage/domains/knowledge/pages.ts`) without
+ * importing it, so the UI stays independent of server-only types.
+ */
+export interface KnowledgeProvenancePayload {
+    author: string;
+    sourceThreadId?: string;
+}
+export interface KnowledgePagePayload {
+    id: string;
+    /** Home scope's page id; equals `id` on a scope page. */
+    scopeId: string;
+    /** Tree parent; `null` only on root scope pages. */
+    parentId: string | null;
+    isScope: boolean;
+    /** Canonical `type:value` address; scope pages only. */
+    address?: string;
+    /** Declaration key the scope page was materialized from; scope pages only. */
+    declaration?: string;
+    /** Its declaration's `displayLabel` (e.g. "Team"), added by the host; scope pages only. Falls back to "Scope". */
+    displayLabel?: string;
+    /** Stable key among its siblings; ordinary pages only. Forms the page's path: `org:acme#policies/refund`. */
+    key?: string;
+    /** Fractional sibling ordering key; compare as code-unit strings. */
+    position: string;
+    name: string;
+    description?: string;
+    body?: string;
+    version: number;
+    mergedInto?: string;
+    createdBy: KnowledgeProvenancePayload;
+    updatedBy: KnowledgeProvenancePayload;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+}
+export interface KnowledgeNotePayload {
+    id: string;
+    pageId: string;
+    text: string;
+    when?: string;
+    /** Scope page ids that narrow who can see the note (OR). */
+    stampScopeIds: string[];
+    /** Page ids resolved from `[[mentions]]` in `text`. */
+    mentions: string[];
+    provenance: KnowledgeProvenancePayload;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgePinPayload {
+    id: string;
+    pageId: string;
+    /** Scope addresses the pin is delivered to (OR). */
+    audience: string[];
+    createdBy: string;
+    createdAt: string;
+}
+export type KnowledgeActivityAction = 'scope-created' | 'page-created' | 'page-updated' | 'page-moved' | 'page-merged' | 'page-deleted' | 'note-added' | 'note-restamped' | 'note-removed' | 'note-restored' | 'pin-added' | 'pin-removed';
+export interface KnowledgePageActivityPayload {
+    id: string;
+    action: KnowledgeActivityAction;
+    scopeId: string;
+    pageId: string;
+    noteId?: string;
+    provenance: KnowledgeProvenancePayload;
+    createdAt: string;
+}
+/**
+ * A graph edge between two pages. `parent`: tree containment (parent → child).
+ * `mention`: notes on `source` mention `target`; `count` is how many.
+ * `grant`: the `source` scope's holders get `role` on the `target` scope.
+ */
+export interface KnowledgePageEdge {
+    source: string;
+    target: string;
+    kind: 'parent' | 'mention' | 'grant';
+    count?: number;
+    role?: KnowledgeRolePayload;
+}
+/** @experimental */
+export type KnowledgeRolePayload = 'viewer' | 'contributor' | 'editor' | 'owner';
+/**
+ * A scope declaration's access rule bound to a scope in the graph: holders of `principal` get `role` on
+ * `target`. `principalId` is the principal's scope page when it exists; a declared principal nothing has
+ * been written to yet has none, and the graph draws it as a placeholder circle.
+ */
+export interface KnowledgeScopeGrantPayload {
+    principal: string;
+    principalId?: string;
+    /** The principal's declaration `displayLabel`, e.g. "acme admin". */
+    principalLabel?: string;
+    target: string;
+    role: KnowledgeRolePayload;
+}

package/dist/src/domains/metrics/components/metrics-time-range-chip.d.ts

@@ -1,5 +1,5 @@
 /**
- * The dashboard's date range as the filter bar's `Time` chip, the same chip the Traces page shows.
- * Render it from `FilterBar.Chips` for `TRACE_TIME_RANGE_ITEM`, inside a `MetricsProvider`.
+ * The dashboard's date range as the filter bar's time range, the same control the Traces page shows.
+ * Render it from `FilterBar.Chips` for `FILTER_BAR_TIME_RANGE_ITEM`, inside a `MetricsProvider`.
  */
 export declare function MetricsTimeRangeChip(): import("react").JSX.Element;

package/dist/src/domains/observability/saved-views/saved-views-provider.d.ts

@@ -9,7 +9,12 @@ export type SavedViewsProviderProps = {
      * org-wide views are read-only. Read-only views can still be applied and duplicated. Defaults to all.
      */
     canEdit?: (view: SavedViewRecord) => boolean;
+    /**
+     * Whether new views can be saved here (save as new view, duplicate), e.g. `false` for a user who may only
+     * read views. With `canEdit={() => false}` the views can only be applied. Defaults to true.
+     */
+    canCreate?: boolean;
     children: ReactNode;
 };
 /** Turns saved views on for the observability pages below it. Without it, the pages show none. */
-export declare function SavedViewsProvider({ source, queryKeyScope, canEdit, children }: SavedViewsProviderProps): import("react").JSX.Element;
+export declare function SavedViewsProvider({ source, queryKeyScope, canEdit, canCreate, children, }: SavedViewsProviderProps): import("react").JSX.Element;

package/dist/src/domains/observability/saved-views/saved-views-source.d.ts

@@ -35,6 +35,7 @@ export type SavedViewsContextValue = {
     source: SavedViewsSource;
     queryKeyScope: readonly unknown[];
     canEdit?: (view: SavedViewRecord) => boolean;
+    canCreate?: boolean;
 };
 export declare const SavedViewsContext: import("react").Context<SavedViewsContextValue | undefined>;
 export declare const useSavedViewsSource: () => SavedViewsContextValue | undefined;

package/dist/src/domains/observability/saved-views/use-hosted-saved-views.d.ts

@@ -31,4 +31,4 @@ export type UseHostedSavedViewsArgs = SavedViewsContextValue & {
  * the draft: picking a view writes its state to the URL (and its columns to the column picker), and
  * the view shows unsaved changes while the URL differs from it.
  */
-export declare function useHostedSavedViews({ page, source, queryKeyScope, searchParams, setSearchParams, columns, defaultDatePreset, canEdit, }: UseHostedSavedViewsArgs): SavedViewsController<HostedSavedViewSettings>;
+export declare function useHostedSavedViews({ page, source, queryKeyScope, searchParams, setSearchParams, columns, defaultDatePreset, canEdit, canCreate, }: UseHostedSavedViewsArgs): SavedViewsController<HostedSavedViewSettings>;

package/dist/src/domains/skills/skill-simple-form.d.ts

@@ -6,5 +6,7 @@ export interface SkillSimpleFormProps {
     instructions: string;
     onInstructionsChange: (instructions: string) => void;
     readOnly?: boolean;
+    /** Locks only the name, for skills whose name is their identity. */
+    nameReadOnly?: boolean;
 }
-export declare function SkillSimpleForm({ name, onNameChange, description, onDescriptionChange, instructions, onInstructionsChange, readOnly, }: SkillSimpleFormProps): import("react").JSX.Element;
+export declare function SkillSimpleForm({ name, onNameChange, description, onDescriptionChange, instructions, onInstructionsChange, readOnly, nameReadOnly, }: SkillSimpleFormProps): import("react").JSX.Element;

package/dist/src/domains/spans/components/spans-filter-bar.d.ts

@@ -21,5 +21,5 @@ export type SpansFilterBarProps = {
     describeSuggestionsError?: (error: unknown) => string | undefined;
     disabled?: boolean;
 };
-/** The spans filter bar: a time range chip plus the fields `querySpans()` accepts. */
+/** The spans filter bar: the time range plus the fields `querySpans()` accepts. */
 export declare function SpansFilterBar({ datePreset, dateFrom, dateTo, minDate, timeRange, tokens, groups, onDatePresetChange, onDateChange, onDateRangeChange, onDateReset, onFiltersChange, describeSuggestionsError, disabled, }: SpansFilterBarProps): import("react").JSX.Element;

package/dist/src/domains/spans/hooks/use-spans-filter-bar.d.ts

@@ -20,7 +20,7 @@ export type UseSpansFilterBarOptions = {
 };
 /**
  * The span filters as a filter bar value, and the handlers that write bar edits back.
- * The time-range chip is a synthetic, always-present item; it never round-trips to tokens.
+ * The time range is a synthetic, always-present item; it never round-trips to tokens.
  */
 export declare function useSpansFilterBar({ tokens, groups, onFiltersChange }: UseSpansFilterBarOptions): {
     filterBarValue: FilterBarExpression;

package/dist/src/domains/spans/span-filters.d.ts

@@ -2,7 +2,7 @@ import type { TraceQueryScalarPredicate } from '@mastra/core/storage';
 import type { StreamingTimingSupport } from '../traces/trace-filters';
 import type { TraceFilterGroup, TraceFilterToken } from '../traces/trace-query-filters';
 import type { FilterBarField, FilterBarSuggestionsResolver } from '../../ds/components/FilterBar/types';
-/** Span query fields every store accepts. `startedAt`/`endedAt` are left to the time-range chip. */
+/** Span query fields every store accepts. `startedAt`/`endedAt` are left to the time range. */
 export declare const SPAN_CORE_FILTER_FIELD_IDS: readonly ['name', 'spanType', 'status', 'error', 'durationMs', 'timeToFirstChunkMs', 'timeToFirstTokenMs', 'entityType', 'entityId', 'entityName', 'entityVersionId', 'parentEntityVersionId', 'rootEntityVersionId', 'runId', 'sessionId', 'userId', 'organizationId'];
 /** Span query fields the server only accepts when the store declares `spanQueryContextFields`. */
 export declare const SPAN_CONTEXT_FILTER_FIELD_IDS: readonly ['traceId', 'spanId', 'parentSpanId', 'threadId', 'resourceId', 'requestId', 'serviceName', 'experimentId', 'environment', 'executionSource', 'parentEntityType', 'parentEntityId', 'parentEntityName', 'rootEntityType', 'rootEntityId', 'rootEntityName'];

package/dist/src/domains/threads/components/threads-filter-bar.d.ts

@@ -14,5 +14,5 @@ export type ThreadsFilterBarProps = {
     onFiltersChange: (tokens: TraceFilterToken[], groups: TraceFilterGroup[]) => void;
     disabled?: boolean;
 };
-/** The threads filter bar: a time range chip plus the fields `queryTraceThreads()` accepts. */
+/** The threads filter bar: the time range plus the fields `queryTraceThreads()` accepts. */
 export declare function ThreadsFilterBar({ datePreset, dateFrom, dateTo, minDate, tokens, groups, onDatePresetChange, onDateChange, onDateRangeChange, onFiltersChange, disabled, }: ThreadsFilterBarProps): import("react").JSX.Element;

package/dist/src/domains/threads/hooks/use-threads-filter-bar.d.ts

@@ -12,7 +12,7 @@ export type UseThreadsFilterBarOptions = {
 };
 /**
  * The thread filters as a filter bar value, and the handlers that write bar edits back.
- * The time-range chip is a synthetic, always-present item; it never round-trips to tokens.
+ * The time range is a synthetic, always-present item; it never round-trips to tokens.
  */
 export declare function useThreadsFilterBar({ tokens, groups, onFiltersChange }: UseThreadsFilterBarOptions): {
     filterBarValue: FilterBarExpression;

package/dist/src/domains/threads/thread-filters.d.ts

@@ -2,7 +2,7 @@ import type { TraceQueryScalarPredicate } from '@mastra/core/storage';
 import type { StreamingTimingSupport } from '../traces/trace-filters';
 import type { TraceFilterGroup, TraceFilterToken } from '../traces/trace-query-filters';
 import type { FilterBarField } from '../../ds/components/FilterBar/types';
-/** Thread query fields the filter bar offers. `startedAt`/`endedAt` are left to the time-range chip. */
+/** Thread query fields the filter bar offers. `startedAt`/`endedAt` are left to the time range. */
 export declare const THREAD_FILTER_FIELD_IDS: readonly ['status', 'traceCount', 'timeToFirstChunkMs', 'timeToFirstTokenMs', 'entityType', 'entityId', 'entityName', 'entityVersionId', 'threadId', 'resourceId', 'userId', 'organizationId', 'runId', 'sessionId', 'requestId', 'serviceName', 'experimentId', 'environment', 'executionSource'];
 /** FilterBar fields for the threads page: only paths and operators `queryTraceThreads()` accepts. */
 export declare function createThreadFilterBarFields({ withTimeToFirstChunk, withTimeToFirstToken, entityNames, environments, }: StreamingTimingSupport & {

package/dist/src/domains/traces/components/traces-explorer/traces-explorer-filter-bar.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { TraceTimeRangeChipProps } from '../trace-time-range-chip';
 import type { FilterBarItem } from '../../../../ds/components/FilterBar';
+import type { FilterBarTimeRangeProps } from '../../../../ds/components/FilterBar/filter-bar-time-range';
 export type TracesExplorerFilterBarProps = {
     /** Replaces the default chips and input, e.g. to pass a configured `TracesExplorer.TimeRangeChip`. */
     children?: ReactNode;
@@ -17,8 +17,8 @@ export type TracesExplorerFilterChipsProps = {
     /** Renders every other item. Defaults to the design-system chip. */
     renderChip?: (item: FilterBarItem) => ReactNode;
 };
-/** The bar's chips: the time range chip in its slot, then one chip per filter. */
+/** The bar's chips: the time range in its slot, then one chip per filter. */
 export declare function TracesExplorerFilterChips({ timeRange, renderChip }: TracesExplorerFilterChipsProps): import("react").JSX.Element;
-export type TracesExplorerTimeRangeChipProps = Partial<Pick<TraceTimeRangeChipProps, 'presets' | 'minDate' | 'maxRangeMs'>>;
+export type TracesExplorerTimeRangeChipProps = Partial<Pick<FilterBarTimeRangeProps, 'presets' | 'minDate' | 'maxRangeMs'>>;
 /** Its own component so a list loading flip only re-renders the chip, not the whole bar. */
 export declare function TracesExplorerTimeRangeChip({ presets, minDate, maxRangeMs, }: TracesExplorerTimeRangeChipProps): import("react").JSX.Element;

package/dist/src/domains/traces/components/traces-page-skeleton.d.ts

@@ -4,7 +4,7 @@ export type TracesPageSkeletonProps = {
 };
 /**
  * Page-level placeholder shown while filter-field discovery is pending. Pills sized like the
- * toolbar controls (time chip and filter input, then columns menu and auto-refresh) stand in
+ * toolbar controls (time range and filter input, then columns menu and auto-refresh) stand in
  * for the action row, spaced from the list skeleton as the action row is from the list.
  */
 export declare function TracesPageSkeleton({ columnPreferences }: TracesPageSkeletonProps): import("react").JSX.Element;

package/dist/src/ds/components/Button/Button.d.ts

@@ -31,6 +31,21 @@ export interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonE
     /** @deprecated Set it on the element passed to `render`. */
     prefetch?: boolean | null;
 }
+/** A trigger's leading icon. */
+export declare function ButtonIcon({ size, children }: {
+    size: ButtonSize;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * The down chevron of a trigger that opens a list; static, it does not turn while open. Lucide's
+ * chevron ink spans the middle half of its box, twice a regular icon's inset, so it pulls in by
+ * 1/8em on each side to sit where a regular icon's ink would. Pass it as a Button's `iconEnd`.
+ */
+export declare function TriggerChevron(): React.JSX.Element;
+/** The trigger chevron in a Button's end slot. */
+export declare function ButtonChevron({ size }: {
+    size: ButtonSize;
+}): React.JSX.Element;
 export declare function ButtonLabel({ variant, children }: {
     variant: ButtonVariant;
     children: React.ReactNode;

package/dist/src/ds/components/ClearFiltersButton/clear-filters-button.d.ts

@@ -0,0 +1,12 @@
+import type { MouseEventHandler } from 'react';
+export type ClearFiltersButtonProps = {
+    onClick: MouseEventHandler<HTMLButtonElement>;
+    /** Tooltip and accessible name. */
+    label?: string;
+    disabled?: boolean;
+};
+/**
+ * Resets every filter in a toolbar: a round icon button at the toolbar's height, named by its
+ * tooltip. A single filter's own × removes just that filter, so this one never uses an ×.
+ */
+export declare function ClearFiltersButton({ onClick, label, disabled }: ClearFiltersButtonProps): import("react").JSX.Element;

package/dist/src/ds/components/ClearFiltersButton/index.d.ts

@@ -0,0 +1 @@
+export * from './clear-filters-button';

package/dist/src/ds/components/Combobox/combobox-styles.d.ts

@@ -29,7 +29,6 @@ export declare const comboboxStyles: {
     /** @deprecated A `Field` lays out the combobox and its error. */
     readonly root: 'flex flex-col gap-1.5';
     /** Chevron icon in trigger — decorative icon token shared by every field. */
-    readonly chevron: 'ml-2 h-4 w-4 shrink-0 text-muted-foreground';
     /** Placeholder text color */
     readonly placeholder: 'text-muted-foreground';
     /**

package/dist/src/ds/components/DateTimeRangePicker/date-time-range-picker.d.ts

@@ -1,5 +1,5 @@
-import type { ReactElement } from 'react';
-import type { ButtonProps } from '../Button/Button';
+import type { Ref } from 'react';
+import type { TextButtonSize } from '../Button/Button';
 export type DateRangePreset = 'all' | 'last-24h' | 'last-3d' | 'last-7d' | 'last-14d' | 'last-30d' | 'custom';
 export interface DateTimeRangePickerProps {
     preset?: DateRangePreset;
@@ -19,15 +19,16 @@ export interface DateTimeRangePickerProps {
     minDate?: Date;
     /** Subset of presets to show. If omitted, all presets are shown. */
     presets?: readonly DateRangePreset[];
-    /** Size passed through to the trigger Button. Defaults to 'md'. */
-    size?: ButtonProps['size'];
+    /** Size of the trigger Button. Defaults to 'sm', the toolbar rung. */
+    size?: TextButtonSize;
     /**
-     * Replace the default Button trigger. Receives the current label (preset name or
-     * custom range) and must return an element the menu/popover can attach to.
+     * The preset a custom range resets to. While a custom range is applied, a × joined to the
+     * trigger takes the chevron's place and switches back to it.
      */
-    renderTrigger?: (props: {
-        label: string;
-        disabled?: boolean;
-    }) => ReactElement;
+    defaultPreset?: DateRangePreset;
+    /** Replaces what the reset × does, e.g. to undo a histogram zoom before falling back to `defaultPreset`. */
+    onReset?: () => void;
+    /** The trigger Button. */
+    ref?: Ref<HTMLButtonElement>;
 }
-export declare function DateTimeRangePicker({ preset, onPresetChange, dateFrom, dateTo, onDateChange, onDateRangeChange, disabled, maxRangeMs, minDate, presets, size, renderTrigger, }: DateTimeRangePickerProps): import("react").JSX.Element;
+export declare function DateTimeRangePicker({ preset, onPresetChange, dateFrom, dateTo, onDateChange, onDateRangeChange, disabled, maxRangeMs, minDate, presets, size, defaultPreset, onReset, ref, }: DateTimeRangePickerProps): import("react").JSX.Element;

package/dist/src/ds/components/FilterBar/filter-bar-chip.d.ts

@@ -1,8 +1,8 @@
-import type { ReactNode } from 'react';
+import type { CSSProperties, ReactNode } from 'react';
 import type { FilterBarField, FilterBarItem, FilterBarValue } from './types';
 import type { ControlSize } from '../../primitives/control-size';
-export declare const segmentClass: string;
 export declare const FILTER_BAR_CONTROL_SIZE: ControlSize;
+export declare const segmentClass: string;
 export declare const alwaysHighlightProps: {
     autoHighlight: boolean;
 };
@@ -13,10 +13,12 @@ export declare function FilterBarFieldLabel({ field, label }: {
     field: FilterBarField | undefined;
     label?: string;
 }): import("react").JSX.Element;
-/** Inline style carrying a field's accent onto its field segment (text + icon). */
-export declare const fieldSegmentAccentStyle: (field: FilterBarField | undefined) => {
-    color: string;
-} | undefined;
+type AccentStyle = CSSProperties & {
+    '--control-icon-rest': string;
+    '--control-icon-hover': string;
+};
+/** Inline style carrying a field's accent onto its field segment: text and icon, at rest and on hover. */
+export declare const fieldSegmentAccentStyle: (field: FilterBarField | undefined) => AccentStyle | undefined;
 export declare const formatValue: (value: FilterBarValue, field: FilterBarField | undefined) => string;
 export type FilterBarChipProps = {
     item: FilterBarItem;
@@ -44,6 +46,7 @@ export declare namespace FilterBarChip {
 export declare function FilterBarChipField(): import("react").JSX.Element;
 export declare function FilterBarChipOperator(): import("react").JSX.Element | null;
 export declare function FilterBarChipValue(): import("react").JSX.Element | null;
-/** The trailing × segment of a chip. */
+/** The trailing × segment of a chip: its own cell, so it keeps an even inset instead of the pill's outer one. */
 export declare const removeSegmentClass: string;
 export declare function FilterBarChipRemove(): import("react").JSX.Element | null;
+export {};

package/dist/src/ds/components/FilterBar/filter-bar-time-range.d.ts

@@ -0,0 +1,19 @@
+import type { FilterBarField, FilterBarItem } from './types';
+import type { DateTimeRangePickerProps } from '../DateTimeRangePicker/date-time-range-picker';
+export declare const FILTER_BAR_TIME_RANGE_FIELD_ID = "timeRange";
+/**
+ * Synthetic field backing the time range control. Hidden from the input's field step (the
+ * range cannot be added twice) but registered so the bar resolves its label and takes it into
+ * keyboard navigation. Add it to the bar's `fields` and `FILTER_BAR_TIME_RANGE_ITEM` to its
+ * `items`, then render `FilterBar.TimeRange` for that item from `FilterBar.Chips`.
+ */
+export declare const FILTER_BAR_TIME_RANGE_FIELD: FilterBarField;
+export declare const FILTER_BAR_TIME_RANGE_ITEM: FilterBarItem;
+export type FilterBarTimeRangeProps = Omit<DateTimeRangePickerProps, 'size' | 'ref'>;
+/**
+ * A filter bar's time range: the `DateTimeRangePicker` itself at the bar's rung, so it looks and
+ * behaves exactly as it does anywhere else, reset × included. It scopes the bar rather than
+ * filtering it, so it is not a removable chip; the wrapper only joins it to the bar's arrow-key
+ * order.
+ */
+export declare function FilterBarTimeRange(props: FilterBarTimeRangeProps): import("react").JSX.Element;

package/dist/src/ds/components/FilterBar/filter-bar.d.ts

@@ -2,6 +2,7 @@ import type { ReactNode } from 'react';
 import { FilterBarAdvancedChip } from './filter-bar-advanced-chip';
 import { FilterBarChip } from './filter-bar-chip';
 import { FilterBarInput } from './filter-bar-input';
+import { FilterBarTimeRange } from './filter-bar-time-range';
 import type { FilterBarExpression, FilterBarField, FilterBarItem, FilterBarOperator } from './types';
 type FilterBarValueProps = {
     /** Flat list of filters, implicitly joined with `and`. Advanced filters are never offered. */
@@ -59,6 +60,7 @@ export declare namespace FilterBar {
     export { FilterBarChip as Chip };
     export { FilterBarAdvancedChip as AdvancedChip };
     export { FilterBarInput as Input };
+    export { FilterBarTimeRange as TimeRange };
 }
 /**
  * Default layout: one editable chip per root item, one "Advanced filter" chip per root

package/dist/src/ds/components/FilterBar/index.d.ts

@@ -3,6 +3,8 @@ export type { FilterBarChipsProps, FilterBarProps } from './filter-bar';
 export { FilterBarChip, FilterBarChipField, FilterBarChipOperator, FilterBarChipValue, FilterBarChipRemove, } from './filter-bar-chip';
 export type { FilterBarChipProps } from './filter-bar-chip';
 export { FilterBarInput } from './filter-bar-input';
+export { FILTER_BAR_TIME_RANGE_FIELD, FILTER_BAR_TIME_RANGE_FIELD_ID, FILTER_BAR_TIME_RANGE_ITEM, FilterBarTimeRange, } from './filter-bar-time-range';
+export type { FilterBarTimeRangeProps } from './filter-bar-time-range';
 export type { FilterBarInputProps } from './filter-bar-input';
 export { FilterBarAdvancedChip } from './filter-bar-advanced-chip';
 export type { FilterBarAdvancedChipProps } from './filter-bar-advanced-chip';

package/dist/src/ds/components/FilterBar/use-filter-bar-item-keys.d.ts

@@ -0,0 +1,23 @@
+import type { KeyboardEvent, RefObject } from 'react';
+import type { FilterBarItem } from './types';
+/**
+ * An item's place in the bar's keyboard order, shared by every control the bar renders for an
+ * item (a chip, the time range): registers whether the input's Backspace may remove it, and moves
+ * focus with the arrows across the item's segments and on to its neighbours. Put `onKeyDown` on
+ * the element `rootRef` points at.
+ */
+export declare function useFilterBarItemKeys({ item, rootRef, pinned, removable, inert, segmentSelector, }: {
+    item: FilterBarItem;
+    rootRef: RefObject<HTMLElement | null>;
+    /** Never removed by the input's Backspace or by Clear. */
+    pinned: boolean;
+    /** Backspace / Delete on the item removes it. */
+    removable: boolean;
+    /** Ignore keys entirely (a draft, a read-only or a leaving chip). */
+    inert?: boolean;
+    /** The item's focusable segments, in order, inside `rootRef`. */
+    segmentSelector?: string;
+}): {
+    index: number;
+    onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
+};

package/dist/src/ds/components/ListSearch/list-search.d.ts

@@ -4,6 +4,7 @@ export type ListSearchProps = {
     label: string;
     placeholder: string;
     debounceMs?: number;
+    /** Defaults to 'sm', the toolbar rung. */
     size?: SearchInputProps['size'];
     /**
      * Optional controlled value. When provided, ListSearch stays in sync with this

package/dist/src/ds/components/SavedViews/saved-view-picker.d.ts

@@ -10,6 +10,8 @@ export type SavedViewPickerProps<TSettings> = {
     describeView?: (view: SavedView<TSettings>) => ReactNode;
     /** Whether a view can be renamed, deleted or overwritten. Others can still be applied and duplicated. */
     canEdit?: (view: SavedView<TSettings>) => boolean;
+    /** Whether new views can be saved here (save as new view, duplicate). Defaults to true. */
+    canCreate?: boolean;
     'aria-label'?: string;
     className?: string;
 };
@@ -18,4 +20,4 @@ export type SavedViewPickerProps<TSettings> = {
  * actions, and save / reset once the page differs from the view. Driven by the same controller
  * as `SavedViewTabs`.
  */
-export declare function SavedViewPicker<TSettings>({ views, defaultLabel, newViewSettings, describeView, canEdit, 'aria-label': ariaLabel, className, }: SavedViewPickerProps<TSettings>): import("react").JSX.Element;
+export declare function SavedViewPicker<TSettings>({ views, defaultLabel, newViewSettings, describeView, canEdit, canCreate, 'aria-label': ariaLabel, className, }: SavedViewPickerProps<TSettings>): import("react").JSX.Element;

package/dist/src/ds/components/ai/tool-call/tool-phrases.d.ts

@@ -108,6 +108,36 @@ declare const KIND_PHRASES: {
         one: string;
         many: string;
     };
+    'Search knowledge': {
+        live: string;
+        done: string;
+        one: string;
+        many: string;
+    };
+    'Read page': {
+        live: string;
+        done: string;
+        one: string;
+        many: string;
+    };
+    'Edit page': {
+        live: string;
+        done: string;
+        one: string;
+        many: string;
+    };
+    'Edit note': {
+        live: string;
+        done: string;
+        one: string;
+        many: string;
+    };
+    'Update pin': {
+        live: string;
+        done: string;
+        one: string;
+        many: string;
+    };
 };
 /** The kinds `presentTool` labels a call with; each one has its phrases. */
 export type ToolKind = keyof typeof KIND_PHRASES;

package/dist/src/ds/primitives/control-icon.d.ts

@@ -0,0 +1,3 @@
+export declare const controlIconState: string;
+/** The same for a bare-glyph control that is not a Button (a chip's ×). */
+export declare const controlIconOnly = "[--control-icon-hover:var(--foreground)]";

package/dist/src/ds/primitives/control-size.d.ts

@@ -3,6 +3,7 @@ export type ControlSize = 'sm' | 'md' | 'lg';
 export declare const ControlSizeContext: React.Context<ControlSize | undefined>;
 export declare const controlHeight: Record<ControlSize, string>;
 export declare const controlSizeClasses: Record<ControlSize, string>;
+export declare const controlSpacing: Record<ControlSize, string>;
 export type ControlTriggerVisualVariant = 'default' | 'ghost';
 export declare const controlTriggerOpenState: Record<ControlTriggerVisualVariant, string>;
 export declare function controlTriggerOpenStateFor(variant: string | null | undefined): string | undefined;

package/dist/src/lib/form/zod-provider/compat.d.ts

@@ -18,6 +18,11 @@ export declare function getDef(schema: AnySchema): any;
  * Check if a schema is optional (works for both v3 and v4).
  */
 export declare function isOptional(schema: AnySchema): boolean;
+/**
+ * Use `schema` as an object property that may be left out whenever the schema accepts `undefined`.
+ * zod v3 did this implicitly; zod v4 still requires the key for schemas like `z.any()`.
+ */
+export declare function asObjectProperty(schema: AnySchema): AnySchema;
 /**
  * Get the shape of an object schema (works for both v3 and v4).
  * v3: schema.shape (getter) or schema._def.shape()