@alfakit/react 0.0.0-stage → 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alfa Six Media and Management W.L.L.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @alfakit/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/alfasixbh/alfakit/main/art/alfasix/alfa-six-micro-white.svg"><img src="https://raw.githubusercontent.com/alfasixbh/alfakit/main/art/alfasix/alfa-six-micro-navy.svg" alt="" width="24" height="18" align="top"></picture> <sub>by <a href="https://alfasixbh.com">Alfa Six</a></sub></p>
+
+React 19 renderer for AlfaKit, built on shadcn/ui, Radix and Inertia.js.
+
+AlfaKit is the frontend-agnostic admin panel builder for Laravel by [Alfa Six](https://alfasixbh.com). Panels, resources, forms, tables and actions are defined in PHP and rendered by this package.
+
+## Install
+
+```bash
+composer require alfasix/alfakit
+php artisan alfakit:install --adapter=react
+```
+
+The installer creates `resources/js/alfakit/app.*` and `resources/css/alfakit.css` and registers them with Vite. See the [documentation](https://alfakit.dev/docs) for custom components, pages and theming.
+
+## License
+
+MIT © Alfa Six

package/dist/app/components.d.ts

@@ -0,0 +1,49 @@
+import { ContentBlock, PageSchema } from "@alfakit/core";
+import { ReactNode } from "react";
+//#region src/app/components.d.ts
+/**
+ * Building blocks for custom page components: the page shell with the panel layout, and the
+ * page's PHP-defined pieces rendered by name, with live fields, actions, uploads and polling
+ * working exactly as on schema-driven pages.
+ */
+/** The current page with its lazy components resolved. */
+export declare function useAppPage(): PageSchema | undefined;
+/** A content block of the page by key (`form:customer`, `table`, `headerWidgets`…). */
+export declare function usePageBlock(key: string): ContentBlock | undefined;
+/**
+ * The page's layout (sidebar and topbar, `fullscreen`…), heading, header actions and
+ * document title around a custom component:
+ *
+ * ```tsx
+ * export default function Pos(props: PosProps) {
+ *   return <AppPage>…</AppPage>
+ * }
+ * ```
+ */
+export declare function AppPage({ children }: {
+  children: ReactNode;
+}): import("react").JSX.Element;
+export interface PageBlockProps {
+  /** The block key: `form:customer`, `table:products`, `infolist:summary`, `form`, `table`, `content`… */
+  name: string;
+  /** Rendered when the page has no such block (e.g. a hidden form). */
+  fallback?: ReactNode;
+  className?: string;
+}
+/** Render any content block of the page by key. */
+export declare function PageBlock({ name, fallback, className }: PageBlockProps): import("react").JSX.Element;
+type NamedBlockProps = Omit<PageBlockProps, 'name'> & {
+  name?: string;
+};
+/** A form defined by `{name}Form(Schema $schema)` (or the page's `form()` without a name). */
+export declare function PageForm({ name, ...props }: NamedBlockProps): import("react").JSX.Element;
+/** A table defined by `{name}Table(Table $table)` (or the page's `table()` without a name). */
+export declare function PageTable({ name, ...props }: NamedBlockProps): import("react").JSX.Element;
+/** An infolist defined by `{name}Infolist(Schema $schema)` (or the page's `infolist()`). */
+export declare function PageInfolist({ name, ...props }: NamedBlockProps): import("react").JSX.Element;
+/** The page's header (default) or footer widgets. */
+export declare function PageWidgets({ position, ...props }: Omit<PageBlockProps, 'name'> & {
+  position?: 'header' | 'footer';
+}): import("react").JSX.Element;
+//#endregion
+//# sourceMappingURL=components.d.ts.map

package/dist/app/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","names":[],"sources":["../../src/app/components.tsx"],"mappings":";;;;;;;;;wBAegB,cAAc;;wBAWd,aAAa,cAAc;;;;;;;;;;;wBAgB3B,UAAU;EAAc,UAAU;oBAAW,IAAA;iBAc5C;;EAEf;;EAEA,WAAW;EACX;;;wBAIc,YAAY,MAAM,UAAiB,aAAa,iCAAc,IAAA;KAezE,kBAAkB,KAAK;EAA4B;;;wBAGxC,WAAW,SAAS,SAAS,kCAAe,IAAA;;wBAK5C,YAAY,SAAS,SAAS,kCAAe,IAAA;;wBAK7C,eAAe,SAAS,SAAS,kCAAe,IAAA;;wBAKhD,cACd,aACG,SACF,KAAK;EAA4B;oBAAgC,IAAA"}

package/dist/app/components.js

@@ -0,0 +1,99 @@
+import { useAlfakitProps, usePageSchema, usePanel } from "../context.js";
+import { PageActionProvider } from "../components/actions/action-context.js";
+import { cn } from "../lib/utils.js";
+import { ContentBlockRenderer, PageShell } from "../pages/page.js";
+import { resolveLazyComponents } from "@alfakit/core";
+import { Head } from "@inertiajs/react";
+import { useMemo } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/app/components.tsx
+/**
+* Building blocks for custom page components: the page shell with the panel layout, and the
+* page's PHP-defined pieces rendered by name, with live fields, actions, uploads and polling
+* working exactly as on schema-driven pages.
+*/
+/** The current page with its lazy components resolved. */
+function useAppPage() {
+	const props = useAlfakitProps();
+	const page = usePageSchema();
+	return useMemo(() => page ? resolveLazyComponents(page, props.alfakitLazy) : void 0, [page, props.alfakitLazy]);
+}
+/** A content block of the page by key (`form:customer`, `table`, `headerWidgets`…). */
+function usePageBlock(key) {
+	return useAppPage()?.content.find((block) => block.key === key);
+}
+/**
+* The page's layout (sidebar and topbar, `fullscreen`…), heading, header actions and
+* document title around a custom component:
+*
+* ```tsx
+* export default function Pos(props: PosProps) {
+*   return <AppPage>…</AppPage>
+* }
+* ```
+*/
+function AppPage({ children }) {
+	const page = useAppPage();
+	const panel = usePanel();
+	if (!page) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	return /* @__PURE__ */ jsxs(PageActionProvider, {
+		value: {
+			token: page.token,
+			component: "page"
+		},
+		children: [/* @__PURE__ */ jsx(Head, { title: `${page.title} - ${panel.brandName}` }), /* @__PURE__ */ jsx(PageShell, {
+			page,
+			children
+		})]
+	});
+}
+/** Render any content block of the page by key. */
+function PageBlock({ name, fallback = null, className }) {
+	const page = useAppPage();
+	const block = page?.content.find((candidate) => candidate.key === name);
+	if (!page || !block) return /* @__PURE__ */ jsx(Fragment$1, { children: fallback });
+	return /* @__PURE__ */ jsx(PageActionProvider, {
+		value: {
+			token: page.token,
+			component: "page"
+		},
+		children: /* @__PURE__ */ jsx("div", {
+			"data-slot": "page-block",
+			"data-block": name,
+			className: cn("min-w-0", className),
+			children: /* @__PURE__ */ jsx(ContentBlockRenderer, { block })
+		})
+	});
+}
+/** A form defined by `{name}Form(Schema $schema)` (or the page's `form()` without a name). */
+function PageForm({ name, ...props }) {
+	return /* @__PURE__ */ jsx(PageBlock, {
+		name: name ? `form:${name}` : "form",
+		...props
+	});
+}
+/** A table defined by `{name}Table(Table $table)` (or the page's `table()` without a name). */
+function PageTable({ name, ...props }) {
+	return /* @__PURE__ */ jsx(PageBlock, {
+		name: name ? `table:${name}` : "table",
+		...props
+	});
+}
+/** An infolist defined by `{name}Infolist(Schema $schema)` (or the page's `infolist()`). */
+function PageInfolist({ name, ...props }) {
+	return /* @__PURE__ */ jsx(PageBlock, {
+		name: name ? `infolist:${name}` : "infolist",
+		...props
+	});
+}
+/** The page's header (default) or footer widgets. */
+function PageWidgets({ position = "header", ...props }) {
+	return /* @__PURE__ */ jsx(PageBlock, {
+		name: position === "footer" ? "footerWidgets" : "headerWidgets",
+		...props
+	});
+}
+//#endregion
+export { AppPage, PageBlock, PageForm, PageInfolist, PageTable, PageWidgets, useAppPage, usePageBlock };
+
+//# sourceMappingURL=components.js.map

package/dist/app/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","names":[],"sources":["../../src/app/components.tsx"],"sourcesContent":["import { resolveLazyComponents, type ContentBlock, type PageSchema } from '@alfakit/core'\nimport { Head } from '@inertiajs/react'\nimport { useMemo, type ReactNode } from 'react'\nimport { PageActionProvider } from '../components/actions/action-context'\nimport { useAlfakitProps, usePageSchema, usePanel } from '../context'\nimport { cn } from '../lib/utils'\nimport { ContentBlockRenderer, PageShell } from '../pages/page'\n\n/**\n * Building blocks for custom page components: the page shell with the panel layout, and the\n * page's PHP-defined pieces rendered by name, with live fields, actions, uploads and polling\n * working exactly as on schema-driven pages.\n */\n\n/** The current page with its lazy components resolved. */\nexport function useAppPage(): PageSchema | undefined {\n  const props = useAlfakitProps()\n  const page = usePageSchema()\n\n  return useMemo(\n    () => (page ? resolveLazyComponents(page, props.alfakitLazy) : undefined),\n    [page, props.alfakitLazy],\n  )\n}\n\n/** A content block of the page by key (`form:customer`, `table`, `headerWidgets`…). */\nexport function usePageBlock(key: string): ContentBlock | undefined {\n  const page = useAppPage()\n\n  return page?.content.find((block) => block.key === key)\n}\n\n/**\n * The page's layout (sidebar and topbar, `fullscreen`…), heading, header actions and\n * document title around a custom component:\n *\n * ```tsx\n * export default function Pos(props: PosProps) {\n *   return <AppPage>…</AppPage>\n * }\n * ```\n */\nexport function AppPage({ children }: { children: ReactNode }) {\n  const page = useAppPage()\n  const panel = usePanel()\n\n  if (!page) return <>{children}</>\n\n  return (\n    <PageActionProvider value={{ token: page.token, component: 'page' }}>\n      <Head title={`${page.title} - ${panel.brandName}`} />\n      <PageShell page={page}>{children}</PageShell>\n    </PageActionProvider>\n  )\n}\n\nexport interface PageBlockProps {\n  /** The block key: `form:customer`, `table:products`, `infolist:summary`, `form`, `table`, `content`… */\n  name: string\n  /** Rendered when the page has no such block (e.g. a hidden form). */\n  fallback?: ReactNode\n  className?: string\n}\n\n/** Render any content block of the page by key. */\nexport function PageBlock({ name, fallback = null, className }: PageBlockProps) {\n  const page = useAppPage()\n  const block = page?.content.find((candidate) => candidate.key === name)\n\n  if (!page || !block) return <>{fallback}</>\n\n  return (\n    <PageActionProvider value={{ token: page.token, component: 'page' }}>\n      <div data-slot=\"page-block\" data-block={name} className={cn('min-w-0', className)}>\n        <ContentBlockRenderer block={block} />\n      </div>\n    </PageActionProvider>\n  )\n}\n\ntype NamedBlockProps = Omit<PageBlockProps, 'name'> & { name?: string }\n\n/** A form defined by `{name}Form(Schema $schema)` (or the page's `form()` without a name). */\nexport function PageForm({ name, ...props }: NamedBlockProps) {\n  return <PageBlock name={name ? `form:${name}` : 'form'} {...props} />\n}\n\n/** A table defined by `{name}Table(Table $table)` (or the page's `table()` without a name). */\nexport function PageTable({ name, ...props }: NamedBlockProps) {\n  return <PageBlock name={name ? `table:${name}` : 'table'} {...props} />\n}\n\n/** An infolist defined by `{name}Infolist(Schema $schema)` (or the page's `infolist()`). */\nexport function PageInfolist({ name, ...props }: NamedBlockProps) {\n  return <PageBlock name={name ? `infolist:${name}` : 'infolist'} {...props} />\n}\n\n/** The page's header (default) or footer widgets. */\nexport function PageWidgets({\n  position = 'header',\n  ...props\n}: Omit<PageBlockProps, 'name'> & { position?: 'header' | 'footer' }) {\n  return <PageBlock name={position === 'footer' ? 'footerWidgets' : 'headerWidgets'} {...props} />\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,aAAqC;CACnD,MAAM,QAAQ,gBAAgB;CAC9B,MAAM,OAAO,cAAc;CAE3B,OAAO,cACE,OAAO,sBAAsB,MAAM,MAAM,WAAW,IAAI,KAAA,GAC/D,CAAC,MAAM,MAAM,WAAW,CAC1B;AACF;;AAGA,SAAgB,aAAa,KAAuC;CAGlE,OAFa,WAEH,CAAC,EAAE,QAAQ,MAAM,UAAU,MAAM,QAAQ,GAAG;AACxD;;;;;;;;;;;AAYA,SAAgB,QAAQ,EAAE,YAAqC;CAC7D,MAAM,OAAO,WAAW;CACxB,MAAM,QAAQ,SAAS;CAEvB,IAAI,CAAC,MAAM,OAAO,oBAAA,YAAA,EAAG,SAAW,CAAA;CAEhC,OACE,qBAAC,oBAAD;EAAoB,OAAO;GAAE,OAAO,KAAK;GAAO,WAAW;EAAO;EAAlE,UAAA,CACE,oBAAC,MAAD,EAAM,OAAO,GAAG,KAAK,MAAM,KAAK,MAAM,YAAc,CAAA,GACpD,oBAAC,WAAD;GAAiB;GAAO;EAAoB,CAAA,CAC1B;;AAExB;;AAWA,SAAgB,UAAU,EAAE,MAAM,WAAW,MAAM,aAA6B;CAC9E,MAAM,OAAO,WAAW;CACxB,MAAM,QAAQ,MAAM,QAAQ,MAAM,cAAc,UAAU,QAAQ,IAAI;CAEtE,IAAI,CAAC,QAAQ,CAAC,OAAO,OAAO,oBAAA,YAAA,EAAA,UAAG,SAAW,CAAA;CAE1C,OACE,oBAAC,oBAAD;EAAoB,OAAO;GAAE,OAAO,KAAK;GAAO,WAAW;EAAO;EAChE,UAAA,oBAAC,OAAD;GAAK,aAAU;GAAa,cAAY;GAAM,WAAW,GAAG,WAAW,SAAS;GAC9E,UAAA,oBAAC,sBAAD,EAA6B,MAAQ,CAAA;EAClC,CAAA;CACa,CAAA;AAExB;;AAKA,SAAgB,SAAS,EAAE,MAAM,GAAG,SAA0B;CAC5D,OAAO,oBAAC,WAAD;EAAW,MAAM,OAAO,QAAQ,SAAS;EAAQ,GAAI;CAAQ,CAAA;AACtE;;AAGA,SAAgB,UAAU,EAAE,MAAM,GAAG,SAA0B;CAC7D,OAAO,oBAAC,WAAD;EAAW,MAAM,OAAO,SAAS,SAAS;EAAS,GAAI;CAAQ,CAAA;AACxE;;AAGA,SAAgB,aAAa,EAAE,MAAM,GAAG,SAA0B;CAChE,OAAO,oBAAC,WAAD;EAAW,MAAM,OAAO,YAAY,SAAS;EAAY,GAAI;CAAQ,CAAA;AAC9E;;AAGA,SAAgB,YAAY,EAC1B,WAAW,UACX,GAAG,SACiE;CACpE,OAAO,oBAAC,WAAD;EAAW,MAAM,aAAa,WAAW,kBAAkB;EAAiB,GAAI;CAAQ,CAAA;AACjG"}

package/dist/app/hooks.d.ts

@@ -0,0 +1,79 @@
+import { FormStore, LivePropsOptions, PageMethodArguments, PageMethodCallOptions, ShortcutOptions } from "@alfakit/core";
+//#region src/app/hooks.d.ts
+export interface UsePageMethodOptions<TResult, TArgs> extends PageMethodCallOptions<TArgs> {
+  onSuccess?: (result: TResult, args: TArgs | undefined) => void;
+  onError?: (error: unknown, args: TArgs | undefined) => void;
+}
+export interface PageMethodBinding<TResult, TArgs> {
+  /** Call the method. Resolves with its result, or `undefined` when it failed. */
+  call: (args?: TArgs, options?: PageMethodCallOptions<TArgs>) => Promise<TResult | undefined>;
+  /** Like `call`, but rejects with the error (`PageMethodError`) when it fails. */
+  callOrThrow: (args?: TArgs, options?: PageMethodCallOptions<TArgs>) => Promise<TResult>;
+  loading: boolean;
+  result: TResult | undefined;
+  error: unknown;
+  /** Validation errors of the last call, first message per key (`{ sku: '…' }`). */
+  errors: Record<string, string>;
+  reset: () => void;
+}
+/**
+ * Call one `#[Expose]` method of the page:
+ *
+ * ```tsx
+ * const checkout = usePageMethod<Order, { items: CartLine[] }>('checkout', { forms: ['customer'] })
+ * <Button disabled={checkout.loading} onClick={() => checkout.call({ items })}>Charge</Button>
+ * ```
+ *
+ * Notifications are shown as toasts, redirects followed, `reloadProps()` applied.
+ */
+export declare function usePageMethod<TResult = unknown, TArgs extends PageMethodArguments = Record<string, unknown>>(method: string, options?: UsePageMethodOptions<TResult, TArgs>): PageMethodBinding<TResult, TArgs>;
+/** A map of method names to their arguments and results, for typed `usePageMethods()`. */
+export type PageMethodMap = Record<string, {
+  args?: PageMethodArguments;
+  result?: unknown;
+}>;
+export interface PageMethodsBinding<TMap extends PageMethodMap> {
+  call: <K extends keyof TMap & string>(method: K, args?: TMap[K]['args'], options?: PageMethodCallOptions<TMap[K]['args']>) => Promise<TMap[K]['result'] | undefined>;
+  callOrThrow: <K extends keyof TMap & string>(method: K, args?: TMap[K]['args'], options?: PageMethodCallOptions<TMap[K]['args']>) => Promise<TMap[K]['result']>;
+  /** True while any call is in flight; `isLoading('checkout')` for one method. */
+  loading: boolean;
+  isLoading: (method: keyof TMap & string) => boolean;
+  /** Validation errors of the last failed call, by method. */
+  errors: Partial<Record<keyof TMap & string, Record<string, string>>>;
+}
+/**
+ * Call any `#[Expose]` method of the page by name. Type it with a map:
+ * `usePageMethods<{ addItem: { args: { sku: string }; result: CartLine } }>()`.
+ */
+export declare function usePageMethods<TMap extends PageMethodMap = PageMethodMap>(defaults?: PageMethodCallOptions): PageMethodsBinding<TMap>;
+/**
+ * Reload view data (`getViewData()` keys) with an Inertia partial reload:
+ * `const { reload, reloading } = useReloadProps(['cart'])`.
+ */
+export declare function useReloadProps(only?: string[]): {
+  reload: (props?: string[]) => Promise<void>;
+  reloading: boolean;
+};
+/**
+ * Keep view data props fresh while the component is mounted: every `poll` interval, and/or
+ * when a Laravel Echo event arrives (`echo: { channel, events }`).
+ */
+export declare function useLiveProps(only: string[], options: LivePropsOptions): void;
+/**
+ * A keyboard shortcut while the component is mounted: `useShortcut('mod+k', openSearch)`.
+ * Shortcuts without a modifier are ignored while typing unless `allowInInputs` is set.
+ */
+export declare function useShortcut(keys: string | string[], handler: (event: KeyboardEvent) => void, options?: ShortcutOptions & {
+  enabled?: boolean;
+}): void;
+/**
+ * The store and state of an embedded `<PageForm name>`: read its values, or reset fields
+ * with `store.setValue()`. `store` is undefined until the form has mounted.
+ */
+export declare function usePageForm(name: string): {
+  store: FormStore | undefined;
+  values: Record<string, unknown>;
+  errors: Record<string, string[]>;
+};
+//#endregion
+//# sourceMappingURL=hooks.d.ts.map

package/dist/app/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","names":[],"sources":["../../src/app/hooks.ts"],"mappings":";;iBAiDiB,qBAAqB,SAAS,eAAe,sBAAsB;EAClF,aAAa,QAAQ,SAAS,MAAM;EACpC,WAAW,gBAAgB,MAAM;;iBAGlB,kBAAkB,SAAS;;EAE1C,OAAO,OAAO,OAAO,UAAU,sBAAsB,WAAW,QAAQ;;EAExE,cAAc,OAAO,OAAO,UAAU,sBAAsB,WAAW,QAAQ;EAC/E;EACA,QAAQ;EACR;;EAEA,QAAQ;EACR;;;;;;;;;;;;wBAac,cACd,mBACA,cAAc,sBAAsB,yBAEpC,gBACA,UAAS,qBAAqB,SAAS,SACtC,kBAAkB,SAAS;;YA2FlB,gBAAgB;EAAiB,OAAO;EAAqB;;iBAExD,mBAAmB,aAAa;EAC/C,OAAO,gBAAgB,eACrB,QAAQ,GACR,OAAO,KAAK,YACZ,UAAU,sBAAsB,KAAK,gBAClC,QAAQ,KAAK;EAClB,cAAc,gBAAgB,eAC5B,QAAQ,GACR,OAAO,KAAK,YACZ,UAAU,sBAAsB,KAAK,gBAClC,QAAQ,KAAK;;EAElB;EACA,YAAY,cAAc;;EAE1B,QAAQ,QAAQ,aAAa,eAAe;;;;;;wBAO9B,eAAe,aAAa,gBAAgB,eAC1D,WAAU,wBACT,mBAAmB;;;;;wBAkEN,eAAe;EAC7B,SAAS,qBAAqB;EAC9B;;;;;;wBAyBc,aAAa,gBAAgB,SAAS;;;;;wBActC,YACd,yBACA,UAAU,OAAO,wBACjB,UAAS;EAAoB;;;;;;wBAgCf,YAAY;EAC1B,OAAO;EACP,QAAQ;EACR,QAAQ"}

package/dist/app/hooks.js

@@ -0,0 +1,239 @@
+import { usePageSchema, usePanel, useT } from "../context.js";
+import { showToast } from "../components/notifications/flash-toasts.js";
+import { PageMethodError, firstErrors, getPageForm, onPageFormsChanged, registerShortcut, reloadPageProps, runPageMethod, watchPageProps } from "@alfakit/core";
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+//#region src/app/hooks.ts
+/**
+* Hooks for custom page components (`Page::$component`): call `#[Expose]` methods, reload
+* and watch view data, keyboard shortcuts, and the state of embedded `<PageForm>`s.
+*/
+function useRuntime() {
+	const page = usePageSchema();
+	const panel = usePanel();
+	const t = useT();
+	const latest = useRef({
+		page,
+		panel,
+		t
+	});
+	useEffect(() => {
+		latest.current = {
+			page,
+			panel,
+			t
+		};
+	});
+	return useCallback(() => ({
+		token: latest.current.page?.token ?? "",
+		panel: latest.current.panel,
+		page: latest.current.page,
+		showToast: (notification) => showToast(notification),
+		t: latest.current.t
+	}), []);
+}
+/**
+* Call one `#[Expose]` method of the page:
+*
+* ```tsx
+* const checkout = usePageMethod<Order, { items: CartLine[] }>('checkout', { forms: ['customer'] })
+* <Button disabled={checkout.loading} onClick={() => checkout.call({ items })}>Charge</Button>
+* ```
+*
+* Notifications are shown as toasts, redirects followed, `reloadProps()` applied.
+*/
+function usePageMethod(method, options = {}) {
+	const runtime = useRuntime();
+	const [state, setState] = useState({
+		loading: 0,
+		result: void 0,
+		error: null,
+		errors: {}
+	});
+	const optionsRef = useRef(options);
+	useEffect(() => {
+		optionsRef.current = options;
+	});
+	const mounted = useRef(true);
+	useEffect(() => {
+		mounted.current = true;
+		return () => {
+			mounted.current = false;
+		};
+	}, []);
+	const callOrThrow = useCallback(async (args, overrides = {}) => {
+		const { onSuccess, onError, ...defaults } = optionsRef.current;
+		setState((current) => ({
+			...current,
+			loading: current.loading + 1,
+			error: null
+		}));
+		try {
+			const result = await runPageMethod(method, args, runtime(), {
+				...defaults,
+				...overrides
+			});
+			if (mounted.current) setState((current) => ({
+				loading: Math.max(0, current.loading - 1),
+				result,
+				error: null,
+				errors: {}
+			}));
+			onSuccess?.(result, args);
+			return result;
+		} catch (error) {
+			if (mounted.current) setState((current) => ({
+				...current,
+				loading: Math.max(0, current.loading - 1),
+				error,
+				errors: error instanceof PageMethodError && error.isValidation ? firstErrors(error.errors) : {}
+			}));
+			onError?.(error, args);
+			throw error;
+		}
+	}, [method, runtime]);
+	const call = useCallback((args, overrides) => callOrThrow(args, overrides).catch(() => void 0), [callOrThrow]);
+	const reset = useCallback(() => setState({
+		loading: 0,
+		result: void 0,
+		error: null,
+		errors: {}
+	}), []);
+	return {
+		call,
+		callOrThrow,
+		loading: state.loading > 0,
+		result: state.result,
+		error: state.error,
+		errors: state.errors,
+		reset
+	};
+}
+/**
+* Call any `#[Expose]` method of the page by name. Type it with a map:
+* `usePageMethods<{ addItem: { args: { sku: string }; result: CartLine } }>()`.
+*/
+function usePageMethods(defaults = {}) {
+	const runtime = useRuntime();
+	const [pending, setPending] = useState({});
+	const [errors, setErrors] = useState({});
+	const defaultsRef = useRef(defaults);
+	useEffect(() => {
+		defaultsRef.current = defaults;
+	});
+	const callOrThrow = useCallback(async (method, args, options = {}) => {
+		setPending((current) => ({
+			...current,
+			[method]: (current[method] ?? 0) + 1
+		}));
+		try {
+			const result = await runPageMethod(method, args, runtime(), {
+				...defaultsRef.current,
+				...options
+			});
+			setErrors((current) => {
+				if (!current[method]) return current;
+				const next = { ...current };
+				delete next[method];
+				return next;
+			});
+			return result;
+		} catch (error) {
+			if (error instanceof PageMethodError && error.isValidation) setErrors((current) => ({
+				...current,
+				[method]: firstErrors(error.errors)
+			}));
+			throw error;
+		} finally {
+			setPending((current) => ({
+				...current,
+				[method]: Math.max(0, (current[method] ?? 1) - 1)
+			}));
+		}
+	}, [runtime]);
+	const call = useCallback((method, args, options) => callOrThrow(method, args, options).catch(() => void 0), [callOrThrow]);
+	return useMemo(() => ({
+		callOrThrow,
+		call,
+		loading: Object.values(pending).some((count) => count > 0),
+		isLoading: (method) => (pending[method] ?? 0) > 0,
+		errors
+	}), [
+		callOrThrow,
+		call,
+		pending,
+		errors
+	]);
+}
+/**
+* Reload view data (`getViewData()` keys) with an Inertia partial reload:
+* `const { reload, reloading } = useReloadProps(['cart'])`.
+*/
+function useReloadProps(only) {
+	const [reloading, setReloading] = useState(0);
+	const key = JSON.stringify(only ?? null);
+	return {
+		reload: useCallback(async (props) => {
+			setReloading((count) => count + 1);
+			try {
+				await reloadPageProps(props ?? JSON.parse(key) ?? void 0);
+			} finally {
+				setReloading((count) => Math.max(0, count - 1));
+			}
+		}, [key]),
+		reloading: reloading > 0
+	};
+}
+/**
+* Keep view data props fresh while the component is mounted: every `poll` interval, and/or
+* when a Laravel Echo event arrives (`echo: { channel, events }`).
+*/
+function useLiveProps(only, options) {
+	const key = JSON.stringify([only, options]);
+	useEffect(() => {
+		const [props, live] = JSON.parse(key);
+		return watchPageProps(props, live);
+	}, [key]);
+}
+/**
+* A keyboard shortcut while the component is mounted: `useShortcut('mod+k', openSearch)`.
+* Shortcuts without a modifier are ignored while typing unless `allowInInputs` is set.
+*/
+function useShortcut(keys, handler, options = {}) {
+	const handlerRef = useRef(handler);
+	useEffect(() => {
+		handlerRef.current = handler;
+	});
+	const key = JSON.stringify([
+		keys,
+		options.allowInInputs,
+		options.preventDefault
+	]);
+	const enabled = options.enabled !== false;
+	useEffect(() => {
+		if (!enabled) return;
+		const [bindings, allowInInputs, preventDefault] = JSON.parse(key);
+		return registerShortcut(bindings, (event) => handlerRef.current(event), {
+			allowInInputs,
+			preventDefault
+		});
+	}, [key, enabled]);
+}
+const noopSubscribe = () => () => {};
+/**
+* The store and state of an embedded `<PageForm name>`: read its values, or reset fields
+* with `store.setValue()`. `store` is undefined until the form has mounted.
+*/
+function usePageForm(name) {
+	const store = useSyncExternalStore(onPageFormsChanged, () => getPageForm(name), () => void 0);
+	const subscribe = useCallback((listener) => store ? store.store.subscribe(listener) : noopSubscribe(), [store]);
+	const state = useSyncExternalStore(subscribe, () => store?.store.get(), () => void 0);
+	return {
+		store,
+		values: state?.values ?? {},
+		errors: state?.errors ?? {}
+	};
+}
+//#endregion
+export { useLiveProps, usePageForm, usePageMethod, usePageMethods, useReloadProps, useShortcut };
+
+//# sourceMappingURL=hooks.js.map

package/dist/app/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","names":[],"sources":["../../src/app/hooks.ts"],"sourcesContent":["import {\n  firstErrors,\n  getPageForm,\n  onPageFormsChanged,\n  PageMethodError,\n  registerShortcut,\n  reloadPageProps,\n  runPageMethod,\n  watchPageProps,\n  type FormState,\n  type FormStore,\n  type LivePropsOptions,\n  type PageMethodArguments,\n  type PageMethodCallOptions,\n  type PageMethodRuntime,\n  type ShortcutOptions,\n} from '@alfakit/core'\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react'\nimport { showToast } from '../components/notifications/flash-toasts'\nimport { usePageSchema, usePanel, useT } from '../context'\n\n/**\n * Hooks for custom page components (`Page::$component`): call `#[Expose]` methods, reload\n * and watch view data, keyboard shortcuts, and the state of embedded `<PageForm>`s.\n */\n\nfunction useRuntime(): () => PageMethodRuntime {\n  const page = usePageSchema()\n  const panel = usePanel()\n  const t = useT()\n  const latest = useRef({ page, panel, t })\n\n  useEffect(() => {\n    latest.current = { page, panel, t }\n  })\n\n  // The token is re-issued with every response, so it is read when the call starts.\n  return useCallback(\n    () => ({\n      token: latest.current.page?.token ?? '',\n      panel: latest.current.panel,\n      page: latest.current.page,\n      showToast: (notification) => showToast(notification),\n      t: latest.current.t,\n    }),\n    [],\n  )\n}\n\nexport interface UsePageMethodOptions<TResult, TArgs> extends PageMethodCallOptions<TArgs> {\n  onSuccess?: (result: TResult, args: TArgs | undefined) => void\n  onError?: (error: unknown, args: TArgs | undefined) => void\n}\n\nexport interface PageMethodBinding<TResult, TArgs> {\n  /** Call the method. Resolves with its result, or `undefined` when it failed. */\n  call: (args?: TArgs, options?: PageMethodCallOptions<TArgs>) => Promise<TResult | undefined>\n  /** Like `call`, but rejects with the error (`PageMethodError`) when it fails. */\n  callOrThrow: (args?: TArgs, options?: PageMethodCallOptions<TArgs>) => Promise<TResult>\n  loading: boolean\n  result: TResult | undefined\n  error: unknown\n  /** Validation errors of the last call, first message per key (`{ sku: '…' }`). */\n  errors: Record<string, string>\n  reset: () => void\n}\n\n/**\n * Call one `#[Expose]` method of the page:\n *\n * ```tsx\n * const checkout = usePageMethod<Order, { items: CartLine[] }>('checkout', { forms: ['customer'] })\n * <Button disabled={checkout.loading} onClick={() => checkout.call({ items })}>Charge</Button>\n * ```\n *\n * Notifications are shown as toasts, redirects followed, `reloadProps()` applied.\n */\nexport function usePageMethod<\n  TResult = unknown,\n  TArgs extends PageMethodArguments = Record<string, unknown>,\n>(\n  method: string,\n  options: UsePageMethodOptions<TResult, TArgs> = {},\n): PageMethodBinding<TResult, TArgs> {\n  const runtime = useRuntime()\n  const [state, setState] = useState<{\n    loading: number\n    result: TResult | undefined\n    error: unknown\n    errors: Record<string, string>\n  }>({ loading: 0, result: undefined, error: null, errors: {} })\n  const optionsRef = useRef(options)\n\n  useEffect(() => {\n    optionsRef.current = options\n  })\n  const mounted = useRef(true)\n\n  useEffect(() => {\n    mounted.current = true\n\n    return () => {\n      mounted.current = false\n    }\n  }, [])\n\n  const callOrThrow = useCallback(\n    async (args?: TArgs, overrides: PageMethodCallOptions<TArgs> = {}): Promise<TResult> => {\n      const { onSuccess, onError, ...defaults } = optionsRef.current\n\n      setState((current) => ({ ...current, loading: current.loading + 1, error: null }))\n\n      try {\n        const result = await runPageMethod<TResult, TArgs>(method, args, runtime(), {\n          ...defaults,\n          ...overrides,\n        })\n\n        if (mounted.current) {\n          setState((current) => ({\n            loading: Math.max(0, current.loading - 1),\n            result,\n            error: null,\n            errors: {},\n          }))\n        }\n\n        onSuccess?.(result, args)\n\n        return result\n      } catch (error) {\n        if (mounted.current) {\n          setState((current) => ({\n            ...current,\n            loading: Math.max(0, current.loading - 1),\n            error,\n            errors:\n              error instanceof PageMethodError && error.isValidation\n                ? firstErrors(error.errors)\n                : {},\n          }))\n        }\n\n        onError?.(error, args)\n\n        throw error\n      }\n    },\n    [method, runtime],\n  )\n\n  const call = useCallback(\n    (args?: TArgs, overrides?: PageMethodCallOptions<TArgs>) =>\n      callOrThrow(args, overrides).catch(() => undefined),\n    [callOrThrow],\n  )\n\n  const reset = useCallback(\n    () => setState({ loading: 0, result: undefined, error: null, errors: {} }),\n    [],\n  )\n\n  return {\n    call,\n    callOrThrow,\n    loading: state.loading > 0,\n    result: state.result,\n    error: state.error,\n    errors: state.errors,\n    reset,\n  }\n}\n\n/** A map of method names to their arguments and results, for typed `usePageMethods()`. */\nexport type PageMethodMap = Record<string, { args?: PageMethodArguments; result?: unknown }>\n\nexport interface PageMethodsBinding<TMap extends PageMethodMap> {\n  call: <K extends keyof TMap & string>(\n    method: K,\n    args?: TMap[K]['args'],\n    options?: PageMethodCallOptions<TMap[K]['args']>,\n  ) => Promise<TMap[K]['result'] | undefined>\n  callOrThrow: <K extends keyof TMap & string>(\n    method: K,\n    args?: TMap[K]['args'],\n    options?: PageMethodCallOptions<TMap[K]['args']>,\n  ) => Promise<TMap[K]['result']>\n  /** True while any call is in flight; `isLoading('checkout')` for one method. */\n  loading: boolean\n  isLoading: (method: keyof TMap & string) => boolean\n  /** Validation errors of the last failed call, by method. */\n  errors: Partial<Record<keyof TMap & string, Record<string, string>>>\n}\n\n/**\n * Call any `#[Expose]` method of the page by name. Type it with a map:\n * `usePageMethods<{ addItem: { args: { sku: string }; result: CartLine } }>()`.\n */\nexport function usePageMethods<TMap extends PageMethodMap = PageMethodMap>(\n  defaults: PageMethodCallOptions = {},\n): PageMethodsBinding<TMap> {\n  const runtime = useRuntime()\n  const [pending, setPending] = useState<Record<string, number>>({})\n  const [errors, setErrors] = useState<Record<string, Record<string, string>>>({})\n  const defaultsRef = useRef(defaults)\n\n  useEffect(() => {\n    defaultsRef.current = defaults\n  })\n\n  const callOrThrow = useCallback(\n    async (method: string, args?: PageMethodArguments, options: PageMethodCallOptions = {}) => {\n      setPending((current) => ({ ...current, [method]: (current[method] ?? 0) + 1 }))\n\n      try {\n        const result = await runPageMethod(method, args, runtime(), {\n          ...defaultsRef.current,\n          ...options,\n        } as PageMethodCallOptions<PageMethodArguments>)\n\n        setErrors((current) => {\n          if (!current[method]) return current\n          const next = { ...current }\n          delete next[method]\n\n          return next\n        })\n\n        return result\n      } catch (error) {\n        if (error instanceof PageMethodError && error.isValidation) {\n          setErrors((current) => ({ ...current, [method]: firstErrors(error.errors) }))\n        }\n\n        throw error\n      } finally {\n        setPending((current) => ({ ...current, [method]: Math.max(0, (current[method] ?? 1) - 1) }))\n      }\n    },\n    [runtime],\n  )\n\n  // `call` and `callOrThrow` keep their identity, so they are safe effect dependencies.\n  const call = useCallback(\n    (method: string, args?: PageMethodArguments, options?: PageMethodCallOptions) =>\n      callOrThrow(method, args, options).catch(() => undefined),\n    [callOrThrow],\n  )\n\n  return useMemo(\n    () =>\n      ({\n        callOrThrow,\n        call,\n        loading: Object.values(pending).some((count) => count > 0),\n        isLoading: (method: string) => (pending[method] ?? 0) > 0,\n        errors,\n      }) as unknown as PageMethodsBinding<TMap>,\n    [callOrThrow, call, pending, errors],\n  )\n}\n\n/**\n * Reload view data (`getViewData()` keys) with an Inertia partial reload:\n * `const { reload, reloading } = useReloadProps(['cart'])`.\n */\nexport function useReloadProps(only?: string[]): {\n  reload: (props?: string[]) => Promise<void>\n  reloading: boolean\n} {\n  const [reloading, setReloading] = useState(0)\n  const key = JSON.stringify(only ?? null)\n\n  const reload = useCallback(\n    async (props?: string[]) => {\n      setReloading((count) => count + 1)\n\n      try {\n        await reloadPageProps(props ?? (JSON.parse(key) as string[] | null) ?? undefined)\n      } finally {\n        setReloading((count) => Math.max(0, count - 1))\n      }\n    },\n    [key],\n  )\n\n  return { reload, reloading: reloading > 0 }\n}\n\n/**\n * Keep view data props fresh while the component is mounted: every `poll` interval, and/or\n * when a Laravel Echo event arrives (`echo: { channel, events }`).\n */\nexport function useLiveProps(only: string[], options: LivePropsOptions): void {\n  const key = JSON.stringify([only, options])\n\n  useEffect(() => {\n    const [props, live] = JSON.parse(key) as [string[], LivePropsOptions]\n\n    return watchPageProps(props, live)\n  }, [key])\n}\n\n/**\n * A keyboard shortcut while the component is mounted: `useShortcut('mod+k', openSearch)`.\n * Shortcuts without a modifier are ignored while typing unless `allowInInputs` is set.\n */\nexport function useShortcut(\n  keys: string | string[],\n  handler: (event: KeyboardEvent) => void,\n  options: ShortcutOptions & { enabled?: boolean } = {},\n): void {\n  const handlerRef = useRef(handler)\n\n  useEffect(() => {\n    handlerRef.current = handler\n  })\n  const key = JSON.stringify([keys, options.allowInInputs, options.preventDefault])\n  const enabled = options.enabled !== false\n\n  useEffect(() => {\n    if (!enabled) return\n\n    const [bindings, allowInInputs, preventDefault] = JSON.parse(key) as [\n      string | string[],\n      boolean | undefined,\n      boolean | undefined,\n    ]\n\n    return registerShortcut(bindings, (event) => handlerRef.current(event), {\n      allowInInputs,\n      preventDefault,\n    })\n  }, [key, enabled])\n}\n\nconst noopSubscribe = () => () => {}\n\n/**\n * The store and state of an embedded `<PageForm name>`: read its values, or reset fields\n * with `store.setValue()`. `store` is undefined until the form has mounted.\n */\nexport function usePageForm(name: string): {\n  store: FormStore | undefined\n  values: Record<string, unknown>\n  errors: Record<string, string[]>\n} {\n  const store = useSyncExternalStore(\n    onPageFormsChanged,\n    () => getPageForm(name),\n    () => undefined,\n  )\n\n  const subscribe = useCallback(\n    (listener: () => void) => (store ? store.store.subscribe(listener) : noopSubscribe()),\n    [store],\n  )\n  const state = useSyncExternalStore<FormState | undefined>(\n    subscribe,\n    () => store?.store.get(),\n    () => undefined,\n  )\n\n  return { store, values: state?.values ?? {}, errors: state?.errors ?? {} }\n}\n"],"mappings":"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"}

package/dist/components/actions/action-button.d.ts

@@ -0,0 +1,17 @@
+import { ActionContext, ActionSchema } from "@alfakit/core";
+//#region src/components/actions/action-button.d.ts
+export interface ActionButtonProps {
+  action: ActionSchema;
+  context: ActionContext;
+  size?: 'xs' | 'sm' | 'default' | 'lg';
+  className?: string;
+  /** Force a variant (e.g. menu items render as plain rows). */
+  variant?: ActionSchema['variant'];
+  /** Bind the action's key bindings globally while mounted. */
+  withKeyBindings?: boolean;
+  /** Override how the action runs (e.g. a form submits its values). */
+  onTrigger?: (action: ActionSchema, context: ActionContext) => void | Promise<void>;
+}
+export declare function ActionButton({ action, context, size, className, variant: variantProp, withKeyBindings, onTrigger }: ActionButtonProps): import("react").JSX.Element;
+//#endregion
+//# sourceMappingURL=action-button.d.ts.map

package/dist/components/actions/action-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-button.d.ts","names":[],"sources":["../../../src/components/actions/action-button.tsx"],"mappings":";;iBA8CiB;EACf,QAAQ;EACR,SAAS;EACT;EACA;;EAEA,UAAU;;EAEV;;EAEA,aAAa,QAAQ,cAAc,SAAS,yBAAyB;;wBA8BvD,eACd,QACA,SACA,MACA,WACA,SAAS,aACT,iBACA,aACC,oCAAiB,IAAA"}