@astryxdesign/lab 0.7.4-canary.faa934f → 0.7.5-canary.bfe8e0d

package/dist/MobilePowerSearch/MobilePowerSearch.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @file MobilePowerSearch.tsx
+ * @input Core PowerSearch config, filters and onChange (the same props as
+ *   @astryxdesign/core PowerSearch); public @astryxdesign/core components only
+ *   (BottomSheet, BottomSheetSwitcher, Button, Field, Heading, Icon, List,
+ *   RadioList, Text, TextInput, Token, Tooltip hooks, i18n, hooks, utils,
+ *   Layout container-padding styles)
+ * @output Exports MobilePowerSearch — Lab prototype of the touch PowerSearch
+ *   flow: the whole field is one "Manage filters" trigger with display-only
+ *   tokens, a Filters sheet with chevron rows, Add filter and sticky
+ *   Clear all / Done, and a field → operator → value drill-down whose edit
+ *   sheet holds Cancel / Apply / Remove
+ * @position Lab (canary) stack layer 1: validates the touch design before any
+ *   Core promotion. The caller chooses it explicitly
+ *   (`isTouch ? MobilePowerSearch : PowerSearch`); there is no pointer
+ *   switching inside the component.
+ *
+ * API mirrors Core PowerSearchProps (config, filters, onChange with the same
+ * change metadata, label, placeholder, size, isDisabled, isReadOnly,
+ * timezoneID, status, startIcon, endContent, resultCount, handleRef,
+ * components, ...) so graduation is an import swap. Differences from Core are
+ * the Lab deltas:
+ * - no `menuWidth` or `tokenOverflowBehavior`: there is no typeahead popover
+ *   and tokens wrap inside the trigger;
+ * - strings are literals (no new i18n keys; existing Core keys are reused
+ *   only for the result count and the add announcement);
+ * - no theming contract: no `power-search` theme target or selectors;
+ * - `components[type].Token` overrides receive Core's PowerSearchTokenProps,
+ *   which carry no `timezoneID`; the built-in token renders Core `Token`
+ *   directly so the configured timezone reaches tokens and row summaries
+ *   through the same formatter;
+ * - fields whose every operator is `nested` are left out with a development
+ *   warning; `nested` has no sheet editor yet;
+ * - `date_absolute` honors `isDateOnly: false` with a DateTimeInput, and
+ *   `date_relative` is a row list rather than a Selector;
+ * - the sheets pad their own content (`padding={0}` on BottomSheet); each
+ *   sheet body publishes that padding as container padding so its
+ *   `edge="bleed"` lists run edge to edge with row text on the body's inset.
+ *
+ * The sheets are pinned tall on purpose: the field list resizes as it is
+ * searched and the editor changes with the operator, and only a fully
+ * expanded tall sheet gives mobile-keyboard accommodation.
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/MobilePowerSearch/MobilePowerSearch.doc.mjs
+ * - /packages/lab/src/MobilePowerSearch/MobilePowerSearch.test.tsx
+ * - /apps/storybook/stories/MobilePowerSearch.stories.tsx
+ */
+import React, { type ReactNode } from 'react';
+import type { BaseProps } from '@astryxdesign/core';
+import { type FieldStatusVariant, type InputStatus } from '@astryxdesign/core/Field';
+import { type IconType } from '@astryxdesign/core/Icon';
+import type { PowerSearchChangeType, PowerSearchComponents, PowerSearchConfig, PowerSearchFilter, PowerSearchHandle, PowerSearchSize } from '@astryxdesign/core/PowerSearch';
+export interface MobilePowerSearchProps extends Omit<BaseProps<HTMLElement>, 'onChange'> {
+    /** PowerSearch configuration defining available fields and operators. */
+    config: PowerSearchConfig;
+    /** Currently active filters. */
+    filters: ReadonlyArray<PowerSearchFilter>;
+    /** Called when filters change, with the same metadata as Core PowerSearch. */
+    onChange: (filters: ReadonlyArray<PowerSearchFilter>, changeType: PowerSearchChangeType, index: number) => void;
+    /** Accessible label for the field and its trigger. @default 'Manage filters' */
+    label?: string;
+    /** Visually hide the label. @default true */
+    isLabelHidden?: boolean;
+    /** Trigger text when no filter is selected, and the content-search placeholder. */
+    placeholder?: string;
+    /** Auto-focus the trigger on mount. @default false */
+    hasAutoFocus?: boolean;
+    /** Show Clear all in the Filters sheet. @default true */
+    hasClear?: boolean;
+    /** Filters stay visible but cannot be added, edited, or removed. @default false */
+    isReadOnly?: boolean;
+    /** Disable the field; the sheet cannot open. @default false */
+    isDisabled?: boolean;
+    /**
+     * Explains why the field is disabled. With `isDisabled`, the trigger stays
+     * focusable (via `aria-disabled`) and shows this text in a tooltip.
+     */
+    disabledMessage?: string;
+    /** Icon at the start of the field. */
+    startIcon?: ReactNode | IconType;
+    /** Fires when focus enters the field from outside. */
+    onFocus?: (e: React.FocusEvent) => void;
+    /** Fires when focus leaves the field entirely. */
+    onBlur?: (e: React.FocusEvent) => void;
+    /** Validation status. */
+    status?: InputStatus;
+    /** How the status message is placed. @default 'attached' */
+    statusVariant?: FieldStatusVariant;
+    /** Max display length for token values. @default 40 */
+    maxTokenLength?: number;
+    /** Max suggestions in string and entity value typeaheads. @default 10 */
+    maxOperatorMenuItems?: number;
+    /** Max ranked results for a non-empty field or content query. @default 10 */
+    maxSearchResults?: number;
+    /** Label for the edit sheet's save action. @default 'Apply' when editing, 'Add filter' when creating */
+    popoverSaveButtonLabel?: string;
+    /** Timezone ID for date formatting in tokens, row summaries, and date editors. */
+    timezoneID?: string;
+    /** Content at the end of the field row. */
+    endContent?: ReactNode;
+    /** Result count: a number formats as "N results"; a string shows as-is. */
+    resultCount?: number | string;
+    /** Ref forwarded to the root element. */
+    ref?: React.Ref<HTMLDivElement>;
+    /** Imperative handle; `focusTypeahead` focuses the sheet trigger. */
+    handleRef?: React.Ref<PowerSearchHandle>;
+    /** Size of the field. @default 'md' */
+    size?: PowerSearchSize;
+    /** Per-type overrides for token and editor rendering. */
+    components?: PowerSearchComponents;
+}
+/**
+ * Lab prototype of the touch PowerSearch flow. The outer field keeps active
+ * filters as display-only tokens and acts as one sheet trigger. The Filters
+ * sheet lists selected filters as chevron rows with Add filter in its header
+ * and Clear all plus Done in its sticky footer; opening a row edits that
+ * filter in a sheet with Cancel, Apply and Remove. Add filter opens directly
+ * when no filter exists and, when the config names a content-search field,
+ * carries that search with inline suggestions.
+ */
+export declare function MobilePowerSearch({ config: configProp, filters, onChange, label: labelFromProps, isLabelHidden, placeholder: placeholderFromProps, hasAutoFocus, hasClear, isReadOnly, isDisabled, disabledMessage, startIcon, onFocus, onBlur, status, statusVariant, maxTokenLength, maxOperatorMenuItems, maxSearchResults, popoverSaveButtonLabel, timezoneID, endContent, resultCount, ref, handleRef, size: sizeProp, 'data-testid': testId, xstyle, className, style, components: componentOverrides, }: MobilePowerSearchProps): React.JSX.Element;
+export declare namespace MobilePowerSearch {
+    var displayName: string;
+}
+//# sourceMappingURL=MobilePowerSearch.d.ts.map

package/dist/MobilePowerSearch/MobilePowerSearch.d.ts.map

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