@alfakit/core 0.1.1 → 0.1.6

package/dist/starter-kit-widgets.d.ts

@@ -1,11 +1,14 @@
+import { AiCopilotSchema } from "./schema/ai.js";
+import { StandaloneComponentSchema } from "./schema/standalone.js";
 import { PageSchema, PanelSchema, StarterKitNavigationSchema, StarterKitWidgetsSchema } from "./schema/panel.js";
 //#region src/starter-kit-widgets.d.ts
 /**
  * The drop-in header components of starter kit mode: `<AlfakitSearch />` (the command
- * palette and global search), `<AlfakitNotifications />` (the database notifications bell)
- * and `<AlfakitTenantSwitcher />`. They render on every page of the host application, from
- * the `widgets` of the shared `alfakitNavigation` prop; their code and the panel data
- * (translations, endpoints, the palette, realtime) load the first time one of them renders.
+ * palette and global search), `<AlfakitNotifications />` (the database notifications bell),
+ * `<AlfakitTenantSwitcher />` and `<AlfakitCopilot />` (the AI plugin's copilot). They render
+ * on every page of the host application, from the `widgets` of the shared
+ * `alfakitNavigation` prop; their code and the panel data (translations, endpoints, the
+ * palette, realtime) load the first time one of them renders.
  * Shared by the three renderers.
  */
 /** One starter kit panel's navigation with its header components' data. */
@@ -14,10 +17,13 @@ export interface StarterKitWidgets {
   widgets: StarterKitWidgetsSchema;
 }
 /**
- * The header components' data of a `starterKit()` panel (the first one with any unless
- * `panelId` is given), or null for guests and pages of other panels.
+ * The header components' data of a `starterKit()` panel, or null for guests and pages of
+ * other panels. Without `panelId`: the open AlfaKit page's panel, else the first one with
+ * any; with `part` (`'tenancy'` for the tenant switcher), the first panel that has that
+ * part when the preferred one hasn't, so a team workspace on a second panel still gets its
+ * switcher on the host's own pages.
  */
-export declare function starterKitWidgets(props: unknown, panelId?: string): StarterKitWidgets | null;
+export declare function starterKitWidgets(props: unknown, panelId?: string, part?: keyof StarterKitWidgetsSchema): StarterKitWidgets | null;
 /** Whether the open page is one of the panel's own (it carries the `alfakit` prop). */
 export declare function isAlfakitPage(props: unknown): boolean;
 /** Load (once) the panel data the header components render with. */
@@ -50,5 +56,32 @@ export declare function requestStarterKitSearch(): void;
  * true when it did.
  */
 export declare function openRequestedStarterKitSearch(): boolean;
+/** The copilot's shortcut id (the loaded `ai:copilot` component registers the same one). */
+export declare const STARTER_KIT_COPILOT_SHORTCUT = "ai.copilot";
+/**
+ * Register the copilot's key bindings (`mod+j`) before its code has loaded: pressing them
+ * (or clicking the button) records the request, and the copilot opens once it has loaded.
+ * The loaded copilot registers the same id, so it replaces this registration.
+ */
+export declare function registerStarterKitCopilotShortcut(keys: string[], label: string, onRequest?: () => void): () => void;
+/** Ask for the copilot to open as soon as it has loaded. */
+export declare function requestStarterKitCopilot(): void;
+/** Whether the copilot was asked for before it loaded (and forget the request). */
+export declare function takeRequestedStarterKitCopilot(): boolean;
+/**
+ * The copilot component in the loaded panel data: the panel's own pages show it in the
+ * `topbar.end` slot, which starter kit hosts don't render. Null without the AI plugin's
+ * copilot (or when the user may not use it).
+ */
+export declare function starterKitCopilot(panel: PanelSchema): AiCopilotSchema | null;
+/**
+ * The dashboard widgets of a `starterKit()` panel on the host's dashboard
+ * (`<AlfakitWidgets />`, the `alfakitWidgets` prop): a standalone widgets payload bound to
+ * the panel, the first panel's unless `panelId` is given. Null on other pages, for guests,
+ * users who may not open the panel and panels without widgets.
+ */
+export declare function starterKitDashboardWidgets(props: unknown, panelId?: string): StandaloneComponentSchema | null;
+/** How many widgets a dashboard widgets payload has (placeholders before its code loads). */
+export declare function standaloneWidgetCount(component: StandaloneComponentSchema): number;
 //#endregion
 //# sourceMappingURL=starter-kit-widgets.d.ts.map

package/dist/starter-kit-widgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starter-kit-widgets.d.ts","names":[],"sources":["../src/starter-kit-widgets.ts"],"mappings":";;;;;;;;;;;iBAoBiB;EACf,YAAY;EACZ,SAAS;;;;;;wBAOK,kBAAkB,gBAAgB,mBAAmB;;wBASrD,cAAc;;wBAYd,oBAAoB,mBAAmB,QAAQ;;wBAuB/C,sBAAsB,mBAAmB;;wBAKzC;;;;;;;;wBAYA,uBAAuB,MAAM,aAAa,QAAQ,oBAAoB;;wBAyBtE,yBAAyB;;;;;;;wBAczB,iCACd,gBACA,eACA;;wBAgBc;;;;;wBAQA"}
+{"version":3,"file":"starter-kit-widgets.d.ts","names":[],"sources":["../src/starter-kit-widgets.ts"],"mappings":";;;;;;;;;;;;;;iBAyBiB;EACf,YAAY;EACZ,SAAS;;;;;;;;;wBAUK,kBACd,gBACA,kBACA,aAAa,0BACZ;;wBAaa,cAAc;;wBAYd,oBAAoB,mBAAmB,QAAQ;;wBAqC/C,sBAAsB,mBAAmB;;wBAKzC;;;;;;;;wBAYA,uBAAuB,MAAM,aAAa,QAAQ,oBAAoB;;wBAyBtE,yBAAyB;;;;;;;wBAczB,iCACd,gBACA,eACA;;wBAgBc;;;;;wBAQA;;qBAWH;;;;;;wBASG,kCACd,gBACA,eACA;;wBAkBc;;wBAKA;;;;;;wBAaA,kBAAkB,OAAO,cAAc;;;;;;;wBAkBvC,2BACd,gBACA,mBACC;;wBAaa,sBAAsB,WAAW"}

package/dist/starter-kit-widgets.js

@@ -1,13 +1,17 @@
 import { requestJson } from "./http.js";
 import { SHORTCUT_IDS, shortcuts } from "./shortcuts.js";
-import { starterKitNavigations } from "./starter-kit.js";
+import { preferCurrentStarterKitPanel, starterKitNavigations } from "./starter-kit.js";
 //#region src/starter-kit-widgets.ts
 /**
-* The header components' data of a `starterKit()` panel (the first one with any unless
-* `panelId` is given), or null for guests and pages of other panels.
+* The header components' data of a `starterKit()` panel, or null for guests and pages of
+* other panels. Without `panelId`: the open AlfaKit page's panel, else the first one with
+* any; with `part` (`'tenancy'` for the tenant switcher), the first panel that has that
+* part when the preferred one hasn't, so a team workspace on a second panel still gets its
+* switcher on the host's own pages.
 */
-function starterKitWidgets(props, panelId) {
-	const navigation = starterKitNavigations(props).find((entry) => entry.widgets !== void 0 && (panelId === void 0 || entry.id === panelId));
+function starterKitWidgets(props, panelId, part) {
+	const entries = preferCurrentStarterKitPanel(starterKitNavigations(props), props).filter((entry) => entry.widgets !== void 0 && (panelId === void 0 || entry.id === panelId));
+	const navigation = (part !== void 0 && panelId === void 0 ? entries.find((entry) => entry.widgets?.[part] !== void 0) : void 0) ?? entries[0];
 	return navigation?.widgets ? {
 		navigation,
 		widgets: navigation.widgets
@@ -24,9 +28,10 @@ function loadStarterKitPanel(endpoint) {
 	let request = requests.get(endpoint);
 	if (!request) {
 		request = requestJson(endpoint).then((panel) => {
+			if (!isPanelData(panel)) throw new Error(`The starter kit endpoint ${endpoint} did not answer the panel data.`);
 			panels.set(endpoint, panel);
 			return panel;
-		}, (error) => {
+		}).catch((error) => {
 			requests.delete(endpoint);
 			throw error;
 		});
@@ -34,6 +39,9 @@ function loadStarterKitPanel(endpoint) {
 	}
 	return request;
 }
+function isPanelData(value) {
+	return typeof value === "object" && value !== null && typeof value.endpoints === "object" && value.endpoints !== null;
+}
 /** The panel data once loaded, or null (so remounts render straight away). */
 function loadedStarterKitPanel(endpoint) {
 	return panels.get(endpoint) ?? null;
@@ -125,7 +133,63 @@ function openRequestedStarterKitSearch() {
 	searchRequested = false;
 	return shortcuts.trigger(SHORTCUT_IDS.palette);
 }
+/** The copilot's shortcut id (the loaded `ai:copilot` component registers the same one). */
+const STARTER_KIT_COPILOT_SHORTCUT = "ai.copilot";
+let copilotRequested = false;
+/**
+* Register the copilot's key bindings (`mod+j`) before its code has loaded: pressing them
+* (or clicking the button) records the request, and the copilot opens once it has loaded.
+* The loaded copilot registers the same id, so it replaces this registration.
+*/
+function registerStarterKitCopilotShortcut(keys, label, onRequest) {
+	if (keys.length === 0) return () => {};
+	return shortcuts.register({
+		id: STARTER_KIT_COPILOT_SHORTCUT,
+		keys,
+		label,
+		group: "general",
+		allowInInputs: true,
+		handler: () => {
+			requestStarterKitCopilot();
+			onRequest?.();
+		}
+	});
+}
+/** Ask for the copilot to open as soon as it has loaded. */
+function requestStarterKitCopilot() {
+	copilotRequested = true;
+}
+/** Whether the copilot was asked for before it loaded (and forget the request). */
+function takeRequestedStarterKitCopilot() {
+	const requested = copilotRequested;
+	copilotRequested = false;
+	return requested;
+}
+/**
+* The copilot component in the loaded panel data: the panel's own pages show it in the
+* `topbar.end` slot, which starter kit hosts don't render. Null without the AI plugin's
+* copilot (or when the user may not use it).
+*/
+function starterKitCopilot(panel) {
+	for (const item of panel.slots?.["topbar.end"] ?? []) if (item.type === "component" && item.component.type === "ai:copilot") return item.component;
+	return null;
+}
+/**
+* The dashboard widgets of a `starterKit()` panel on the host's dashboard
+* (`<AlfakitWidgets />`, the `alfakitWidgets` prop): a standalone widgets payload bound to
+* the panel, the first panel's unless `panelId` is given. Null on other pages, for guests,
+* users who may not open the panel and panels without widgets.
+*/
+function starterKitDashboardWidgets(props, panelId) {
+	const value = props?.alfakitWidgets;
+	if (!Array.isArray(value)) return null;
+	return value.find((item) => panelId === void 0 || item.id === panelId)?.component ?? null;
+}
+/** How many widgets a dashboard widgets payload has (placeholders before its code loads). */
+function standaloneWidgetCount(component) {
+	return component.content.reduce((total, block) => total + (block.type === "Widgets" ? block.widgets.length : 0), 0);
+}
 //#endregion
-export { isAlfakitPage, loadStarterKitPanel, loadedStarterKitPanel, openRequestedStarterKitSearch, registerStarterKitSearchShortcut, requestStarterKitSearch, resetStarterKitPanels, starterKitWidgets, starterKitWidgetsPage, starterKitWidgetsPanel };
+export { STARTER_KIT_COPILOT_SHORTCUT, isAlfakitPage, loadStarterKitPanel, loadedStarterKitPanel, openRequestedStarterKitSearch, registerStarterKitCopilotShortcut, registerStarterKitSearchShortcut, requestStarterKitCopilot, requestStarterKitSearch, resetStarterKitPanels, standaloneWidgetCount, starterKitCopilot, starterKitDashboardWidgets, starterKitWidgets, starterKitWidgetsPage, starterKitWidgetsPanel, takeRequestedStarterKitCopilot };
 
 //# sourceMappingURL=starter-kit-widgets.js.map

package/dist/starter-kit-widgets.js.map

@@ -1 +1 @@
-{"version":3,"file":"starter-kit-widgets.js","names":[],"sources":["../src/starter-kit-widgets.ts"],"sourcesContent":["import { requestJson } from './http'\nimport type {\n  PageSchema,\n  PanelSchema,\n  StarterKitNavigationSchema,\n  StarterKitWidgetsSchema,\n} from './schema/panel'\nimport { SHORTCUT_IDS, shortcuts } from './shortcuts'\nimport { starterKitNavigations } from './starter-kit'\n\n/**\n * The drop-in header components of starter kit mode: `<AlfakitSearch />` (the command\n * palette and global search), `<AlfakitNotifications />` (the database notifications bell)\n * and `<AlfakitTenantSwitcher />`. They render on every page of the host application, from\n * the `widgets` of the shared `alfakitNavigation` prop; their code and the panel data\n * (translations, endpoints, the palette, realtime) load the first time one of them renders.\n * Shared by the three renderers.\n */\n\n/** One starter kit panel's navigation with its header components' data. */\nexport interface StarterKitWidgets {\n  navigation: StarterKitNavigationSchema\n  widgets: StarterKitWidgetsSchema\n}\n\n/**\n * The header components' data of a `starterKit()` panel (the first one with any unless\n * `panelId` is given), or null for guests and pages of other panels.\n */\nexport function starterKitWidgets(props: unknown, panelId?: string): StarterKitWidgets | null {\n  const navigation = starterKitNavigations(props).find(\n    (entry) => entry.widgets !== undefined && (panelId === undefined || entry.id === panelId),\n  )\n\n  return navigation?.widgets ? { navigation, widgets: navigation.widgets } : null\n}\n\n/** Whether the open page is one of the panel's own (it carries the `alfakit` prop). */\nexport function isAlfakitPage(props: unknown): boolean {\n  return (props as { alfakit?: unknown } | null | undefined)?.alfakit !== undefined\n}\n\n// ---------------------------------------------------------------- Panel data\n\n// Loaded once per endpoint (the tenant-scoped one inside a tenant) for the browser session;\n// Inertia visits keep it, a full page load starts over.\nconst requests = new Map<string, Promise<PanelSchema>>()\nconst panels = new Map<string, PanelSchema>()\n\n/** Load (once) the panel data the header components render with. */\nexport function loadStarterKitPanel(endpoint: string): Promise<PanelSchema> {\n  let request = requests.get(endpoint)\n\n  if (!request) {\n    request = requestJson<PanelSchema>(endpoint).then(\n      (panel) => {\n        panels.set(endpoint, panel)\n\n        return panel\n      },\n      (error: unknown) => {\n        // A failed request (offline, expired session) is retried by the next render.\n        requests.delete(endpoint)\n        throw error\n      },\n    )\n    requests.set(endpoint, request)\n  }\n\n  return request\n}\n\n/** The panel data once loaded, or null (so remounts render straight away). */\nexport function loadedStarterKitPanel(endpoint: string): PanelSchema | null {\n  return panels.get(endpoint) ?? null\n}\n\n/** @internal Forget the loaded panel data (tests). */\nexport function resetStarterKitPanels(): void {\n  requests.clear()\n  panels.clear()\n}\n\n/**\n * The panel the header components render with: the loaded panel data with the fresh\n * shared prop (navigation, unread count, tenants). Outside Alfakit's own chrome the host\n * owns the colour scheme and there is no shortcuts overlay, and panel commands and page\n * actions need an Alfakit page (its token and modals), so the palette lists search\n * results, navigation, \"create\" links and recent records.\n */\nexport function starterKitWidgetsPanel(base: PanelSchema, source: StarterKitWidgets): PanelSchema {\n  const { navigation, widgets } = source\n  const { databaseNotifications, tenancy, globalSearch, commandPalette } = base\n\n  return {\n    ...base,\n    navigation: navigation.groups,\n    darkMode: { enabled: false, forced: false, switcher: false },\n    keyboardShortcuts: false,\n    globalSearch: globalSearch && { ...globalSearch, position: undefined },\n    commandPalette: commandPalette && { ...commandPalette, commands: [] },\n    databaseNotifications: databaseNotifications && {\n      ...databaseNotifications,\n      unreadCount: widgets.notifications?.unreadCount ?? databaseNotifications.unreadCount,\n      position: undefined,\n    },\n    tenancy: tenancy && {\n      ...tenancy,\n      current: widgets.tenancy ? (widgets.tenancy.current ?? null) : tenancy.current,\n      tenants: widgets.tenancy?.tenants ?? tenancy.tenants,\n    },\n  }\n}\n\n/** The `page` the header components render with: none of the panel's (`usePageSchema()`). */\nexport function starterKitWidgetsPage(): PageSchema {\n  return { class: '', layout: 'app', title: '', content: [], token: '' }\n}\n\n// ---------------------------------------------------------------- Search shortcut\n\nlet searchRequested = false\n\n/**\n * Register the palette's key bindings before its code has loaded: pressing them (or\n * clicking the field) records the request, and the palette opens once it has loaded. It\n * uses the palette's shortcut id, so the loaded palette replaces this registration and\n * the keys are bound once, however many search components the page renders.\n */\nexport function registerStarterKitSearchShortcut(\n  keys: string[],\n  label: string,\n  onRequest: () => void,\n): () => void {\n  return shortcuts.register({\n    id: SHORTCUT_IDS.palette,\n    keys,\n    label,\n    group: 'general',\n    essential: true,\n    handler: () => {\n      requestStarterKitSearch()\n      onRequest()\n    },\n  })\n}\n\n/** Ask for the palette to open as soon as it has loaded. */\nexport function requestStarterKitSearch(): void {\n  searchRequested = true\n}\n\n/**\n * Open the loaded palette when it was asked for before it loaded (call once it mounted):\n * true when it did.\n */\nexport function openRequestedStarterKitSearch(): boolean {\n  if (!searchRequested) return false\n\n  searchRequested = false\n\n  return shortcuts.trigger(SHORTCUT_IDS.palette)\n}\n"],"mappings":";;;;;;;;AA6BA,SAAgB,kBAAkB,OAAgB,SAA4C;CAC5F,MAAM,aAAa,sBAAsB,KAAK,CAAC,CAAC,MAC7C,UAAU,MAAM,YAAY,KAAA,MAAc,YAAY,KAAA,KAAa,MAAM,OAAO,QACnF;CAEA,OAAO,YAAY,UAAU;EAAE;EAAY,SAAS,WAAW;CAAQ,IAAI;AAC7E;;AAGA,SAAgB,cAAc,OAAyB;CACrD,OAAQ,OAAoD,YAAY,KAAA;AAC1E;AAMA,MAAM,2BAAW,IAAI,IAAkC;AACvD,MAAM,yBAAS,IAAI,IAAyB;;AAG5C,SAAgB,oBAAoB,UAAwC;CAC1E,IAAI,UAAU,SAAS,IAAI,QAAQ;CAEnC,IAAI,CAAC,SAAS;EACZ,UAAU,YAAyB,QAAQ,CAAC,CAAC,MAC1C,UAAU;GACT,OAAO,IAAI,UAAU,KAAK;GAE1B,OAAO;EACT,IACC,UAAmB;GAElB,SAAS,OAAO,QAAQ;GACxB,MAAM;EACR,CACF;EACA,SAAS,IAAI,UAAU,OAAO;CAChC;CAEA,OAAO;AACT;;AAGA,SAAgB,sBAAsB,UAAsC;CAC1E,OAAO,OAAO,IAAI,QAAQ,KAAK;AACjC;;AAGA,SAAgB,wBAA8B;CAC5C,SAAS,MAAM;CACf,OAAO,MAAM;AACf;;;;;;;;AASA,SAAgB,uBAAuB,MAAmB,QAAwC;CAChG,MAAM,EAAE,YAAY,YAAY;CAChC,MAAM,EAAE,uBAAuB,SAAS,cAAc,mBAAmB;CAEzE,OAAO;EACL,GAAG;EACH,YAAY,WAAW;EACvB,UAAU;GAAE,SAAS;GAAO,QAAQ;GAAO,UAAU;EAAM;EAC3D,mBAAmB;EACnB,cAAc,gBAAgB;GAAE,GAAG;GAAc,UAAU,KAAA;EAAU;EACrE,gBAAgB,kBAAkB;GAAE,GAAG;GAAgB,UAAU,CAAC;EAAE;EACpE,uBAAuB,yBAAyB;GAC9C,GAAG;GACH,aAAa,QAAQ,eAAe,eAAe,sBAAsB;GACzE,UAAU,KAAA;EACZ;EACA,SAAS,WAAW;GAClB,GAAG;GACH,SAAS,QAAQ,UAAW,QAAQ,QAAQ,WAAW,OAAQ,QAAQ;GACvE,SAAS,QAAQ,SAAS,WAAW,QAAQ;EAC/C;CACF;AACF;;AAGA,SAAgB,wBAAoC;CAClD,OAAO;EAAE,OAAO;EAAI,QAAQ;EAAO,OAAO;EAAI,SAAS,CAAC;EAAG,OAAO;CAAG;AACvE;AAIA,IAAI,kBAAkB;;;;;;;AAQtB,SAAgB,iCACd,MACA,OACA,WACY;CACZ,OAAO,UAAU,SAAS;EACxB,IAAI,aAAa;EACjB;EACA;EACA,OAAO;EACP,WAAW;EACX,eAAe;GACb,wBAAwB;GACxB,UAAU;EACZ;CACF,CAAC;AACH;;AAGA,SAAgB,0BAAgC;CAC9C,kBAAkB;AACpB;;;;;AAMA,SAAgB,gCAAyC;CACvD,IAAI,CAAC,iBAAiB,OAAO;CAE7B,kBAAkB;CAElB,OAAO,UAAU,QAAQ,aAAa,OAAO;AAC/C"}
+{"version":3,"file":"starter-kit-widgets.js","names":[],"sources":["../src/starter-kit-widgets.ts"],"sourcesContent":["import { requestJson } from './http'\nimport type { AiCopilotSchema } from './schema/ai'\nimport type {\n  PageSchema,\n  PanelSchema,\n  StarterKitDashboardWidgetsSchema,\n  StarterKitNavigationSchema,\n  StarterKitWidgetsSchema,\n} from './schema/panel'\nimport type { StandaloneComponentSchema } from './schema/standalone'\nimport type { WidgetsBlock } from './schema/widgets'\nimport { SHORTCUT_IDS, shortcuts } from './shortcuts'\nimport { preferCurrentStarterKitPanel, starterKitNavigations } from './starter-kit'\n\n/**\n * The drop-in header components of starter kit mode: `<AlfakitSearch />` (the command\n * palette and global search), `<AlfakitNotifications />` (the database notifications bell),\n * `<AlfakitTenantSwitcher />` and `<AlfakitCopilot />` (the AI plugin's copilot). They render\n * on every page of the host application, from the `widgets` of the shared\n * `alfakitNavigation` prop; their code and the panel data (translations, endpoints, the\n * palette, realtime) load the first time one of them renders.\n * Shared by the three renderers.\n */\n\n/** One starter kit panel's navigation with its header components' data. */\nexport interface StarterKitWidgets {\n  navigation: StarterKitNavigationSchema\n  widgets: StarterKitWidgetsSchema\n}\n\n/**\n * The header components' data of a `starterKit()` panel, or null for guests and pages of\n * other panels. Without `panelId`: the open AlfaKit page's panel, else the first one with\n * any; with `part` (`'tenancy'` for the tenant switcher), the first panel that has that\n * part when the preferred one hasn't, so a team workspace on a second panel still gets its\n * switcher on the host's own pages.\n */\nexport function starterKitWidgets(\n  props: unknown,\n  panelId?: string,\n  part?: keyof StarterKitWidgetsSchema,\n): StarterKitWidgets | null {\n  const entries = preferCurrentStarterKitPanel(starterKitNavigations(props), props).filter(\n    (entry) => entry.widgets !== undefined && (panelId === undefined || entry.id === panelId),\n  )\n  const navigation =\n    (part !== undefined && panelId === undefined\n      ? entries.find((entry) => entry.widgets?.[part] !== undefined)\n      : undefined) ?? entries[0]\n\n  return navigation?.widgets ? { navigation, widgets: navigation.widgets } : null\n}\n\n/** Whether the open page is one of the panel's own (it carries the `alfakit` prop). */\nexport function isAlfakitPage(props: unknown): boolean {\n  return (props as { alfakit?: unknown } | null | undefined)?.alfakit !== undefined\n}\n\n// ---------------------------------------------------------------- Panel data\n\n// Loaded once per endpoint (the tenant-scoped one inside a tenant) for the browser session;\n// Inertia visits keep it, a full page load starts over.\nconst requests = new Map<string, Promise<PanelSchema>>()\nconst panels = new Map<string, PanelSchema>()\n\n/** Load (once) the panel data the header components render with. */\nexport function loadStarterKitPanel(endpoint: string): Promise<PanelSchema> {\n  let request = requests.get(endpoint)\n\n  if (!request) {\n    request = requestJson<unknown>(endpoint)\n      .then((panel) => {\n        // A redirect to the sign-in page (expired or ended session) answers HTML, not the\n        // panel: refuse it, so the components keep their trigger instead of crashing.\n        if (!isPanelData(panel)) {\n          throw new Error(`The starter kit endpoint ${endpoint} did not answer the panel data.`)\n        }\n\n        panels.set(endpoint, panel)\n\n        return panel\n      })\n      .catch((error: unknown) => {\n        // A failed request (offline, expired session) is retried by the next render.\n        requests.delete(endpoint)\n        throw error\n      })\n    requests.set(endpoint, request)\n  }\n\n  return request\n}\n\nfunction isPanelData(value: unknown): value is PanelSchema {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as { endpoints?: unknown }).endpoints === 'object' &&\n    (value as { endpoints?: unknown }).endpoints !== null\n  )\n}\n\n/** The panel data once loaded, or null (so remounts render straight away). */\nexport function loadedStarterKitPanel(endpoint: string): PanelSchema | null {\n  return panels.get(endpoint) ?? null\n}\n\n/** @internal Forget the loaded panel data (tests). */\nexport function resetStarterKitPanels(): void {\n  requests.clear()\n  panels.clear()\n}\n\n/**\n * The panel the header components render with: the loaded panel data with the fresh\n * shared prop (navigation, unread count, tenants). Outside Alfakit's own chrome the host\n * owns the colour scheme and there is no shortcuts overlay, and panel commands and page\n * actions need an Alfakit page (its token and modals), so the palette lists search\n * results, navigation, \"create\" links and recent records.\n */\nexport function starterKitWidgetsPanel(base: PanelSchema, source: StarterKitWidgets): PanelSchema {\n  const { navigation, widgets } = source\n  const { databaseNotifications, tenancy, globalSearch, commandPalette } = base\n\n  return {\n    ...base,\n    navigation: navigation.groups,\n    darkMode: { enabled: false, forced: false, switcher: false },\n    keyboardShortcuts: false,\n    globalSearch: globalSearch && { ...globalSearch, position: undefined },\n    commandPalette: commandPalette && { ...commandPalette, commands: [] },\n    databaseNotifications: databaseNotifications && {\n      ...databaseNotifications,\n      unreadCount: widgets.notifications?.unreadCount ?? databaseNotifications.unreadCount,\n      position: undefined,\n    },\n    tenancy: tenancy && {\n      ...tenancy,\n      current: widgets.tenancy ? (widgets.tenancy.current ?? null) : tenancy.current,\n      tenants: widgets.tenancy?.tenants ?? tenancy.tenants,\n    },\n  }\n}\n\n/** The `page` the header components render with: none of the panel's (`usePageSchema()`). */\nexport function starterKitWidgetsPage(): PageSchema {\n  return { class: '', layout: 'app', title: '', content: [], token: '' }\n}\n\n// ---------------------------------------------------------------- Search shortcut\n\nlet searchRequested = false\n\n/**\n * Register the palette's key bindings before its code has loaded: pressing them (or\n * clicking the field) records the request, and the palette opens once it has loaded. It\n * uses the palette's shortcut id, so the loaded palette replaces this registration and\n * the keys are bound once, however many search components the page renders.\n */\nexport function registerStarterKitSearchShortcut(\n  keys: string[],\n  label: string,\n  onRequest: () => void,\n): () => void {\n  return shortcuts.register({\n    id: SHORTCUT_IDS.palette,\n    keys,\n    label,\n    group: 'general',\n    essential: true,\n    handler: () => {\n      requestStarterKitSearch()\n      onRequest()\n    },\n  })\n}\n\n/** Ask for the palette to open as soon as it has loaded. */\nexport function requestStarterKitSearch(): void {\n  searchRequested = true\n}\n\n/**\n * Open the loaded palette when it was asked for before it loaded (call once it mounted):\n * true when it did.\n */\nexport function openRequestedStarterKitSearch(): boolean {\n  if (!searchRequested) return false\n\n  searchRequested = false\n\n  return shortcuts.trigger(SHORTCUT_IDS.palette)\n}\n\n// ---------------------------------------------------------------- Copilot\n\n/** The copilot's shortcut id (the loaded `ai:copilot` component registers the same one). */\nexport const STARTER_KIT_COPILOT_SHORTCUT = 'ai.copilot'\n\nlet copilotRequested = false\n\n/**\n * Register the copilot's key bindings (`mod+j`) before its code has loaded: pressing them\n * (or clicking the button) records the request, and the copilot opens once it has loaded.\n * The loaded copilot registers the same id, so it replaces this registration.\n */\nexport function registerStarterKitCopilotShortcut(\n  keys: string[],\n  label: string,\n  onRequest?: () => void,\n): () => void {\n  if (keys.length === 0) return () => {}\n\n  return shortcuts.register({\n    id: STARTER_KIT_COPILOT_SHORTCUT,\n    keys,\n    label,\n    group: 'general',\n    allowInInputs: true,\n    handler: () => {\n      requestStarterKitCopilot()\n      onRequest?.()\n    },\n  })\n}\n\n/** Ask for the copilot to open as soon as it has loaded. */\nexport function requestStarterKitCopilot(): void {\n  copilotRequested = true\n}\n\n/** Whether the copilot was asked for before it loaded (and forget the request). */\nexport function takeRequestedStarterKitCopilot(): boolean {\n  const requested = copilotRequested\n\n  copilotRequested = false\n\n  return requested\n}\n\n/**\n * The copilot component in the loaded panel data: the panel's own pages show it in the\n * `topbar.end` slot, which starter kit hosts don't render. Null without the AI plugin's\n * copilot (or when the user may not use it).\n */\nexport function starterKitCopilot(panel: PanelSchema): AiCopilotSchema | null {\n  for (const item of panel.slots?.['topbar.end'] ?? []) {\n    if (item.type === 'component' && item.component.type === 'ai:copilot') {\n      return item.component as unknown as AiCopilotSchema\n    }\n  }\n\n  return null\n}\n\n// ---------------------------------------------------------------- Dashboard widgets\n\n/**\n * The dashboard widgets of a `starterKit()` panel on the host's dashboard\n * (`<AlfakitWidgets />`, the `alfakitWidgets` prop): a standalone widgets payload bound to\n * the panel, the first panel's unless `panelId` is given. Null on other pages, for guests,\n * users who may not open the panel and panels without widgets.\n */\nexport function starterKitDashboardWidgets(\n  props: unknown,\n  panelId?: string,\n): StandaloneComponentSchema | null {\n  const value = (props as { alfakitWidgets?: unknown } | null | undefined)?.alfakitWidgets\n\n  if (!Array.isArray(value)) return null\n\n  const entry = (value as StarterKitDashboardWidgetsSchema[]).find(\n    (item) => panelId === undefined || item.id === panelId,\n  )\n\n  return entry?.component ?? null\n}\n\n/** How many widgets a dashboard widgets payload has (placeholders before its code loads). */\nexport function standaloneWidgetCount(component: StandaloneComponentSchema): number {\n  return component.content.reduce(\n    (total, block) =>\n      total + (block.type === 'Widgets' ? (block as WidgetsBlock).widgets.length : 0),\n    0,\n  )\n}\n"],"mappings":"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"}

package/dist/starter-kit.d.ts

@@ -28,13 +28,36 @@ export interface StarterKitBreadcrumb {
  */
 export declare function toStarterKitBreadcrumbs(breadcrumbs: BreadcrumbSchema[] | null | undefined): StarterKitBreadcrumb[];
 /** The breadcrumbs of an Alfakit page from its Inertia props (`props.page.breadcrumbs`). */
+/**
+ * Whether an Alfakit page renders inside the host layout (`createStarterKitPage({ layout })`).
+ * Pages with the `auth` layout (sign-in, registration, password reset, multi-factor
+ * challenge, email verification, `->login()` brought back after `starterKit()`) stand on
+ * their own, like the host's auth pages: the host layout expects a signed-in user.
+ */
+export declare function usesStarterKitHostLayout(props: unknown): boolean;
 export declare function starterKitBreadcrumbsFromProps(props: unknown): StarterKitBreadcrumb[];
 /**
  * The shared `alfakitNavigation` prop of a page: one entry per `starterKit()` panel, or none
  * for guests and pages of other panels.
  */
 export declare function starterKitNavigations(props: unknown): StarterKitNavigationSchema[];
-/** One panel's navigation (the first starter kit panel when no id is given), or null. */
+/**
+ * The panel of the open AlfaKit page (`props.alfakit.id`), or undefined on the host's own
+ * pages. With several `starterKit()` panels, components without a `panel` follow it.
+ */
+export declare function currentStarterKitPanelId(props: unknown): string | undefined;
+/**
+ * Order panel entries for components without a `panel` id: the open AlfaKit page's panel
+ * first (an `/app` page of a second `starterKit()` panel shows that panel's navigation and
+ * tenant menu), then the others in registration order.
+ */
+export declare function preferCurrentStarterKitPanel<T extends {
+  id: string;
+}>(entries: T[], props: unknown): T[];
+/**
+ * One panel's navigation, or null. Without an id: the open AlfaKit page's panel, else the
+ * first starter kit panel.
+ */
 export declare function starterKitNavigation(props: unknown, panelId?: string): StarterKitNavigationSchema | null;
 /**
  * A navigation item flattened for a starter kit sidebar: the label as text and the item's

package/dist/starter-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starter-kit.d.ts","names":[],"sources":["../src/starter-kit.ts"],"mappings":";;;;;;;;;;;;;;qBAiCa;;wBAGG,kBACd,OAAO,KAAK;;iBAMG;EACf;EACA;;;;;;;;wBASc,wBACd,aAAa,wCACZ;;wBAgBa,+BAA+B,iBAAiB;;;;;wBAUhD,sBAAsB,iBAAiB;;wBAOvC,qBACd,gBACA,mBACC;;;;;iBAcc;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;;iBAGK;EACf;EACA;EACA;EACA,OAAO;;;wBAmBO,sBACd,QAAQ,6CACP;;;;;wBA8Ba,mBAAmB,OAAO,QAAQ;;wBAalC,0BAA0B;;;;;;;wBAU1B,yBACd,OAAO,cAAc,6BACrB,IAAI,aAAa,eAAe,iCAAiC"}
+{"version":3,"file":"starter-kit.d.ts","names":[],"sources":["../src/starter-kit.ts"],"mappings":";;;;;;;;;;;;;;qBAiCa;;wBAGG,kBACd,OAAO,KAAK;;iBAMG;EACf;EACA;;;;;;;;wBASc,wBACd,aAAa,wCACZ;;;;;;;;wBAsBa,yBAAyB;wBAMzB,+BAA+B,iBAAiB;;;;;wBAUhD,sBAAsB,iBAAiB;;;;;wBAUvC,yBAAyB;;;;;;wBAWzB,6BAA6B;EAAY;GACvD,SAAS,KACT,iBACC;;;;;wBAWa,qBACd,gBACA,mBACC;;;;;iBAcc;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;;iBAGK;EACf;EACA;EACA;EACA,OAAO;;;wBAmBO,sBACd,QAAQ,6CACP;;;;;wBA8Ba,mBAAmB,OAAO,QAAQ;;wBAalC,0BAA0B;;;;;;;wBAU1B,yBACd,OAAO,cAAc,6BACrB,IAAI,aAAa,eAAe,iCAAiC"}

package/dist/starter-kit.js

@@ -40,6 +40,15 @@ function toStarterKitBreadcrumbs(breadcrumbs) {
 	});
 }
 /** The breadcrumbs of an Alfakit page from its Inertia props (`props.page.breadcrumbs`). */
+/**
+* Whether an Alfakit page renders inside the host layout (`createStarterKitPage({ layout })`).
+* Pages with the `auth` layout (sign-in, registration, password reset, multi-factor
+* challenge, email verification, `->login()` brought back after `starterKit()`) stand on
+* their own, like the host's auth pages: the host layout expects a signed-in user.
+*/
+function usesStarterKitHostLayout(props) {
+	return (props?.page)?.layout !== "auth";
+}
 function starterKitBreadcrumbsFromProps(props) {
 	const page = props?.page;
 	return toStarterKitBreadcrumbs(page?.breadcrumbs);
@@ -52,10 +61,31 @@ function starterKitNavigations(props) {
 	const value = props?.alfakitNavigation;
 	return Array.isArray(value) ? value : [];
 }
-/** One panel's navigation (the first starter kit panel when no id is given), or null. */
+/**
+* The panel of the open AlfaKit page (`props.alfakit.id`), or undefined on the host's own
+* pages. With several `starterKit()` panels, components without a `panel` follow it.
+*/
+function currentStarterKitPanelId(props) {
+	const id = props?.alfakit?.id;
+	return typeof id === "string" ? id : void 0;
+}
+/**
+* Order panel entries for components without a `panel` id: the open AlfaKit page's panel
+* first (an `/app` page of a second `starterKit()` panel shows that panel's navigation and
+* tenant menu), then the others in registration order.
+*/
+function preferCurrentStarterKitPanel(entries, props) {
+	const current = currentStarterKitPanelId(props);
+	const index = current === void 0 ? -1 : entries.findIndex((entry) => entry.id === current);
+	return index <= 0 ? entries : [entries[index], ...entries.filter((_, i) => i !== index)];
+}
+/**
+* One panel's navigation, or null. Without an id: the open AlfaKit page's panel, else the
+* first starter kit panel.
+*/
 function starterKitNavigation(props, panelId) {
 	const navigations = starterKitNavigations(props);
-	return (panelId === void 0 ? navigations[0] : navigations.find((navigation) => navigation.id === panelId)) ?? null;
+	return (panelId === void 0 ? preferCurrentStarterKitPanel(navigations, props)[0] : navigations.find((navigation) => navigation.id === panelId)) ?? null;
 }
 function toNavItem(item, key) {
 	return {
@@ -126,6 +156,6 @@ function installStarterKitRuntime(show, t) {
 	return true;
 }
 //#endregion
-export { STARTER_KIT_TOASTER_ID, currentStarterKitPanel, installStarterKitRuntime, isStarterKitPanel, starterKitBreadcrumbsFromProps, starterKitNavigation, starterKitNavigations, syncStarterKitPage, toStarterKitBreadcrumbs, toStarterKitNavGroups };
+export { STARTER_KIT_TOASTER_ID, currentStarterKitPanel, currentStarterKitPanelId, installStarterKitRuntime, isStarterKitPanel, preferCurrentStarterKitPanel, starterKitBreadcrumbsFromProps, starterKitNavigation, starterKitNavigations, syncStarterKitPage, toStarterKitBreadcrumbs, toStarterKitNavGroups, usesStarterKitHostLayout };
 
 //# sourceMappingURL=starter-kit.js.map

package/dist/starter-kit.js.map

@@ -1 +1 @@
-{"version":3,"file":"starter-kit.js","names":[],"sources":["../src/starter-kit.ts"],"sourcesContent":["import { debugRecorder } from './debug'\nimport {\n  effectiveErrorNotifications,\n  installErrorNotifications,\n  resolveRequestErrorNotification,\n  setRequestErrorReporter,\n} from './error-notifications'\nimport { reloadOnExpiredPage } from './http'\nimport { navigationItemText } from './navigation'\nimport type { NotificationSchema } from './schema/notifications'\nimport type {\n  AlfakitPageProps,\n  BreadcrumbSchema,\n  ErrorNotificationsSchema,\n  NavigationGroupSchema,\n  NavigationItemSchema,\n  PanelSchema,\n  StarterKitNavigationSchema,\n} from './schema/panel'\nimport { installSpaUrlExceptions } from './spa'\n\n/**\n * Starter kit mode (`Panel::starterKit()`): Alfakit pages render inside an application made\n * from Laravel's React, Vue or Svelte starter kit, in the host's own layout. These helpers are\n * shared by the three renderers; the host's sidebar reads the navigation through each\n * renderer's `useAlfakitNavigation()`.\n */\n\n/**\n * The sonner toaster Alfakit renders in starter kit mode. The host layout mounts its own\n * id-less `<Toaster />`; giving Alfakit's an id keeps each toast in one toaster even when the\n * host and Alfakit resolve the same sonner instance.\n */\nexport const STARTER_KIT_TOASTER_ID = 'alfakit'\n\n/** Whether the panel runs inside a starter kit application (`Panel::starterKit()`). */\nexport function isStarterKitPanel(\n  panel: Pick<PanelSchema, 'starterKit'> | null | undefined,\n): boolean {\n  return panel?.starterKit === true\n}\n\n/** A breadcrumb as the starter kits' `AppLayout` takes it (`BreadcrumbItem`). */\nexport interface StarterKitBreadcrumb {\n  title: string\n  href: string\n}\n\n/**\n * The page's breadcrumbs in the starter kits' shape: `{ title, href }` instead of\n * `{ label, url }`. The kits render the last crumb (the current page) as plain text and key\n * the list by `href`, so every `href` is unique: the last crumb without a URL keeps an empty\n * one, other crumbs without one (or repeating one) get a `#index` fragment.\n */\nexport function toStarterKitBreadcrumbs(\n  breadcrumbs: BreadcrumbSchema[] | null | undefined,\n): StarterKitBreadcrumb[] {\n  const list = breadcrumbs ?? []\n  const seen = new Set<string>()\n\n  return list.map((crumb, index) => {\n    let href = crumb.url ?? (index === list.length - 1 ? '' : `#${index}`)\n\n    if (seen.has(href)) href = `${href}#${index}`\n\n    seen.add(href)\n\n    return { title: crumb.label, href }\n  })\n}\n\n/** The breadcrumbs of an Alfakit page from its Inertia props (`props.page.breadcrumbs`). */\nexport function starterKitBreadcrumbsFromProps(props: unknown): StarterKitBreadcrumb[] {\n  const page = (props as { page?: { breadcrumbs?: BreadcrumbSchema[] } } | null | undefined)?.page\n\n  return toStarterKitBreadcrumbs(page?.breadcrumbs)\n}\n\n/**\n * The shared `alfakitNavigation` prop of a page: one entry per `starterKit()` panel, or none\n * for guests and pages of other panels.\n */\nexport function starterKitNavigations(props: unknown): StarterKitNavigationSchema[] {\n  const value = (props as { alfakitNavigation?: unknown } | null | undefined)?.alfakitNavigation\n\n  return Array.isArray(value) ? (value as StarterKitNavigationSchema[]) : []\n}\n\n/** One panel's navigation (the first starter kit panel when no id is given), or null. */\nexport function starterKitNavigation(\n  props: unknown,\n  panelId?: string,\n): StarterKitNavigationSchema | null {\n  const navigations = starterKitNavigations(props)\n\n  return (\n    (panelId === undefined\n      ? navigations[0]\n      : navigations.find((navigation) => navigation.id === panelId)) ?? null\n  )\n}\n\n/**\n * A navigation item flattened for a starter kit sidebar: the label as text and the item's\n * nested children. `title`/`href` match the kits' `NavItem` so the host can reuse its types.\n */\nexport interface StarterKitNavItem {\n  key: string\n  title: string\n  href: string\n  icon?: string\n  isActive: boolean\n  openInNewTab: boolean\n  badge?: string | number\n  badgeColor?: string\n  badgeTooltip?: string\n  children: StarterKitNavItem[]\n}\n\nexport interface StarterKitNavGroup {\n  key: string\n  label: string | null\n  icon?: string\n  items: StarterKitNavItem[]\n}\n\nfunction toNavItem(item: NavigationItemSchema, key: string): StarterKitNavItem {\n  return {\n    key,\n    title: navigationItemText(item),\n    href: item.url ?? '',\n    icon: item.icon ?? undefined,\n    isActive: item.active === true,\n    openInNewTab: item.openInNewTab === true,\n    badge: item.badge ?? undefined,\n    badgeColor: item.badgeColor ?? undefined,\n    badgeTooltip: item.badgeTooltip ?? undefined,\n    children: (item.children ?? []).map((child, index) => toNavItem(child, `${key}.${index}`)),\n  }\n}\n\n/** A panel's navigation groups as plain items for the host's sidebar primitives. */\nexport function toStarterKitNavGroups(\n  groups: NavigationGroupSchema[] | null | undefined,\n): StarterKitNavGroup[] {\n  return (groups ?? []).map((group, index) => {\n    const key = `${index}:${group.label ?? ''}`\n\n    return {\n      key,\n      label: group.label ?? null,\n      icon: group.icon ?? undefined,\n      items: group.items.map((item, itemIndex) => toNavItem(item, `${key}.${itemIndex}`)),\n    }\n  })\n}\n\n// ---------------------------------------------------------------- Browser runtime\n\n/**\n * What the browser-wide listeners of starter kit mode read: the open Alfakit page's panel\n * and error notifications, or nothing while a page of the host application is open (its\n * errors keep Inertia's default handling).\n */\nconst runtime: {\n  panel: PanelSchema | null\n  errorNotifications: ErrorNotificationsSchema | false | undefined\n  installed: boolean\n} = { panel: null, errorNotifications: undefined, installed: false }\n\n/**\n * Record the Alfakit page being rendered (called by each renderer's starter kit root while\n * it renders); `null` once the root unmounts, when a host page opens.\n */\nexport function syncStarterKitPage(props: Partial<AlfakitPageProps> | null): void {\n  const panel = props?.alfakit ?? null\n\n  runtime.panel = panel\n  runtime.errorNotifications = panel ? effectiveErrorNotifications(panel, props?.page) : undefined\n\n  if (typeof window !== 'undefined') {\n    // Internal requests and form stores are recorded only while the page carries the debug prop.\n    debugRecorder.setEnabled(props?.alfakitDebug !== undefined)\n  }\n}\n\n/** The panel of the open Alfakit page in starter kit mode, or null on host pages. */\nexport function currentStarterKitPanel(): PanelSchema | null {\n  return runtime.panel\n}\n\n/**\n * The listeners `createAlfakit()` installs, once per page load, for starter kit mode: reload\n * on an expired CSRF token (419), the panel's error notifications instead of Inertia's error\n * modal, a notification for failed internal requests and the panel's SPA URL exceptions.\n * Returns false when they were already installed (or on the server).\n */\nexport function installStarterKitRuntime(\n  show: (notification: NotificationSchema) => void,\n  t: (key: string, replacements?: Record<string, string | number>, fallback?: string) => string,\n): boolean {\n  if (typeof window === 'undefined' || runtime.installed) return false\n\n  runtime.installed = true\n\n  reloadOnExpiredPage()\n  installSpaUrlExceptions(() => runtime.panel)\n  installErrorNotifications(() => ({ errorNotifications: runtime.errorNotifications }), show)\n  setRequestErrorReporter((error) => {\n    const notification = resolveRequestErrorNotification(error, runtime.errorNotifications, t)\n\n    if (notification) show(notification)\n  })\n\n  return true\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiCA,MAAa,yBAAyB;;AAGtC,SAAgB,kBACd,OACS;CACT,OAAO,OAAO,eAAe;AAC/B;;;;;;;AAcA,SAAgB,wBACd,aACwB;CACxB,MAAM,OAAO,eAAe,CAAC;CAC7B,MAAM,uBAAO,IAAI,IAAY;CAE7B,OAAO,KAAK,KAAK,OAAO,UAAU;EAChC,IAAI,OAAO,MAAM,QAAQ,UAAU,KAAK,SAAS,IAAI,KAAK,IAAI;EAE9D,IAAI,KAAK,IAAI,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG;EAEtC,KAAK,IAAI,IAAI;EAEb,OAAO;GAAE,OAAO,MAAM;GAAO;EAAK;CACpC,CAAC;AACH;;AAGA,SAAgB,+BAA+B,OAAwC;CACrF,MAAM,OAAQ,OAA8E;CAE5F,OAAO,wBAAwB,MAAM,WAAW;AAClD;;;;;AAMA,SAAgB,sBAAsB,OAA8C;CAClF,MAAM,QAAS,OAA8D;CAE7E,OAAO,MAAM,QAAQ,KAAK,IAAK,QAAyC,CAAC;AAC3E;;AAGA,SAAgB,qBACd,OACA,SACmC;CACnC,MAAM,cAAc,sBAAsB,KAAK;CAE/C,QACG,YAAY,KAAA,IACT,YAAY,KACZ,YAAY,MAAM,eAAe,WAAW,OAAO,OAAO,MAAM;AAExE;AA0BA,SAAS,UAAU,MAA4B,KAAgC;CAC7E,OAAO;EACL;EACA,OAAO,mBAAmB,IAAI;EAC9B,MAAM,KAAK,OAAO;EAClB,MAAM,KAAK,QAAQ,KAAA;EACnB,UAAU,KAAK,WAAW;EAC1B,cAAc,KAAK,iBAAiB;EACpC,OAAO,KAAK,SAAS,KAAA;EACrB,YAAY,KAAK,cAAc,KAAA;EAC/B,cAAc,KAAK,gBAAgB,KAAA;EACnC,WAAW,KAAK,YAAY,CAAC,EAAA,CAAG,KAAK,OAAO,UAAU,UAAU,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;CAC3F;AACF;;AAGA,SAAgB,sBACd,QACsB;CACtB,QAAQ,UAAU,CAAC,EAAA,CAAG,KAAK,OAAO,UAAU;EAC1C,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,SAAS;EAEvC,OAAO;GACL;GACA,OAAO,MAAM,SAAS;GACtB,MAAM,MAAM,QAAQ,KAAA;GACpB,OAAO,MAAM,MAAM,KAAK,MAAM,cAAc,UAAU,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC;EACpF;CACF,CAAC;AACH;;;;;;AASA,MAAM,UAIF;CAAE,OAAO;CAAM,oBAAoB,KAAA;CAAW,WAAW;AAAM;;;;;AAMnE,SAAgB,mBAAmB,OAA+C;CAChF,MAAM,QAAQ,OAAO,WAAW;CAEhC,QAAQ,QAAQ;CAChB,QAAQ,qBAAqB,QAAQ,4BAA4B,OAAO,OAAO,IAAI,IAAI,KAAA;CAEvF,IAAI,OAAO,WAAW,aAEpB,cAAc,WAAW,OAAO,iBAAiB,KAAA,CAAS;AAE9D;;AAGA,SAAgB,yBAA6C;CAC3D,OAAO,QAAQ;AACjB;;;;;;;AAQA,SAAgB,yBACd,MACA,GACS;CACT,IAAI,OAAO,WAAW,eAAe,QAAQ,WAAW,OAAO;CAE/D,QAAQ,YAAY;CAEpB,oBAAoB;CACpB,8BAA8B,QAAQ,KAAK;CAC3C,iCAAiC,EAAE,oBAAoB,QAAQ,mBAAmB,IAAI,IAAI;CAC1F,yBAAyB,UAAU;EACjC,MAAM,eAAe,gCAAgC,OAAO,QAAQ,oBAAoB,CAAC;EAEzF,IAAI,cAAc,KAAK,YAAY;CACrC,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"starter-kit.js","names":[],"sources":["../src/starter-kit.ts"],"sourcesContent":["import { debugRecorder } from './debug'\nimport {\n  effectiveErrorNotifications,\n  installErrorNotifications,\n  resolveRequestErrorNotification,\n  setRequestErrorReporter,\n} from './error-notifications'\nimport { reloadOnExpiredPage } from './http'\nimport { navigationItemText } from './navigation'\nimport type { NotificationSchema } from './schema/notifications'\nimport type {\n  AlfakitPageProps,\n  BreadcrumbSchema,\n  ErrorNotificationsSchema,\n  NavigationGroupSchema,\n  NavigationItemSchema,\n  PanelSchema,\n  StarterKitNavigationSchema,\n} from './schema/panel'\nimport { installSpaUrlExceptions } from './spa'\n\n/**\n * Starter kit mode (`Panel::starterKit()`): Alfakit pages render inside an application made\n * from Laravel's React, Vue or Svelte starter kit, in the host's own layout. These helpers are\n * shared by the three renderers; the host's sidebar reads the navigation through each\n * renderer's `useAlfakitNavigation()`.\n */\n\n/**\n * The sonner toaster Alfakit renders in starter kit mode. The host layout mounts its own\n * id-less `<Toaster />`; giving Alfakit's an id keeps each toast in one toaster even when the\n * host and Alfakit resolve the same sonner instance.\n */\nexport const STARTER_KIT_TOASTER_ID = 'alfakit'\n\n/** Whether the panel runs inside a starter kit application (`Panel::starterKit()`). */\nexport function isStarterKitPanel(\n  panel: Pick<PanelSchema, 'starterKit'> | null | undefined,\n): boolean {\n  return panel?.starterKit === true\n}\n\n/** A breadcrumb as the starter kits' `AppLayout` takes it (`BreadcrumbItem`). */\nexport interface StarterKitBreadcrumb {\n  title: string\n  href: string\n}\n\n/**\n * The page's breadcrumbs in the starter kits' shape: `{ title, href }` instead of\n * `{ label, url }`. The kits render the last crumb (the current page) as plain text and key\n * the list by `href`, so every `href` is unique: the last crumb without a URL keeps an empty\n * one, other crumbs without one (or repeating one) get a `#index` fragment.\n */\nexport function toStarterKitBreadcrumbs(\n  breadcrumbs: BreadcrumbSchema[] | null | undefined,\n): StarterKitBreadcrumb[] {\n  const list = breadcrumbs ?? []\n  const seen = new Set<string>()\n\n  return list.map((crumb, index) => {\n    let href = crumb.url ?? (index === list.length - 1 ? '' : `#${index}`)\n\n    if (seen.has(href)) href = `${href}#${index}`\n\n    seen.add(href)\n\n    return { title: crumb.label, href }\n  })\n}\n\n/** The breadcrumbs of an Alfakit page from its Inertia props (`props.page.breadcrumbs`). */\n/**\n * Whether an Alfakit page renders inside the host layout (`createStarterKitPage({ layout })`).\n * Pages with the `auth` layout (sign-in, registration, password reset, multi-factor\n * challenge, email verification, `->login()` brought back after `starterKit()`) stand on\n * their own, like the host's auth pages: the host layout expects a signed-in user.\n */\nexport function usesStarterKitHostLayout(props: unknown): boolean {\n  const page = (props as { page?: { layout?: string } } | null | undefined)?.page\n\n  return page?.layout !== 'auth'\n}\n\nexport function starterKitBreadcrumbsFromProps(props: unknown): StarterKitBreadcrumb[] {\n  const page = (props as { page?: { breadcrumbs?: BreadcrumbSchema[] } } | null | undefined)?.page\n\n  return toStarterKitBreadcrumbs(page?.breadcrumbs)\n}\n\n/**\n * The shared `alfakitNavigation` prop of a page: one entry per `starterKit()` panel, or none\n * for guests and pages of other panels.\n */\nexport function starterKitNavigations(props: unknown): StarterKitNavigationSchema[] {\n  const value = (props as { alfakitNavigation?: unknown } | null | undefined)?.alfakitNavigation\n\n  return Array.isArray(value) ? (value as StarterKitNavigationSchema[]) : []\n}\n\n/**\n * The panel of the open AlfaKit page (`props.alfakit.id`), or undefined on the host's own\n * pages. With several `starterKit()` panels, components without a `panel` follow it.\n */\nexport function currentStarterKitPanelId(props: unknown): string | undefined {\n  const id = (props as { alfakit?: { id?: unknown } } | null | undefined)?.alfakit?.id\n\n  return typeof id === 'string' ? id : undefined\n}\n\n/**\n * Order panel entries for components without a `panel` id: the open AlfaKit page's panel\n * first (an `/app` page of a second `starterKit()` panel shows that panel's navigation and\n * tenant menu), then the others in registration order.\n */\nexport function preferCurrentStarterKitPanel<T extends { id: string }>(\n  entries: T[],\n  props: unknown,\n): T[] {\n  const current = currentStarterKitPanelId(props)\n  const index = current === undefined ? -1 : entries.findIndex((entry) => entry.id === current)\n\n  return index <= 0 ? entries : [entries[index]!, ...entries.filter((_, i) => i !== index)]\n}\n\n/**\n * One panel's navigation, or null. Without an id: the open AlfaKit page's panel, else the\n * first starter kit panel.\n */\nexport function starterKitNavigation(\n  props: unknown,\n  panelId?: string,\n): StarterKitNavigationSchema | null {\n  const navigations = starterKitNavigations(props)\n\n  return (\n    (panelId === undefined\n      ? preferCurrentStarterKitPanel(navigations, props)[0]\n      : navigations.find((navigation) => navigation.id === panelId)) ?? null\n  )\n}\n\n/**\n * A navigation item flattened for a starter kit sidebar: the label as text and the item's\n * nested children. `title`/`href` match the kits' `NavItem` so the host can reuse its types.\n */\nexport interface StarterKitNavItem {\n  key: string\n  title: string\n  href: string\n  icon?: string\n  isActive: boolean\n  openInNewTab: boolean\n  badge?: string | number\n  badgeColor?: string\n  badgeTooltip?: string\n  children: StarterKitNavItem[]\n}\n\nexport interface StarterKitNavGroup {\n  key: string\n  label: string | null\n  icon?: string\n  items: StarterKitNavItem[]\n}\n\nfunction toNavItem(item: NavigationItemSchema, key: string): StarterKitNavItem {\n  return {\n    key,\n    title: navigationItemText(item),\n    href: item.url ?? '',\n    icon: item.icon ?? undefined,\n    isActive: item.active === true,\n    openInNewTab: item.openInNewTab === true,\n    badge: item.badge ?? undefined,\n    badgeColor: item.badgeColor ?? undefined,\n    badgeTooltip: item.badgeTooltip ?? undefined,\n    children: (item.children ?? []).map((child, index) => toNavItem(child, `${key}.${index}`)),\n  }\n}\n\n/** A panel's navigation groups as plain items for the host's sidebar primitives. */\nexport function toStarterKitNavGroups(\n  groups: NavigationGroupSchema[] | null | undefined,\n): StarterKitNavGroup[] {\n  return (groups ?? []).map((group, index) => {\n    const key = `${index}:${group.label ?? ''}`\n\n    return {\n      key,\n      label: group.label ?? null,\n      icon: group.icon ?? undefined,\n      items: group.items.map((item, itemIndex) => toNavItem(item, `${key}.${itemIndex}`)),\n    }\n  })\n}\n\n// ---------------------------------------------------------------- Browser runtime\n\n/**\n * What the browser-wide listeners of starter kit mode read: the open Alfakit page's panel\n * and error notifications, or nothing while a page of the host application is open (its\n * errors keep Inertia's default handling).\n */\nconst runtime: {\n  panel: PanelSchema | null\n  errorNotifications: ErrorNotificationsSchema | false | undefined\n  installed: boolean\n} = { panel: null, errorNotifications: undefined, installed: false }\n\n/**\n * Record the Alfakit page being rendered (called by each renderer's starter kit root while\n * it renders); `null` once the root unmounts, when a host page opens.\n */\nexport function syncStarterKitPage(props: Partial<AlfakitPageProps> | null): void {\n  const panel = props?.alfakit ?? null\n\n  runtime.panel = panel\n  runtime.errorNotifications = panel ? effectiveErrorNotifications(panel, props?.page) : undefined\n\n  if (typeof window !== 'undefined') {\n    // Internal requests and form stores are recorded only while the page carries the debug prop.\n    debugRecorder.setEnabled(props?.alfakitDebug !== undefined)\n  }\n}\n\n/** The panel of the open Alfakit page in starter kit mode, or null on host pages. */\nexport function currentStarterKitPanel(): PanelSchema | null {\n  return runtime.panel\n}\n\n/**\n * The listeners `createAlfakit()` installs, once per page load, for starter kit mode: reload\n * on an expired CSRF token (419), the panel's error notifications instead of Inertia's error\n * modal, a notification for failed internal requests and the panel's SPA URL exceptions.\n * Returns false when they were already installed (or on the server).\n */\nexport function installStarterKitRuntime(\n  show: (notification: NotificationSchema) => void,\n  t: (key: string, replacements?: Record<string, string | number>, fallback?: string) => string,\n): boolean {\n  if (typeof window === 'undefined' || runtime.installed) return false\n\n  runtime.installed = true\n\n  reloadOnExpiredPage()\n  installSpaUrlExceptions(() => runtime.panel)\n  installErrorNotifications(() => ({ errorNotifications: runtime.errorNotifications }), show)\n  setRequestErrorReporter((error) => {\n    const notification = resolveRequestErrorNotification(error, runtime.errorNotifications, t)\n\n    if (notification) show(notification)\n  })\n\n  return true\n}\n"],"mappings":"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"}

package/dist/utils/debounce.d.ts

@@ -3,6 +3,8 @@ export interface Debounced<TArgs extends unknown[]> {
   (...args: TArgs): void;
   cancel: () => void;
   flush: () => void;
+  /** A call is waiting for its timer. */
+  readonly pending: boolean;
 }
 export declare function debounce<TArgs extends unknown[]>(callback: (...args: TArgs) => void, wait: number): Debounced<TArgs>;
 //#endregion

package/dist/utils/debounce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.d.ts","names":[],"sources":["../../src/utils/debounce.ts"],"mappings":";iBAAiB,UAAU;MACrB,MAAM;EACV;EACA;;wBAGc,SAAS,yBACvB,cAAc,MAAM,gBACpB,eACC,UAAU"}
+{"version":3,"file":"debounce.d.ts","names":[],"sources":["../../src/utils/debounce.ts"],"mappings":";iBAAiB,UAAU;MACrB,MAAM;EACV;EACA;;WAES;;wBAGK,SAAS,yBACvB,cAAc,MAAM,gBACpB,eACC,UAAU"}

package/dist/utils/debounce.js

@@ -19,6 +19,7 @@ function debounce(callback, wait) {
 		}
 		pending = null;
 	};
+	Object.defineProperty(debounced, "pending", { get: () => timer !== null && pending !== null });
 	debounced.flush = () => {
 		if (timer !== null && pending) {
 			clearTimeout(timer);

package/dist/utils/debounce.js.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.js","names":[],"sources":["../../src/utils/debounce.ts"],"sourcesContent":["export interface Debounced<TArgs extends unknown[]> {\n  (...args: TArgs): void\n  cancel: () => void\n  flush: () => void\n}\n\nexport function debounce<TArgs extends unknown[]>(\n  callback: (...args: TArgs) => void,\n  wait: number,\n): Debounced<TArgs> {\n  let timer: ReturnType<typeof setTimeout> | null = null\n  let pending: TArgs | null = null\n\n  const debounced = ((...args: TArgs) => {\n    pending = args\n\n    if (timer !== null) {\n      clearTimeout(timer)\n    }\n\n    timer = setTimeout(() => {\n      timer = null\n      const current = pending\n      pending = null\n\n      if (current) {\n        callback(...current)\n      }\n    }, wait)\n  }) as Debounced<TArgs>\n\n  debounced.cancel = () => {\n    if (timer !== null) {\n      clearTimeout(timer)\n      timer = null\n    }\n\n    pending = null\n  }\n\n  debounced.flush = () => {\n    if (timer !== null && pending) {\n      clearTimeout(timer)\n      timer = null\n      const current = pending\n      pending = null\n      callback(...current)\n    }\n  }\n\n  return debounced\n}\n"],"mappings":";AAMA,SAAgB,SACd,UACA,MACkB;CAClB,IAAI,QAA8C;CAClD,IAAI,UAAwB;CAE5B,MAAM,cAAc,GAAG,SAAgB;EACrC,UAAU;EAEV,IAAI,UAAU,MACZ,aAAa,KAAK;EAGpB,QAAQ,iBAAiB;GACvB,QAAQ;GACR,MAAM,UAAU;GAChB,UAAU;GAEV,IAAI,SACF,SAAS,GAAG,OAAO;EAEvB,GAAG,IAAI;CACT;CAEA,UAAU,eAAe;EACvB,IAAI,UAAU,MAAM;GAClB,aAAa,KAAK;GAClB,QAAQ;EACV;EAEA,UAAU;CACZ;CAEA,UAAU,cAAc;EACtB,IAAI,UAAU,QAAQ,SAAS;GAC7B,aAAa,KAAK;GAClB,QAAQ;GACR,MAAM,UAAU;GAChB,UAAU;GACV,SAAS,GAAG,OAAO;EACrB;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"debounce.js","names":[],"sources":["../../src/utils/debounce.ts"],"sourcesContent":["export interface Debounced<TArgs extends unknown[]> {\n  (...args: TArgs): void\n  cancel: () => void\n  flush: () => void\n  /** A call is waiting for its timer. */\n  readonly pending: boolean\n}\n\nexport function debounce<TArgs extends unknown[]>(\n  callback: (...args: TArgs) => void,\n  wait: number,\n): Debounced<TArgs> {\n  let timer: ReturnType<typeof setTimeout> | null = null\n  let pending: TArgs | null = null\n\n  const debounced = ((...args: TArgs) => {\n    pending = args\n\n    if (timer !== null) {\n      clearTimeout(timer)\n    }\n\n    timer = setTimeout(() => {\n      timer = null\n      const current = pending\n      pending = null\n\n      if (current) {\n        callback(...current)\n      }\n    }, wait)\n  }) as Debounced<TArgs>\n\n  debounced.cancel = () => {\n    if (timer !== null) {\n      clearTimeout(timer)\n      timer = null\n    }\n\n    pending = null\n  }\n\n  Object.defineProperty(debounced, 'pending', { get: () => timer !== null && pending !== null })\n\n  debounced.flush = () => {\n    if (timer !== null && pending) {\n      clearTimeout(timer)\n      timer = null\n      const current = pending\n      pending = null\n      callback(...current)\n    }\n  }\n\n  return debounced\n}\n"],"mappings":";AAQA,SAAgB,SACd,UACA,MACkB;CAClB,IAAI,QAA8C;CAClD,IAAI,UAAwB;CAE5B,MAAM,cAAc,GAAG,SAAgB;EACrC,UAAU;EAEV,IAAI,UAAU,MACZ,aAAa,KAAK;EAGpB,QAAQ,iBAAiB;GACvB,QAAQ;GACR,MAAM,UAAU;GAChB,UAAU;GAEV,IAAI,SACF,SAAS,GAAG,OAAO;EAEvB,GAAG,IAAI;CACT;CAEA,UAAU,eAAe;EACvB,IAAI,UAAU,MAAM;GAClB,aAAa,KAAK;GAClB,QAAQ;EACV;EAEA,UAAU;CACZ;CAEA,OAAO,eAAe,WAAW,WAAW,EAAE,WAAW,UAAU,QAAQ,YAAY,KAAK,CAAC;CAE7F,UAAU,cAAc;EACtB,IAAI,UAAU,QAAQ,SAAS;GAC7B,aAAa,KAAK;GAClB,QAAQ;GACR,MAAM,UAAU;GAChB,UAAU;GACV,SAAS,GAAG,OAAO;EACrB;CACF;CAEA,OAAO;AACT"}

package/dist/utils/path.d.ts

@@ -17,8 +17,18 @@ export declare function parentPath(path: string): string;
 export declare function joinPath(...segments: PathSegment[]): string;
 /**
  * Replace the Repeater template placeholder with a concrete index, deeply, in any
- * string value of the object (state paths, keys, ids).
+ * string value of the object (state paths, keys, ids). Only the first placeholder of each
+ * string is this level's: a repeater inside a builder block template has item paths like
+ * `content.__INDEX__.data.items.__INDEX__.question`, whose second placeholder is filled
+ * in when an item is added to that repeater.
  */
 export declare function replacePlaceholder<T>(value: T, placeholder: string, replacement: string): T;
+/**
+ * A Repeater or Builder template with the item index filled in (`replacePlaceholder()`),
+ * the same object for the same template and index. Items the server hasn't seen yet render
+ * from their template on every render: new objects each time made every field below them
+ * render again (and restart work such as the image editor's loading).
+ */
+export declare function templateForIndex<T extends object>(template: T, index: number | string): T;
 //#endregion
 //# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/utils/path.ts"],"mappings":";;;;;YAKY;wBAEI,UAAU;wBAIV,QAAQ,aAAa,iBAAiB,cAAc,WAAW,IAAI;wBAkBnE,QAAQ,iBAAiB;;;;;wBAuBzB,QAAQ,kBAAkB,QAAQ,GAAG,cAAc,iBAAiB;wBAqCpE,WAAW,kBAAkB,QAAQ,GAAG,eAAe;wBA4BvD,WAAW;wBAOX,YAAY,UAAU;;;;;wBAWtB,mBAAmB,GAAG,OAAO,GAAG,qBAAqB,sBAAsB"}
+{"version":3,"file":"path.d.ts","names":[],"sources":["../../src/utils/path.ts"],"mappings":";;;;;YAKY;wBAEI,UAAU;wBAIV,QAAQ,aAAa,iBAAiB,cAAc,WAAW,IAAI;wBAkBnE,QAAQ,iBAAiB;;;;;wBAuBzB,QAAQ,kBAAkB,QAAQ,GAAG,cAAc,iBAAiB;wBAqCpE,WAAW,kBAAkB,QAAQ,GAAG,eAAe;wBA4BvD,WAAW;wBAOX,YAAY,UAAU;;;;;;;;wBActB,mBAAmB,GAAG,OAAO,GAAG,qBAAqB,sBAAsB;;;;;;;wBAoC3E,iBAAiB,kBAAkB,UAAU,GAAG,yBAAyB"}

package/dist/utils/path.js

@@ -67,10 +67,16 @@ function joinPath(...segments) {
 }
 /**
 * Replace the Repeater template placeholder with a concrete index, deeply, in any
-* string value of the object (state paths, keys, ids).
+* string value of the object (state paths, keys, ids). Only the first placeholder of each
+* string is this level's: a repeater inside a builder block template has item paths like
+* `content.__INDEX__.data.items.__INDEX__.question`, whose second placeholder is filled
+* in when an item is added to that repeater.
 */
 function replacePlaceholder(value, placeholder, replacement) {
-	if (typeof value === "string") return value.split(placeholder).join(replacement);
+	if (typeof value === "string") {
+		const at = value.indexOf(placeholder);
+		return at === -1 ? value : value.slice(0, at) + replacement + value.slice(at + placeholder.length);
+	}
 	if (Array.isArray(value)) return value.map((item) => replacePlaceholder(item, placeholder, replacement));
 	if (value !== null && typeof value === "object") {
 		const result = {};
@@ -79,7 +85,28 @@ function replacePlaceholder(value, placeholder, replacement) {
 	}
 	return value;
 }
+const templateInstances = /* @__PURE__ */ new WeakMap();
+/**
+* A Repeater or Builder template with the item index filled in (`replacePlaceholder()`),
+* the same object for the same template and index. Items the server hasn't seen yet render
+* from their template on every render: new objects each time made every field below them
+* render again (and restart work such as the image editor's loading).
+*/
+function templateForIndex(template, index) {
+	let instances = templateInstances.get(template);
+	if (!instances) {
+		instances = /* @__PURE__ */ new Map();
+		templateInstances.set(template, instances);
+	}
+	const key = String(index);
+	let instance = instances.get(key);
+	if (instance === void 0) {
+		instance = replacePlaceholder(template, "__INDEX__", key);
+		instances.set(key, instance);
+	}
+	return instance;
+}
 //#endregion
-export { deletePath, getPath, hasPath, joinPath, parentPath, replacePlaceholder, setPath, splitPath };
+export { deletePath, getPath, hasPath, joinPath, parentPath, replacePlaceholder, setPath, splitPath, templateForIndex };
 
 //# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","names":[],"sources":["../../src/utils/path.ts"],"sourcesContent":["/**\n * Dot-path helpers mirroring Laravel's `data_get` / `data_set` semantics, used for form\n * state addressed by `statePath` (e.g. `comments.0.body`).\n */\n\nexport type PathSegment = string | number\n\nexport function splitPath(path: string): string[] {\n  return path === '' ? [] : path.split('.')\n}\n\nexport function getPath<T = unknown>(source: unknown, path: string, fallback?: T): T {\n  if (path === '') {\n    return source as T\n  }\n\n  let current: unknown = source\n\n  for (const segment of splitPath(path)) {\n    if (current === null || current === undefined || typeof current !== 'object') {\n      return fallback as T\n    }\n\n    current = (current as Record<string, unknown>)[segment]\n  }\n\n  return (current === undefined ? fallback : current) as T\n}\n\nexport function hasPath(source: unknown, path: string): boolean {\n  let current: unknown = source\n\n  for (const segment of splitPath(path)) {\n    if (\n      current === null ||\n      current === undefined ||\n      typeof current !== 'object' ||\n      !(segment in (current as object))\n    ) {\n      return false\n    }\n\n    current = (current as Record<string, unknown>)[segment]\n  }\n\n  return true\n}\n\n/**\n * Immutably set a value, cloning each container along the path. Numeric segments on a\n * missing container create arrays.\n */\nexport function setPath<T extends object>(source: T, path: string, value: unknown): T {\n  const segments = splitPath(path)\n\n  if (segments.length === 0) {\n    return value as T\n  }\n\n  const root: unknown = Array.isArray(source) ? [...source] : { ...(source ?? {}) }\n  let current = root as Record<string, unknown>\n\n  segments.forEach((segment, index) => {\n    const isLast = index === segments.length - 1\n\n    if (isLast) {\n      current[segment] = value\n\n      return\n    }\n\n    const existing = current[segment]\n    const nextSegment = segments[index + 1] ?? ''\n    const container =\n      existing !== null && typeof existing === 'object'\n        ? Array.isArray(existing)\n          ? [...existing]\n          : { ...existing }\n        : /^\\d+$/.test(nextSegment)\n          ? []\n          : {}\n\n    current[segment] = container\n    current = container as Record<string, unknown>\n  })\n\n  return root as T\n}\n\nexport function deletePath<T extends object>(source: T, path: string): T {\n  const segments = splitPath(path)\n  const last = segments.pop()\n\n  if (last === undefined) {\n    return source\n  }\n\n  const parentPath = segments.join('.')\n  const parent = getPath<Record<string, unknown> | unknown[]>(source, parentPath)\n\n  if (parent === null || parent === undefined || typeof parent !== 'object') {\n    return source\n  }\n\n  if (Array.isArray(parent)) {\n    const copy = [...parent]\n    copy.splice(Number(last), 1)\n\n    return setPath(source, parentPath, copy)\n  }\n\n  const copy = { ...parent }\n  delete copy[last]\n\n  return setPath(source, parentPath, copy)\n}\n\nexport function parentPath(path: string): string {\n  const segments = splitPath(path)\n  segments.pop()\n\n  return segments.join('.')\n}\n\nexport function joinPath(...segments: PathSegment[]): string {\n  return segments\n    .map(String)\n    .filter((segment) => segment !== '')\n    .join('.')\n}\n\n/**\n * Replace the Repeater template placeholder with a concrete index, deeply, in any\n * string value of the object (state paths, keys, ids).\n */\nexport function replacePlaceholder<T>(value: T, placeholder: string, replacement: string): T {\n  if (typeof value === 'string') {\n    return value.split(placeholder).join(replacement) as T\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => replacePlaceholder(item, placeholder, replacement)) as T\n  }\n\n  if (value !== null && typeof value === 'object') {\n    const result: Record<string, unknown> = {}\n\n    for (const [key, nested] of Object.entries(value as Record<string, unknown>)) {\n      result[key] = replacePlaceholder(nested, placeholder, replacement)\n    }\n\n    return result as T\n  }\n\n  return value\n}\n"],"mappings":"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"}
+{"version":3,"file":"path.js","names":[],"sources":["../../src/utils/path.ts"],"sourcesContent":["/**\n * Dot-path helpers mirroring Laravel's `data_get` / `data_set` semantics, used for form\n * state addressed by `statePath` (e.g. `comments.0.body`).\n */\n\nexport type PathSegment = string | number\n\nexport function splitPath(path: string): string[] {\n  return path === '' ? [] : path.split('.')\n}\n\nexport function getPath<T = unknown>(source: unknown, path: string, fallback?: T): T {\n  if (path === '') {\n    return source as T\n  }\n\n  let current: unknown = source\n\n  for (const segment of splitPath(path)) {\n    if (current === null || current === undefined || typeof current !== 'object') {\n      return fallback as T\n    }\n\n    current = (current as Record<string, unknown>)[segment]\n  }\n\n  return (current === undefined ? fallback : current) as T\n}\n\nexport function hasPath(source: unknown, path: string): boolean {\n  let current: unknown = source\n\n  for (const segment of splitPath(path)) {\n    if (\n      current === null ||\n      current === undefined ||\n      typeof current !== 'object' ||\n      !(segment in (current as object))\n    ) {\n      return false\n    }\n\n    current = (current as Record<string, unknown>)[segment]\n  }\n\n  return true\n}\n\n/**\n * Immutably set a value, cloning each container along the path. Numeric segments on a\n * missing container create arrays.\n */\nexport function setPath<T extends object>(source: T, path: string, value: unknown): T {\n  const segments = splitPath(path)\n\n  if (segments.length === 0) {\n    return value as T\n  }\n\n  const root: unknown = Array.isArray(source) ? [...source] : { ...(source ?? {}) }\n  let current = root as Record<string, unknown>\n\n  segments.forEach((segment, index) => {\n    const isLast = index === segments.length - 1\n\n    if (isLast) {\n      current[segment] = value\n\n      return\n    }\n\n    const existing = current[segment]\n    const nextSegment = segments[index + 1] ?? ''\n    const container =\n      existing !== null && typeof existing === 'object'\n        ? Array.isArray(existing)\n          ? [...existing]\n          : { ...existing }\n        : /^\\d+$/.test(nextSegment)\n          ? []\n          : {}\n\n    current[segment] = container\n    current = container as Record<string, unknown>\n  })\n\n  return root as T\n}\n\nexport function deletePath<T extends object>(source: T, path: string): T {\n  const segments = splitPath(path)\n  const last = segments.pop()\n\n  if (last === undefined) {\n    return source\n  }\n\n  const parentPath = segments.join('.')\n  const parent = getPath<Record<string, unknown> | unknown[]>(source, parentPath)\n\n  if (parent === null || parent === undefined || typeof parent !== 'object') {\n    return source\n  }\n\n  if (Array.isArray(parent)) {\n    const copy = [...parent]\n    copy.splice(Number(last), 1)\n\n    return setPath(source, parentPath, copy)\n  }\n\n  const copy = { ...parent }\n  delete copy[last]\n\n  return setPath(source, parentPath, copy)\n}\n\nexport function parentPath(path: string): string {\n  const segments = splitPath(path)\n  segments.pop()\n\n  return segments.join('.')\n}\n\nexport function joinPath(...segments: PathSegment[]): string {\n  return segments\n    .map(String)\n    .filter((segment) => segment !== '')\n    .join('.')\n}\n\n/**\n * Replace the Repeater template placeholder with a concrete index, deeply, in any\n * string value of the object (state paths, keys, ids). Only the first placeholder of each\n * string is this level's: a repeater inside a builder block template has item paths like\n * `content.__INDEX__.data.items.__INDEX__.question`, whose second placeholder is filled\n * in when an item is added to that repeater.\n */\nexport function replacePlaceholder<T>(value: T, placeholder: string, replacement: string): T {\n  if (typeof value === 'string') {\n    const at = value.indexOf(placeholder)\n\n    return (\n      at === -1 ? value : value.slice(0, at) + replacement + value.slice(at + placeholder.length)\n    ) as T\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => replacePlaceholder(item, placeholder, replacement)) as T\n  }\n\n  if (value !== null && typeof value === 'object') {\n    const result: Record<string, unknown> = {}\n\n    for (const [key, nested] of Object.entries(value as Record<string, unknown>)) {\n      result[key] = replacePlaceholder(nested, placeholder, replacement)\n    }\n\n    return result as T\n  }\n\n  return value\n}\n\n// Instances of a template per index, kept while the template object lives (it is replaced\n// when the server sends a new schema).\nconst templateInstances = new WeakMap<object, Map<string, unknown>>()\n\n/**\n * A Repeater or Builder template with the item index filled in (`replacePlaceholder()`),\n * the same object for the same template and index. Items the server hasn't seen yet render\n * from their template on every render: new objects each time made every field below them\n * render again (and restart work such as the image editor's loading).\n */\nexport function templateForIndex<T extends object>(template: T, index: number | string): T {\n  let instances = templateInstances.get(template)\n\n  if (!instances) {\n    instances = new Map()\n    templateInstances.set(template, instances)\n  }\n\n  const key = String(index)\n  let instance = instances.get(key) as T | undefined\n\n  if (instance === undefined) {\n    instance = replacePlaceholder(template, '__INDEX__', key)\n    instances.set(key, instance)\n  }\n\n  return instance\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfakit/core",
-  "version": "0.1.1",
+  "version": "0.1.6",
   "description": "Framework-agnostic schema types and state management for Alfakit, the Laravel admin panel builder by Alfa Six.",
   "license": "MIT",
   "author": "Alfa Six (https://alfasixbh.com)",
@@ -34,13 +34,15 @@
       "import": "./dist/schema/index.js"
     },
     "./package.json": "./package.json",
-    "./themes.css": "./themes.css"
+    "./themes.css": "./themes.css",
+    "./components.css": "./components.css"
   },
   "files": [
     "dist",
     "README.md",
     "CHANGELOG.md",
-    "themes.css"
+    "themes.css",
+    "components.css"
   ],
   "dependencies": {
     "@inertiajs/core": "^3.8.0"