@mittwald/flow-react-components 0.1.0-alpha.16 → 0.1.0-alpha.161

package/dist/types/components/InlineCode/stories/Default.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as InlineCode } from '../InlineCode';
+
+declare const meta: Meta<typeof InlineCode>;
+export default meta;
+type Story = StoryObj<typeof InlineCode>;
+export declare const Default: Story;

package/dist/types/components/InlineCode/stories/EdgeCases.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as InlineCode } from '../InlineCode';
+
+declare const meta: Meta<typeof InlineCode>;
+export default meta;
+type Story = StoryObj<typeof InlineCode>;
+export declare const LongText: Story;

package/dist/types/components/Label/Label.d.ts

@@ -0,0 +1,9 @@
+import { PropsWithChildren, default as React } from 'react';
+import { FlowComponentProps } from '../../lib/componentFactory/flowComponent';
+
+import * as Aria from "react-aria-components";
+export interface LabelProps extends PropsWithChildren<Omit<Aria.LabelProps, "children">>, FlowComponentProps {
+    optional?: boolean;
+}
+export declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<never>>;
+export default Label;

package/dist/types/components/Label/index.d.ts

@@ -0,0 +1,4 @@
+import { Label } from './Label';
+
+export { type LabelProps, Label } from './Label';
+export default Label;

package/dist/types/components/Label/stories/Default.stories.d.ts

@@ -0,0 +1,8 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as Label } from '../Label';
+
+declare const meta: Meta<typeof Label>;
+export default meta;
+type Story = StoryObj<typeof Label>;
+export declare const Default: Story;
+export declare const Optional: Story;

package/dist/types/components/LabeledValue/LabeledValue.d.ts

@@ -0,0 +1,7 @@
+import { FC, PropsWithChildren } from 'react';
+import { PropsWithClassName } from '../../lib/types/props';
+
+export interface LabeledValueProps extends PropsWithChildren, PropsWithClassName {
+}
+export declare const LabeledValue: FC<LabeledValueProps>;
+export default LabeledValue;

package/dist/types/components/LabeledValue/index.d.ts

@@ -0,0 +1,4 @@
+import { LabeledValue } from './LabeledValue';
+
+export { type LabeledValueProps, LabeledValue } from './LabeledValue';
+export default LabeledValue;

package/dist/types/components/LabeledValue/stories/Default.stories.d.ts

@@ -0,0 +1,10 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as LabeledValue } from '../LabeledValue';
+
+declare const meta: Meta<typeof LabeledValue>;
+export default meta;
+type Story = StoryObj<typeof LabeledValue>;
+export declare const Default: Story;
+export declare const WithCopyButton: Story;
+export declare const WithInlineCode: Story;
+export declare const WithLink: Story;

package/dist/types/components/LabeledValue/stories/EdgeCases.stories.d.ts

@@ -0,0 +1,8 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as LabeledValue } from '../LabeledValue';
+
+declare const meta: Meta<typeof LabeledValue>;
+export default meta;
+type Story = StoryObj<typeof LabeledValue>;
+export declare const LongLabel: Story;
+export declare const LongContent: Story;

package/dist/types/components/LayoutCard/LayoutCard.d.ts

@@ -0,0 +1,8 @@
+import { PropsWithChildren, default as React } from 'react';
+import { PropsWithElementType } from '../../lib/types/props';
+import { FlowComponentProps } from '../../lib/componentFactory/flowComponent';
+
+export interface LayoutCardProps extends PropsWithChildren, PropsWithElementType<"div" | "main" | "footer" | "header">, FlowComponentProps {
+}
+export declare const LayoutCard: React.ForwardRefExoticComponent<LayoutCardProps & React.RefAttributes<never>>;
+export default LayoutCard;

package/dist/types/components/LayoutCard/index.d.ts

@@ -0,0 +1,4 @@
+import { LayoutCard } from './LayoutCard';
+
+export { type LayoutCardProps, LayoutCard } from './LayoutCard';
+export default LayoutCard;

package/dist/types/components/LayoutCard/stories/Default.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as LayoutCard } from '../LayoutCard';
+
+declare const meta: Meta<typeof LayoutCard>;
+export default meta;
+type Story = StoryObj<typeof LayoutCard>;
+export declare const Default: Story;

package/dist/types/components/Link/Link.d.ts

@@ -0,0 +1,14 @@
+import { ComponentProps, ComponentType, PropsWithChildren, default as React } from 'react';
+import { FlowComponentProps } from '../../lib/componentFactory/flowComponent';
+import { PropsWithClassName } from '../../lib/types/props';
+
+import * as Aria from "react-aria-components";
+export interface LinkProps extends PropsWithChildren<Omit<Aria.LinkProps, "children" | "slot" | "className">>, FlowComponentProps, PropsWithClassName {
+    inline?: boolean;
+    linkComponent?: ComponentType<Omit<ComponentProps<"a">, "ref">>;
+    /** @default "primary" */
+    color?: "primary" | "dark" | "light";
+    "aria-current"?: string;
+}
+export declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<never>>;
+export default Link;

package/dist/types/components/Link/context.d.ts

@@ -0,0 +1,8 @@
+import { LinkProps } from './index';
+
+interface LinkContext {
+    linkComponent?: LinkProps["linkComponent"];
+}
+export declare const linkContext: import('react').Context<LinkContext>;
+export declare const LinkContextProvider: import('react').Provider<LinkContext>;
+export {};

package/dist/types/components/Link/index.d.ts

@@ -0,0 +1,4 @@
+import { Link } from './Link';
+
+export { type LinkProps, Link } from './Link';
+export default Link;

package/dist/types/components/Link/stories/Default.stories.d.ts

@@ -0,0 +1,12 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as Link } from '../Link';
+
+declare const meta: Meta<typeof Link>;
+export default meta;
+type Story = StoryObj<typeof Link>;
+export declare const Default: Story;
+export declare const Inline: Story;
+export declare const Disabled: Story;
+export declare const WithIcon: Story;
+export declare const Dark: Story;
+export declare const Light: Story;

package/dist/types/components/Link/stories/EdgeCases.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { default as Link } from '../Link';
+
+declare const meta: Meta<typeof Link>;
+export default meta;
+type Story = StoryObj<typeof Link>;
+export declare const LongText: Story;

package/dist/types/components/List/List.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren, default as React } from 'react';
+
+interface Props extends PropsWithChildren {
+    batchSize?: number;
+}
+export declare function List(props: Props): React.JSX.Element;
+export default List;

package/dist/types/components/List/List.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/List/components/DataLoader/DataLoader.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+
+export declare const DataLoader: () => React.JSX.Element[];
+export default DataLoader;

package/dist/types/components/List/components/DataLoader/index.d.ts

@@ -0,0 +1,4 @@
+import { DataLoader } from './DataLoader';
+
+export { DataLoader } from './DataLoader';
+export default DataLoader;

package/dist/types/components/List/components/Footer/Footer/Footer.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+
+export declare const Footer: FC;
+export default Footer;

package/dist/types/components/List/components/Footer/Footer/index.d.ts

@@ -0,0 +1,4 @@
+import { Footer } from './Footer';
+
+export { Footer } from './Footer';
+export default Footer;

package/dist/types/components/List/components/Footer/PaginationInfos/PaginationInfos.d.ts

@@ -0,0 +1,5 @@
+import { TextProps } from '../../../../Text';
+import { FC } from 'react';
+
+export declare const PaginationInfos: FC<TextProps>;
+export default PaginationInfos;

package/dist/types/components/List/components/Footer/PaginationInfos/index.d.ts

@@ -0,0 +1,4 @@
+import { PaginationInfos } from './PaginationInfos';
+
+export { PaginationInfos } from './PaginationInfos';
+export default PaginationInfos;

package/dist/types/components/List/components/Footer/ShowNextBatchButton/ShowNextBatchButton.d.ts

@@ -0,0 +1,5 @@
+import { FC } from 'react';
+import { ButtonProps } from '../../../../Button';
+
+export declare const ShowNextBatchButton: FC<ButtonProps>;
+export default ShowNextBatchButton;

package/dist/types/components/List/components/Footer/ShowNextBatchButton/index.d.ts

@@ -0,0 +1,4 @@
+import { ShowNextBatchButton } from './ShowNextBatchButton';
+
+export { ShowNextBatchButton } from './ShowNextBatchButton';
+export default ShowNextBatchButton;

package/dist/types/components/List/components/Header/ActiveFilters/ActiveFilters.d.ts

@@ -0,0 +1,4 @@
+import { FC } from 'react';
+
+export declare const ActiveFilters: FC;
+export default ActiveFilters;

package/dist/types/components/List/components/Header/ActiveFilters/index.d.ts

@@ -0,0 +1,4 @@
+import { ActiveFilters } from './ActiveFilters';
+
+export { ActiveFilters } from './ActiveFilters';
+export default ActiveFilters;

package/dist/types/components/List/components/Header/FilterPicker/FilterPicker.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { Filter } from '../../../model/filter/Filter';
+import { AnyData } from '../../../model/item/types';
+
+interface Props {
+    filter: Filter<AnyData>;
+}
+export declare const FilterPicker: FC<Props>;
+export {};

package/dist/types/components/List/components/Header/FilterPicker/index.d.ts

@@ -0,0 +1,4 @@
+import { FilterPicker } from './FilterPicker';
+
+export { FilterPicker } from './FilterPicker';
+export default FilterPicker;

package/dist/types/components/List/components/Header/Header/Header.d.ts

@@ -0,0 +1,6 @@
+import { FC } from 'react';
+import { PropsWithClassName } from '../../../../../lib/types/props';
+
+type Props = PropsWithClassName;
+export declare const Header: FC<Props>;
+export default Header;

package/dist/types/components/List/components/Header/Header/index.d.ts

@@ -0,0 +1,4 @@
+import { Header } from './Header';
+
+export { Header } from './Header';
+export default Header;

package/dist/types/components/List/components/Header/ListFilter.d.ts

@@ -0,0 +1,5 @@
+import { FilterShape } from '../../model/filter/types';
+
+type Props<T> = Omit<FilterShape<T>, "type">;
+export declare function ListFilter<T = never>(ignoredProps: Props<T>): null;
+export {};

package/dist/types/components/List/components/Header/ListSorting.d.ts

@@ -0,0 +1,7 @@
+import { SortingShape } from '../../model/sorting/types';
+
+interface Props<T> extends SortingShape<T> {
+    defaultEnabled?: boolean;
+}
+export declare function ListSorting<T = never>(ignoredProps: Props<T>): null;
+export {};

package/dist/types/components/List/components/Header/SortingPicker/SortingPicker.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const SortingPicker: FC;

package/dist/types/components/List/components/Header/SortingPicker/index.d.ts

@@ -0,0 +1,4 @@
+import { SortingPicker } from './SortingPicker';
+
+export { SortingPicker } from './SortingPicker';
+export default SortingPicker;

package/dist/types/components/List/components/Header/SortingPickerItem/SortingPickerItem.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { AnyData } from '../../../model/item/types';
+import { Sorting } from '../../../model/sorting/Sorting';
+
+interface Props {
+    sorting: Sorting<AnyData>;
+}
+export declare const SortingPickerItem: FC<Props>;
+export {};

package/dist/types/components/List/components/Header/SortingPickerItem/index.d.ts

@@ -0,0 +1,4 @@
+import { SortingPickerItem } from './SortingPickerItem';
+
+export { SortingPickerItem } from './SortingPickerItem';
+export default SortingPickerItem;

package/dist/types/components/List/components/Items/ItemList/ItemList.d.ts

@@ -0,0 +1,6 @@
+import { FC } from 'react';
+import { PropsWithClassName } from '../../../../../lib/types/props';
+
+type Props = PropsWithClassName;
+export declare const ItemList: FC<Props>;
+export default ItemList;

package/dist/types/components/List/components/Items/ItemList/index.d.ts

@@ -0,0 +1,4 @@
+import { ItemList } from './ItemList';
+
+export { ItemList } from './ItemList';
+export default ItemList;

package/dist/types/components/List/components/Items/ItemSkeleton/ItemSkeleton.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+
+export declare const ItemSkeleton: FC;

package/dist/types/components/List/components/Items/ListItem/FallbackRenderer.d.ts

@@ -0,0 +1,8 @@
+import { AnyData } from '../../../model/item/types';
+import { FC } from 'react';
+
+interface Props {
+    data: AnyData;
+}
+export declare const FallbackRenderer: FC<Props>;
+export {};

package/dist/types/components/List/components/Items/ListItem/ListItem.d.ts

@@ -0,0 +1,7 @@
+import { PropsWithChildren, default as React } from 'react';
+import { LinkDOMProps } from '@react-types/shared';
+import { PropsWithClassName } from '../../../../../lib/types/props';
+
+type Props = PropsWithChildren & LinkDOMProps & PropsWithClassName;
+export declare const ListItem: (props: Props) => React.JSX.Element;
+export default ListItem;

package/dist/types/components/List/components/Items/ListItem/index.d.ts

@@ -0,0 +1,4 @@
+import { ListItem } from './ListItem';
+
+export { ListItem } from './ListItem';
+export default ListItem;

package/dist/types/components/List/components/Items/ListItemView.d.ts

@@ -0,0 +1,7 @@
+import { RenderItemFn } from '../../model/item/Item';
+
+interface Props<T> {
+    children: RenderItemFn<T>;
+}
+export declare function ListItemView<T = never>(ignoredProps: Props<T>): null;
+export {};

package/dist/types/components/List/components/Items/OptionsButton/OptionsButton.d.ts

@@ -0,0 +1,7 @@
+import { FC, PropsWithChildren } from 'react';
+import { PropsWithClassName } from '../../../../../lib/types/props';
+
+interface Props extends PropsWithChildren, PropsWithClassName {
+}
+export declare const OptionsButton: FC<Props>;
+export default OptionsButton;

package/dist/types/components/List/components/Items/OptionsButton/index.d.ts

@@ -0,0 +1,4 @@
+import { OptionsButton } from './OptionsButton';
+
+export { OptionsButton } from './OptionsButton';
+export default OptionsButton;

package/dist/types/components/List/components/ListLoaderAsync.d.ts

@@ -0,0 +1,7 @@
+import { AsyncDataLoaderShape } from '../model/loading/types';
+
+interface Props<T> extends Omit<AsyncDataLoaderShape<T>, "asyncLoader"> {
+    children: AsyncDataLoaderShape<T>["asyncLoader"];
+}
+export declare function ListLoaderAsync<T = never>(ignoredProps: Props<T>): null;
+export {};

package/dist/types/components/List/components/ListLoaderAsyncResource.d.ts

@@ -0,0 +1,7 @@
+import { AsyncResourceFactoryDataLoaderShape } from '../model/loading/types';
+
+interface Props<T> extends Omit<AsyncResourceFactoryDataLoaderShape<T>, "asyncResourceFactory"> {
+    children: AsyncResourceFactoryDataLoaderShape<T>["asyncResourceFactory"];
+}
+export declare function ListLoaderAsyncResource<T = never>(ignoredProps: Props<T>): null;
+export {};

package/dist/types/components/List/components/ListStaticData.d.ts

@@ -0,0 +1,5 @@
+interface Props<T> {
+    data: T[];
+}
+export declare function ListStaticData<T = never>(ignoredProps: Props<T>): null;
+export {};

package/dist/types/components/List/hooks/useList.d.ts

@@ -0,0 +1 @@
+export declare const useList: () => import('../model/List').List<any>;

package/dist/types/components/List/index.d.ts

@@ -0,0 +1,10 @@
+import { List } from './List';
+
+export * from './List';
+export * from './components/Header/ListFilter';
+export * from './components/Header/ListSorting';
+export * from './components/Items/ListItemView';
+export * from './components/Items/ListItem';
+export * from './components/ListLoaderAsync';
+export * from './components/ListStaticData';
+export default List;

package/dist/types/components/List/listContext.d.ts

@@ -0,0 +1,8 @@
+import { default as List } from './model/List';
+import { AnyData } from './model/item/types';
+
+interface ListContext {
+    list: List<AnyData>;
+}
+export declare const listContext: import('react').Context<ListContext>;
+export {};

package/dist/types/components/List/model/List.d.ts

@@ -0,0 +1,26 @@
+import { ItemCollection } from './item/ItemCollection';
+import { BatchesController } from './pagination/BatchesController';
+import { PropertyName, RenderItemFn } from './item/Item';
+import { Filter } from './filter/Filter';
+import { Sorting } from './sorting/Sorting';
+import { default as ReactTable } from './ReactTable';
+import { ListShape } from './types';
+import { IncrementalLoader } from './loading/IncrementalLoader';
+
+export declare class List<T> {
+    readonly filters: Filter<T>[];
+    readonly sorting: Sorting<T>[];
+    readonly items: ItemCollection<T>;
+    readonly render?: RenderItemFn<T>;
+    readonly reactTable: ReactTable<T>;
+    readonly batches: BatchesController<T>;
+    readonly loader: IncrementalLoader<T>;
+    private constructor();
+    static useNew<T>(shape: ListShape<T>): List<T>;
+    isFiltered(): boolean;
+    getSorting(property: PropertyName<T>): Sorting<T>;
+    clearSorting(): void;
+    clearFilters(): void;
+    useIsEmpty(): boolean;
+}
+export default List;

package/dist/types/components/List/model/ReactTable.d.ts

@@ -0,0 +1,18 @@
+import { Column, Table, TableOptions } from '@tanstack/react-table';
+import { default as List } from './List';
+import { PropertyName } from './item/Item';
+
+export declare class ReactTable<T> {
+    readonly list: List<T>;
+    readonly table: Table<T>;
+    private readonly tableState;
+    private constructor();
+    static useNew<T>(list: List<T>, tableOptions?: Partial<TableOptions<T>>): ReactTable<T>;
+    private useReactTable;
+    private useUpdateTableState;
+    private onTableStateChange;
+    private getUpdatedTableState;
+    getTableColumn(property: PropertyName<T>): Column<T>;
+    private getTableColumnDefs;
+}
+export default ReactTable;

package/dist/types/components/List/model/filter/Filter.d.ts

@@ -0,0 +1,31 @@
+import { Column, ColumnDef, ColumnFilter } from '@tanstack/react-table';
+import { default as List } from '../List';
+import { PropertyName } from '../item/Item';
+import { FilterMatcher, FilterMode, FilterShape } from './types';
+
+export declare class Filter<T> {
+    private readonly _values?;
+    readonly list: List<T>;
+    readonly property: PropertyName<T>;
+    readonly mode: FilterMode;
+    readonly matcher: FilterMatcher;
+    readonly name?: string;
+    private onFilterUpdateCallbacks;
+    constructor(list: List<T>, shape: FilterShape<T>);
+    updateTableColumnDef(def: ColumnDef<T>): void;
+    private getReactTableFilterFn;
+    private checkFilterMatches;
+    protected getTableColumnFilter(): ColumnFilter | undefined;
+    protected getTableColumn(): Column<T>;
+    getValue(): unknown;
+    getValueId(value: unknown): string;
+    get values(): unknown[];
+    getArrayValue(): unknown[];
+    isValueActive(value: unknown): boolean;
+    isActive(): boolean;
+    activateValue(newValue: unknown): void;
+    deactivateValue(newValue: unknown): void;
+    clearValues(): void;
+    toggleValue(newValue: unknown): void;
+    onFilterUpdated(cb: () => unknown): void;
+}

package/dist/types/components/List/model/filter/types.d.ts

@@ -0,0 +1,11 @@
+import { PropertyName } from '../item/Item';
+
+export type FilterMode = "all" | "some" | "one";
+export type FilterMatcher = (filterValue: unknown, property: unknown) => boolean;
+export interface FilterShape<T> {
+    property: PropertyName<T>;
+    mode?: FilterMode;
+    matcher?: FilterMatcher;
+    values?: unknown[];
+    name?: string;
+}

package/dist/types/components/List/model/item/Item.d.ts

@@ -0,0 +1,15 @@
+import { ItemCollection } from './ItemCollection';
+import { ReactNode } from 'react';
+import { DeepKeys, Row } from '@tanstack/react-table';
+
+export type PropertyName<T> = DeepKeys<T>;
+export type RenderItemFn<T> = (data: T) => ReactNode;
+export declare class Item<T> {
+    readonly id: string;
+    readonly data: T;
+    readonly collection: ItemCollection<T>;
+    constructor(collection: ItemCollection<T>, id: string, data: T);
+    render(): ReactNode;
+    static fromRow<T>(collection: ItemCollection<T>, row: Row<T>): Item<T>;
+    private static fallbackRenderItemFn;
+}

package/dist/types/components/List/model/item/ItemCollection.d.ts

@@ -0,0 +1,9 @@
+import { default as List } from '../List';
+import { Item } from './Item';
+
+export declare class ItemCollection<T> {
+    readonly list: List<T>;
+    private constructor();
+    static useNew<T>(list: List<T>): ItemCollection<T>;
+    get entries(): Item<T>[];
+}

package/dist/types/components/List/model/item/types.d.ts

@@ -0,0 +1,5 @@
+export type AnyData = any;
+export interface ListDataLoaderResult<T> {
+    data: T[];
+    itemTotalCount?: number;
+}

package/dist/types/components/List/model/loading/IncrementalLoader.d.ts

@@ -0,0 +1,24 @@
+import { default as List } from '../List';
+import { IncrementalLoaderShape } from './types';
+import { IncrementalLoaderState } from './IncrementalLoaderState';
+
+export declare class IncrementalLoader<T> {
+    private readonly list;
+    private readonly dataSource;
+    readonly manualSorting: boolean;
+    readonly manualFiltering: boolean;
+    readonly manualPagination: boolean;
+    readonly loaderState: IncrementalLoaderState<T>;
+    private constructor();
+    static useNew<T>(list: List<T>, shape?: IncrementalLoaderShape<T>): IncrementalLoader<T>;
+    private reset;
+    useIsLoading(): boolean;
+    useIsInitiallyLoading(): boolean;
+    useData(): T[];
+    getLoaderInvocationHooks(): (() => void)[];
+    private useLoadBatch;
+    private useObserveBatchLoadingState;
+    private useObserveBatchData;
+    private getDataLoaderOptions;
+    private getBatchDataAsyncResource;
+}

package/dist/types/components/List/model/loading/IncrementalLoaderState.d.ts

@@ -0,0 +1,20 @@
+import { AsyncResource } from '@mittwald/react-use-promise';
+
+type AsyncResourceLoadingState = AsyncResource["state"]["value"];
+type DataBatches<T> = T[][];
+type BatchesLoadingState = AsyncResourceLoadingState[];
+export declare class IncrementalLoaderState<T> {
+    dataBatches: DataBatches<T>;
+    prevDataBatches: DataBatches<T>;
+    batchLoadingStates: BatchesLoadingState;
+    private constructor();
+    static useNew<T>(): IncrementalLoaderState<T>;
+    reset(): void;
+    setDataBatch(index: number, data: T[]): void;
+    setBatchLoadingState(index: number, state: AsyncResourceLoadingState): void;
+    get mergedData(): T[];
+    useMergedData(): T[];
+    get isLoading(): boolean;
+    useIsLoading(): boolean;
+}
+export {};