@furcrer/fullstack-components 0.1.0

package/dist/types/components/primitives/Textarea/Textarea.d.ts

@@ -0,0 +1,3 @@
+import type { TextareaProps } from "./Textarea.types.js";
+/** Multiline text input primitive for forms and longer values. */
+export declare function Textarea({ size, rows, disabled, ...props }: TextareaProps): import("react").JSX.Element;

package/dist/types/components/primitives/Textarea/Textarea.fixture.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentPreviewProps } from "../../../types/metadata.js";
+/** Playground fixture for the Textarea primitive. */
+export declare function TextareaFixture({ props, onEvent }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/components/primitives/Textarea/Textarea.types.d.ts

@@ -0,0 +1,7 @@
+import type { TextareaHTMLAttributes } from "react";
+export type TextareaProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "rows"> & {
+    /** Visual size of the textarea. */
+    size?: "small" | "medium" | "large";
+    /** Preferred number of visible text rows. */
+    rows?: number;
+};

package/dist/types/components/primitives/Textarea/index.d.ts

@@ -0,0 +1,2 @@
+export { Textarea } from "./Textarea.js";
+export type { TextareaProps } from "./Textarea.types.js";

package/dist/types/components/primitives/Toast/Toast.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+export interface ToastProps {
+    open?: boolean;
+    children: ReactNode;
+    variant?: "info" | "success" | "warning" | "danger";
+    onClose?: () => void;
+}
+export declare function Toast({ open, children, variant, onClose }: ToastProps): import("react").JSX.Element | null;

package/dist/types/components/primitives/Toast/Toast.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../../../types/metadata.js";
+export declare function ToastFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/components/primitives/Toast/index.d.ts

@@ -0,0 +1,2 @@
+export { Toast } from "./Toast.js";
+export type { ToastProps } from "./Toast.js";

package/dist/types/components/primitives/Tooltip/Tooltip.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from "react";
+export interface TooltipProps {
+    content: ReactNode;
+    children: ReactNode;
+}
+export declare function Tooltip({ content, children }: TooltipProps): import("react").JSX.Element;

package/dist/types/components/primitives/Tooltip/Tooltip.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../../../types/metadata.js";
+export declare function TooltipFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/components/primitives/Tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export { Tooltip } from "./Tooltip.js";
+export type { TooltipProps } from "./Tooltip.js";

package/dist/types/components/primitives/TreeView/TreeView.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+export interface TreeNode {
+    id: string;
+    label: ReactNode;
+    children?: TreeNode[];
+    disabled?: boolean;
+}
+export interface TreeViewProps {
+    nodes: TreeNode[];
+    onSelect?: (id: string) => void;
+}
+export declare function TreeView({ nodes, onSelect }: TreeViewProps): import("react").JSX.Element;

package/dist/types/components/primitives/TreeView/TreeView.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../../../types/metadata.js";
+export declare function TreeViewFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/components/primitives/TreeView/index.d.ts

@@ -0,0 +1,2 @@
+export { TreeView } from "./TreeView.js";
+export type { TreeViewProps } from "./TreeView.js";

package/dist/types/data/Table.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode, TableHTMLAttributes } from "react";
+import type { DataRecord, TableColumn } from "./types.js";
+export interface TableProps<TData extends DataRecord = DataRecord> extends Omit<TableHTMLAttributes<HTMLTableElement>, "children"> {
+    /** Rows rendered by the table. */
+    data: TData[];
+    /** Column definitions used to render headers and cells. */
+    columns: TableColumn<TData>[];
+    /** Content rendered when the table has no rows. */
+    emptyState?: ReactNode;
+    /** Optional accessible table caption. */
+    caption?: ReactNode;
+}
+export declare function Table<TData extends DataRecord>({ data, columns, emptyState, caption, ...props }: TableProps<TData>): import("react").JSX.Element;

package/dist/types/data/Table.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../types/metadata.js";
+export declare function TableFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/data/api.d.ts

@@ -0,0 +1,25 @@
+import type { Resource } from "./types.js";
+export interface ApiErrorPayload {
+    message?: string;
+    code?: string;
+    details?: unknown;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(status: number, payload?: ApiErrorPayload);
+}
+export interface ApiClient {
+    request<TResponse>(path: string, init?: RequestInit): Promise<TResponse>;
+    get<TResponse>(path: string, query?: Record<string, unknown>): Promise<TResponse>;
+    post<TResponse>(path: string, body?: unknown): Promise<TResponse>;
+    patch<TResponse>(path: string, body?: unknown): Promise<TResponse>;
+    delete<TResponse = void>(path: string): Promise<TResponse>;
+}
+export declare function createFetchApiClient(baseUrl?: string): ApiClient;
+export interface ApiResourceOptions {
+    path: string;
+    client: ApiClient;
+}
+export declare function createApiResource<TData extends Record<string, unknown>, TId = string>(options: ApiResourceOptions): Resource<TData, TId>;

package/dist/types/data/crud.d.ts

@@ -0,0 +1,20 @@
+import type { DataRecord, Resource } from "./types.js";
+export type CrudStatus = "idle" | "loading" | "success" | "error";
+export interface CrudState<TData extends DataRecord = DataRecord> {
+    status: CrudStatus;
+    data?: TData;
+    error: Error | null;
+}
+export interface CrudController<TData extends DataRecord = DataRecord, TId = string> {
+    getState(): CrudState<TData>;
+    get(id: TId): Promise<TData | undefined>;
+    create(data: Partial<TData>): Promise<TData | undefined>;
+    update(id: TId, data: Partial<TData>): Promise<TData | undefined>;
+    remove(id: TId): Promise<boolean>;
+    reset(): void;
+    subscribe(listener: () => void): () => void;
+}
+export interface CreateCrudOptions<TData extends DataRecord = DataRecord, TId = string> {
+    resource: Resource<TData, TId>;
+}
+export declare function createCrudController<TData extends DataRecord, TId = string>({ resource }: CreateCrudOptions<TData, TId>): CrudController<TData, TId>;

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

@@ -0,0 +1,9 @@
+export * from "./types.js";
+export * from "./resource.js";
+export * from "./resource-controller.js";
+export * from "./table-controller.js";
+export * from "./react-table.js";
+export * from "./Table.js";
+export * from "./api.js";
+export * from "./crud.js";
+export * from "./react-crud.js";

package/dist/types/data/react-crud.d.ts

@@ -0,0 +1,6 @@
+import type { CrudController } from "./crud.js";
+import type { ResourceController } from "./resource-controller.js";
+import type { DataRecord, Resource } from "./types.js";
+export declare function useCrud<TData extends DataRecord, TId = string>(resource: Resource<TData, TId>): CrudController<TData, TId> & ReturnType<CrudController<TData, TId>["getState"]>;
+export type UseResourceCrudResult<TData extends DataRecord, TId = string, TCreate = Partial<TData>, TUpdate = Partial<TData>> = ResourceController<TData, TId, TCreate, TUpdate> & ReturnType<ResourceController<TData, TId, TCreate, TUpdate>["getState"]>;
+export declare function useResourceCrud<TData extends DataRecord, TId = string, TCreate = Partial<TData>, TUpdate = Partial<TData>>(resource: Resource<TData, TId>): UseResourceCrudResult<TData, TId, TCreate, TUpdate>;

package/dist/types/data/react-table.d.ts

@@ -0,0 +1,6 @@
+import type { CreateTableOptions, TableController, TableState } from "./table-controller.js";
+import type { DataRecord } from "./types.js";
+export declare function useTable<TData extends DataRecord>(options: CreateTableOptions<TData>): {
+    controller: TableController<TData>;
+    state: TableState<TData>;
+};

package/dist/types/data/resource-controller.d.ts

@@ -0,0 +1,28 @@
+import type { DataRecord, ListQuery, ListResult, Resource } from "./types.js";
+export type ResourceOperation = "idle" | "listing" | "reading" | "creating" | "updating" | "deleting";
+export interface ResourceControllerState<TData extends DataRecord, TId = string> {
+    data: TData[];
+    total?: number;
+    selected?: TData;
+    operation: ResourceOperation;
+    error?: Error;
+    lastQuery?: ListQuery;
+    lastUpdated?: number;
+}
+export interface CreateResourceControllerOptions {
+    initialQuery?: ListQuery;
+}
+export interface ResourceController<TData extends DataRecord, TId = string, TCreate = Partial<TData>, TUpdate = Partial<TData>> {
+    getState(): ResourceControllerState<TData, TId>;
+    list(query?: ListQuery): Promise<ListResult<TData>>;
+    get(id: TId): Promise<TData>;
+    create(input: TCreate): Promise<TData>;
+    update(id: TId, input: TUpdate): Promise<TData>;
+    remove(id: TId): Promise<void>;
+    refresh(): Promise<ListResult<TData>>;
+    select(item?: TData): void;
+    clearSelection(): void;
+    clearError(): void;
+    subscribe(listener: () => void): () => void;
+}
+export declare function createResourceController<TData extends DataRecord, TId = string, TCreate = Partial<TData>, TUpdate = Partial<TData>>(resource: Resource<TData, TId>, options?: CreateResourceControllerOptions): ResourceController<TData, TId, TCreate, TUpdate>;

package/dist/types/data/resource-controller.test.d.ts

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

package/dist/types/data/resource.d.ts

@@ -0,0 +1,2 @@
+import type { DataRecord, Resource } from "./types.js";
+export declare function createArrayResource<TData extends DataRecord>(name: string, initialData: TData[]): Resource<TData, string>;

package/dist/types/data/table-controller.d.ts

@@ -0,0 +1,28 @@
+import type { DataRecord, ListQuery, Resource, TableColumn } from "./types.js";
+export interface TableState<TData extends DataRecord = DataRecord> {
+    data: TData[];
+    columns: TableColumn<TData>[];
+    loading: boolean;
+    error: Error | null;
+    page: number;
+    pageSize: number;
+    total: number | undefined;
+    search: string;
+    sort: ListQuery["sort"];
+}
+export interface TableController<TData extends DataRecord = DataRecord> {
+    getState(): TableState<TData>;
+    load(): Promise<void>;
+    setSearch(search: string): Promise<void>;
+    setPage(page: number): Promise<void>;
+    setPageSize(pageSize: number): Promise<void>;
+    setSort(field: keyof TData & string): Promise<void>;
+    reset(): Promise<void>;
+    subscribe(listener: () => void): () => void;
+}
+export interface CreateTableOptions<TData extends DataRecord = DataRecord> {
+    resource: Resource<TData>;
+    columns?: TableColumn<TData>[];
+    pageSize?: number;
+}
+export declare function createTableController<TData extends DataRecord>(options: CreateTableOptions<TData>): TableController<TData>;

package/dist/types/data/types.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from "react";
+export type DataRecord = Record<string, unknown>;
+export interface ListQuery {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+    sort?: {
+        field: string;
+        direction: "asc" | "desc";
+    };
+    filters?: Record<string, unknown>;
+}
+export interface ListResult<TData extends DataRecord = DataRecord> {
+    data: TData[];
+    total?: number;
+}
+export interface Resource<TData extends DataRecord = DataRecord, TId = string> {
+    name: string;
+    list(query?: ListQuery): Promise<ListResult<TData>>;
+    get(id: TId): Promise<TData>;
+    create?(data: Partial<TData>): Promise<TData>;
+    update?(id: TId, data: Partial<TData>): Promise<TData>;
+    delete?(id: TId): Promise<void>;
+}
+export interface TableColumn<TData extends DataRecord = DataRecord> {
+    key: keyof TData & string;
+    header?: string;
+    sortable?: boolean;
+    render?: (value: TData[keyof TData], row: TData) => ReactNode;
+}
+export interface TableConfig<TData extends DataRecord = DataRecord> {
+    columns?: TableColumn<TData>[];
+    pageSize?: number;
+    search?: boolean;
+}
+export declare function inferTableColumns<TData extends DataRecord>(data: TData[]): TableColumn<TData>[];

package/dist/types/forms/FormActions.d.ts

@@ -0,0 +1,4 @@
+import type { ButtonHTMLAttributes } from "react";
+import type { FormValues } from "./types.js";
+export declare function FormSubmit<TValues extends FormValues = FormValues>(props: ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
+export declare function FormReset<TValues extends FormValues = FormValues>(props: ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;

package/dist/types/forms/FormActions.fixture.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentPreviewProps } from "../types/metadata.js";
+export declare function FormSubmitFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;
+export declare function FormResetFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/forms/FormField.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentPropsWithoutRef, ReactNode } from "react";
+import type { FormValues } from "./types.js";
+import { useField } from "./react-field.js";
+export interface FormFieldProps<TValues extends FormValues, TKey extends keyof TValues> extends Omit<ComponentPropsWithoutRef<"input">, "name" | "value" | "defaultValue" | "onChange" | "onBlur" | "children"> {
+    name: TKey;
+    children?: (field: ReturnType<typeof useField<TValues, TKey>>) => ReactNode;
+}
+export declare function FormField<TValues extends FormValues, TKey extends keyof TValues>({ name, children, ...inputProps }: FormFieldProps<TValues, TKey>): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;

package/dist/types/forms/FormField.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../types/metadata.js";
+export declare function FormFieldFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/forms/adapters.d.ts

@@ -0,0 +1,19 @@
+import type { ComponentType, ReactNode } from "react";
+import type { FormValues } from "./types.js";
+export interface FieldAdapterProps<TValue> {
+    value: TValue;
+    onChange: (value: TValue) => void;
+    onBlur: () => void;
+    error?: string;
+}
+export interface FieldAdapterOptions<TValues extends FormValues, TKey extends keyof TValues> {
+    name: TKey;
+    render: (props: FieldAdapterProps<TValues[TKey]>) => ReactNode;
+}
+export declare function FormFieldAdapter<TValues extends FormValues, TKey extends keyof TValues>({ name, render }: FieldAdapterOptions<TValues, TKey>): ReactNode;
+export interface BoundFieldProps<TValue> extends FieldAdapterProps<TValue> {
+    children?: ReactNode;
+}
+export declare function createFieldAdapter<TValue, TProps extends FieldAdapterProps<TValue>>(Component: ComponentType<TProps>): (props: Omit<TProps, keyof FieldAdapterProps<TValue>> & {
+    field: FieldAdapterProps<TValue>;
+}) => import("react").JSX.Element;

package/dist/types/forms/adapters.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../types/metadata.js";
+export declare function FormFieldAdapterFixture({ props }: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/forms/field.d.ts

@@ -0,0 +1,16 @@
+import type { FormStore } from "./form-store.js";
+import type { FormValues } from "./types.js";
+export interface FormFieldState<TValue = unknown> {
+    value: TValue;
+    error?: string;
+    touched: boolean;
+    dirty: boolean;
+    submitting: boolean;
+}
+export interface FormFieldController<TValues extends FormValues, TKey extends keyof TValues> {
+    name: TKey;
+    getState(): FormFieldState<TValues[TKey]>;
+    setValue(value: TValues[TKey]): void;
+    setTouched(touched?: boolean): void;
+}
+export declare function createFieldController<TValues extends FormValues, TKey extends keyof TValues>(store: FormStore<TValues>, name: TKey): FormFieldController<TValues, TKey>;

package/dist/types/forms/form-store.d.ts

@@ -0,0 +1,8 @@
+import type { FormConfig, FormController, FormErrors, FormValues } from "./types.js";
+export interface FormStore<TValues extends FormValues = FormValues> extends FormController<TValues> {
+    setValue<TKey extends keyof TValues>(key: TKey, value: TValues[TKey]): void;
+    setTouched<TKey extends keyof TValues>(key: TKey, touched?: boolean): void;
+    setErrors(errors: FormErrors<TValues>): void;
+    subscribe(listener: () => void): () => void;
+}
+export declare function createFormStore<TValues extends FormValues>(config: FormConfig<TValues>): FormStore<TValues>;

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

@@ -0,0 +1,10 @@
+export * from "./types.js";
+export * from "./form-store.js";
+export * from "./field.js";
+export * from "./react.js";
+export * from "./react-field.js";
+export * from "./react-form.js";
+export * from "./FormField.js";
+export * from "./FormActions.js";
+export * from "./adapters.js";
+export * from "./resource-form.js";

package/dist/types/forms/react-field.d.ts

@@ -0,0 +1,7 @@
+import type { FormFieldState } from "./field.js";
+import type { FormValues } from "./types.js";
+export interface UseFieldResult<TValue> extends FormFieldState<TValue> {
+    setValue(value: TValue): void;
+    setTouched(touched?: boolean): void;
+}
+export declare function useField<TValues extends FormValues, TKey extends keyof TValues>(name: TKey): UseFieldResult<TValues[TKey]>;

package/dist/types/forms/react-form.d.ts

@@ -0,0 +1,10 @@
+import type { FormHTMLAttributes, ReactNode } from "react";
+import type { FormStore } from "./form-store.js";
+import type { FormValues } from "./types.js";
+export interface FormProps<TValues extends FormValues = FormValues> extends Omit<FormHTMLAttributes<HTMLFormElement>, "onSubmit" | "onReset"> {
+    store: FormStore<TValues>;
+    children: ReactNode;
+    onSubmitResult?: (submitted: boolean) => void | Promise<void>;
+    onReset?: () => void;
+}
+export declare function Form<TValues extends FormValues>({ store, children, onSubmitResult, onReset, ...props }: FormProps<TValues>): import("react").JSX.Element;

package/dist/types/forms/react-form.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../types/metadata.js";
+export declare function FormFixture(_props: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/forms/react.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from "react";
+import type { FormStore } from "./form-store.js";
+import type { FormConfig, FormState, FormValues } from "./types.js";
+export declare function FormProvider<TValues extends FormValues>({ store, children, }: {
+    store: FormStore<TValues>;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useFormStore<TValues extends FormValues>(): FormStore<TValues>;
+export declare function useForm<TValues extends FormValues>(config: FormConfig<TValues>): {
+    store: FormStore<TValues>;
+    state: FormState<TValues>;
+    submit: () => Promise<boolean>;
+    reset: (values?: TValues | undefined) => void;
+    validate: () => Promise<Partial<Record<keyof TValues, string>>>;
+};
+export declare function useFormState<TValues extends FormValues = FormValues>(): FormState<TValues>;

package/dist/types/forms/react.fixture.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPreviewProps } from "../types/metadata.js";
+export declare function FormProviderFixture(_props: ComponentPreviewProps): import("react").JSX.Element;

package/dist/types/forms/resource-form.d.ts

@@ -0,0 +1,13 @@
+import type { FormStore } from "./form-store.js";
+import type { FormConfig } from "./types.js";
+import type { DataRecord, Resource } from "../data/types.js";
+export interface ResourceFormOptions<TData extends DataRecord, TValues extends Record<string, unknown> = Partial<TData>, TId = string> {
+    resource: Resource<TData, TId>;
+    mode: "create" | "edit";
+    id?: TId;
+    initialValues: TValues;
+    validate?: FormConfig<TValues>["validate"];
+    transform?: (values: TValues) => Partial<TData>;
+    onSuccess?: (data: TData) => void | Promise<void>;
+}
+export declare function createResourceForm<TData extends DataRecord, TValues extends Record<string, unknown> = Partial<TData>, TId = string>(options: ResourceFormOptions<TData, TValues, TId>): FormStore<TValues>;

package/dist/types/forms/types.d.ts

@@ -0,0 +1,25 @@
+export type FormValues = Record<string, unknown>;
+export type FormErrors<TValues extends FormValues = FormValues> = Partial<Record<keyof TValues, string>>;
+export type FormStatus = "idle" | "submitting" | "success" | "error";
+export interface FormState<TValues extends FormValues = FormValues> {
+    values: TValues;
+    errors: FormErrors<TValues>;
+    touched: Partial<Record<keyof TValues, boolean>>;
+    dirty: boolean;
+    submitting: boolean;
+    status: FormStatus;
+    submitError?: string;
+}
+export type FormValidator<TValues extends FormValues = FormValues> = (values: TValues) => FormErrors<TValues> | Promise<FormErrors<TValues>>;
+export type FormSubmitHandler<TValues extends FormValues = FormValues> = (values: TValues) => void | Promise<void>;
+export interface FormConfig<TValues extends FormValues = FormValues> {
+    initialValues: TValues;
+    validate?: FormValidator<TValues>;
+    onSubmit: FormSubmitHandler<TValues>;
+}
+export interface FormController<TValues extends FormValues = FormValues> {
+    getState(): FormState<TValues>;
+    submit(): Promise<boolean>;
+    reset(values?: TValues): void;
+    validate(): Promise<FormErrors<TValues>>;
+}