@eifi1/ui-kit 0.45.0 → 0.46.0

package/dist/shell/top-bar-actions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shell/top-bar-actions.tsx"],"sourcesContent":["import { Fragment } from \"react\";\nimport type { ReactNode } from \"react\";\n\n/**\n * The top bar's items by name (docs/top-bar-harmonization.md §2.1, §6.6). Each is the\n * app's own node — a kit part or its own — and any may be left out.\n */\nexport interface TopBarActionsProps {\n  /** kastlan's `CompanySwitcher`: the context, first. */\n  companySwitcher?: ReactNode;\n  /** `GlobalSearch` (⌘K). */\n  search?: ReactNode;\n  /** `ThemeToggle`. */\n  theme?: ReactNode;\n  /** `FeedbackMenu`. */\n  feedback?: ReactNode;\n  /** `TourMenu`. */\n  tours?: ReactNode;\n  /** kastlan's assistant, beside the tours while it is on. */\n  assistant?: ReactNode;\n  /** `SyncStatusIndicator`. */\n  sync?: ReactNode;\n  /** `DevSwitchers` (role, then plan). */\n  dev?: ReactNode;\n  /** kastlan's platform button. */\n  platform?: ReactNode;\n  /** The account menu. When it is set the signed-out slots are not drawn. */\n  account?: ReactNode;\n  /** Signed out (§6.6): the bar's `LanguageMenu`, since there is no account menu to hold\n   *  the language. Drawn only without `account`. */\n  language?: ReactNode;\n  /** Signed out (§6.6): the \"Sign in\" button, where the account menu would be. Drawn only\n   *  without `account`. */\n  signIn?: ReactNode;\n}\n\n/** §2.1's order, then the signed-out pair in the account menu's place. */\nexport const TOP_BAR_ACTION_ORDER = [\n  \"companySwitcher\",\n  \"search\",\n  \"theme\",\n  \"feedback\",\n  \"tours\",\n  \"assistant\",\n  \"sync\",\n  \"dev\",\n  \"platform\",\n  \"account\",\n  \"language\",\n  \"signIn\",\n] as const satisfies readonly (keyof TopBarActionsProps)[];\n\nconst present = (node: ReactNode) => node !== undefined && node !== null && node !== false && node !== \"\";\n\n/**\n * The top bar's actions in the one order every app shares (§2.1): company switcher ·\n * Search · Theme · Feedback · Tours (· Assistant) · Sync · dev role · dev plan · platform ·\n * account menu — and, signed out, Language · Sign in where the account menu goes (§6.6).\n * The app fills the slots it has; an empty slot is skipped, so it leaves no gap.\n *\n * It draws a fragment, no box of its own: hand it to `TopBar`'s `actions`, whose row\n * spaces the items.\n *\n * ```tsx\n * <TopBar brand={…} actions={<TopBarActions search={…} theme={…} tours={…} account={…} />} />\n * ```\n */\nexport function TopBarActions(props: TopBarActionsProps) {\n  const signedOut = !present(props.account);\n  return (\n    <>\n      {TOP_BAR_ACTION_ORDER.map((slot) => {\n        if ((slot === \"language\" || slot === \"signIn\") && !signedOut) return null;\n        const node = props[slot];\n        return present(node) ? <Fragment key={slot}>{node}</Fragment> : null;\n      })}\n    </>\n  );\n}\n"],"mappings":";AAsEI,mBAI2B,WAJ3B;AAtEJ,SAAS,YAAAA,iBAAgB;AAqClB,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,UAAU,CAAC,SAAoB,SAAS,UAAa,SAAS,QAAQ,SAAS,SAAS,SAAS;AAehG,SAAS,cAAc,OAA2B;AACvD,QAAM,YAAY,CAAC,QAAQ,MAAM,OAAO;AACxC,SACE,gCACG,+BAAqB,IAAI,CAAC,SAAS;AAClC,SAAK,SAAS,cAAc,SAAS,aAAa,CAAC,UAAW,QAAO;AACrE,UAAM,OAAO,MAAM,IAAI;AACvB,WAAO,QAAQ,IAAI,IAAI,oBAACA,WAAA,EAAqB,kBAAP,IAAY,IAAc;AAAA,EAClE,CAAC,GACH;AAEJ;","names":["Fragment"]}
+{"version":3,"sources":["../../src/shell/top-bar-actions.tsx"],"sourcesContent":["import { Fragment } from \"react\";\nimport type { ReactNode } from \"react\";\n\n/**\n * The top bar's items by name (docs/top-bar-harmonization.md §2.1, §6.6). Each is the\n * app's own node — a kit part or its own — and any may be left out.\n */\nexport interface TopBarActionsProps {\n  /** kastlan's `CompanySwitcher`: the context, first. */\n  companySwitcher?: ReactNode;\n  /** `GlobalSearch` (⌘K). */\n  search?: ReactNode;\n  /** `ThemeToggle`. */\n  theme?: ReactNode;\n  /** `FeedbackMenu`. */\n  feedback?: ReactNode;\n  /** `TourMenu`. */\n  tours?: ReactNode;\n  /** kastlan's assistant, beside the tours while it is on. */\n  assistant?: ReactNode;\n  /** `SyncStatusIndicator`. */\n  sync?: ReactNode;\n  /** `DevSwitchers` (role, then plan). */\n  dev?: ReactNode;\n  /** kastlan's platform button. */\n  platform?: ReactNode;\n  /** 0.46 (docs/notifications-harmonization.md §10.1): `NotificationBell`, right before the\n   *  account menu. Optional per app: an app shows the bell or an unread dot on the avatar,\n   *  never both (keksdose keeps its dot and leaves this empty). */\n  notifications?: ReactNode;\n  /** The account menu. When it is set the signed-out slots are not drawn. */\n  account?: ReactNode;\n  /** Signed out (§6.6): the bar's `LanguageMenu`, since there is no account menu to hold\n   *  the language. Drawn only without `account`. */\n  language?: ReactNode;\n  /** Signed out (§6.6): the \"Sign in\" button, where the account menu would be. Drawn only\n   *  without `account`. */\n  signIn?: ReactNode;\n}\n\n/** §2.1's order, then the signed-out pair in the account menu's place. */\nexport const TOP_BAR_ACTION_ORDER = [\n  \"companySwitcher\",\n  \"search\",\n  \"theme\",\n  \"feedback\",\n  \"tours\",\n  \"assistant\",\n  \"sync\",\n  \"dev\",\n  \"platform\",\n  \"notifications\",\n  \"account\",\n  \"language\",\n  \"signIn\",\n] as const satisfies readonly (keyof TopBarActionsProps)[];\n\nconst present = (node: ReactNode) => node !== undefined && node !== null && node !== false && node !== \"\";\n\n/**\n * The top bar's actions in the one order every app shares (§2.1): company switcher ·\n * Search · Theme · Feedback · Tours (· Assistant) · Sync · dev role · dev plan · platform ·\n * notifications (the bell, 0.46) · account menu — and, signed out, Language · Sign in where the account menu goes (§6.6).\n * The app fills the slots it has; an empty slot is skipped, so it leaves no gap.\n *\n * It draws a fragment, no box of its own: hand it to `TopBar`'s `actions`, whose row\n * spaces the items.\n *\n * ```tsx\n * <TopBar brand={…} actions={<TopBarActions search={…} theme={…} tours={…} account={…} />} />\n * ```\n */\nexport function TopBarActions(props: TopBarActionsProps) {\n  const signedOut = !present(props.account);\n  return (\n    <>\n      {TOP_BAR_ACTION_ORDER.map((slot) => {\n        if ((slot === \"language\" || slot === \"signIn\") && !signedOut) return null;\n        const node = props[slot];\n        return present(node) ? <Fragment key={slot}>{node}</Fragment> : null;\n      })}\n    </>\n  );\n}\n"],"mappings":";AA2EI,mBAI2B,WAJ3B;AA3EJ,SAAS,YAAAA,iBAAgB;AAyClB,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,UAAU,CAAC,SAAoB,SAAS,UAAa,SAAS,QAAQ,SAAS,SAAS,SAAS;AAehG,SAAS,cAAc,OAA2B;AACvD,QAAM,YAAY,CAAC,QAAQ,MAAM,OAAO;AACxC,SACE,gCACG,+BAAqB,IAAI,CAAC,SAAS;AAClC,SAAK,SAAS,cAAc,SAAS,aAAa,CAAC,UAAW,QAAO;AACrE,UAAM,OAAO,MAAM,IAAI;AACvB,WAAO,QAAQ,IAAI,IAAI,oBAACA,WAAA,EAAqB,kBAAP,IAAY,IAAc;AAAA,EAClE,CAAC,GACH;AAEJ;","names":["Fragment"]}

package/dist/shell.d.ts

@@ -35,6 +35,8 @@ export { TopBarActions, TOP_BAR_ACTION_ORDER } from "./shell/top-bar-actions.js"
 export type { TopBarActionsProps } from "./shell/top-bar-actions.js";
 export { AccountMenuLanguage } from "./shell/account-menu-language.js";
 export type { AccountMenuLanguageProps, AccountMenuLanguageOption } from "./shell/account-menu-language.js";
+export { AccountMenuTextSize } from "./shell/account-menu-text-size.js";
+export type { AccountMenuTextSizeProps } from "./shell/account-menu-text-size.js";
 export { TourMenu } from "./shell/tour-menu.js";
 export type { TourMenuProps, TourMenuTour } from "./shell/tour-menu.js";
 export { SyncStatusIndicator, syncState } from "./shell/sync-status-indicator.js";

package/dist/shell.js

@@ -41,12 +41,14 @@ import {
 import { PublicHeader } from "./landing/public-header.js";
 import { TopBarActions, TOP_BAR_ACTION_ORDER } from "./shell/top-bar-actions.js";
 import { AccountMenuLanguage } from "./shell/account-menu-language.js";
+import { AccountMenuTextSize } from "./shell/account-menu-text-size.js";
 import { TourMenu } from "./shell/tour-menu.js";
 import { SyncStatusIndicator, syncState } from "./shell/sync-status-indicator.js";
 import { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from "./shell/dev-switchers.js";
 import { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from "./shell/top-bar-parts-labels.js";
 export {
   AccountMenuLanguage,
+  AccountMenuTextSize,
   AdminMenuRow,
   AdminWaitingBadge,
   DEFAULT_LAST_VISITED_EXCLUDES,

package/dist/shell.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.40.0: the list page's fill (docs/page-layout-harmonization.md §1.3).\nexport { FillHeight, FILL_HEIGHT_CLASS } from \"./shell/fill-height\";\nexport type { FillHeightProps } from \"./shell/fill-height\";\n// 0.42.0: the account menu's \"Administration\" row, as an entry and as a HoverMenu row\n// (docs/admin-harmonization.md §2.1, §6.6).\nexport { adminMenuEntry, AdminMenuRow } from \"./shell/admin-menu\";\nexport type { AdminMenuEntryOptions, AdminMenuRowProps } from \"./shell/admin-menu\";\n// 0.43.0 (kastlan): the entry with the provider's words.\nexport { useAdminMenuEntry } from \"./shell/admin-menu\";\nexport type { UseAdminMenuEntryOptions } from \"./shell/admin-menu\";\n// 0.45.0 (docs/admin-harmonization.md §9.3.4): the row's waiting pill on its own, for\n// IconButton's `badge` (kastlan's platform button); its name is `adminArea.waitingLabel`.\nexport { AdminWaitingBadge } from \"./shell/admin-menu\";\nexport type { AdminWaitingBadgeProps } from \"./shell/admin-menu\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n// 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in\n// §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the\n// local-dev switchers, and their words.\nexport { TopBarActions, TOP_BAR_ACTION_ORDER } from \"./shell/top-bar-actions\";\nexport type { TopBarActionsProps } from \"./shell/top-bar-actions\";\nexport { AccountMenuLanguage } from \"./shell/account-menu-language\";\nexport type { AccountMenuLanguageProps, AccountMenuLanguageOption } from \"./shell/account-menu-language\";\nexport { TourMenu } from \"./shell/tour-menu\";\nexport type { TourMenuProps, TourMenuTour } from \"./shell/tour-menu\";\nexport { SyncStatusIndicator, syncState } from \"./shell/sync-status-indicator\";\nexport type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from \"./shell/sync-status-indicator\";\nexport { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from \"./shell/dev-switchers\";\nexport type { DevSwitchersProps } from \"./shell/dev-switchers\";\nexport { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from \"./shell/top-bar-parts-labels\";\nexport type {\n  TopBarPartsLabels,\n  TourMenuLabels,\n  SyncStatusLabels,\n  DevSwitchersLabels,\n} from \"./shell/top-bar-parts-labels\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,YAAY,yBAAyB;AAI9C,SAAS,gBAAgB,oBAAoB;AAG7C,SAAS,yBAAyB;AAIlC,SAAS,yBAAyB;AAGlC,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;AAK7B,SAAS,eAAe,4BAA4B;AAEpD,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB,iBAAiB;AAE/C,SAAS,cAAc,6BAA6B;AAEpD,SAAS,8BAA8B,4BAA4B;","names":[]}
+{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.40.0: the list page's fill (docs/page-layout-harmonization.md §1.3).\nexport { FillHeight, FILL_HEIGHT_CLASS } from \"./shell/fill-height\";\nexport type { FillHeightProps } from \"./shell/fill-height\";\n// 0.42.0: the account menu's \"Administration\" row, as an entry and as a HoverMenu row\n// (docs/admin-harmonization.md §2.1, §6.6).\nexport { adminMenuEntry, AdminMenuRow } from \"./shell/admin-menu\";\nexport type { AdminMenuEntryOptions, AdminMenuRowProps } from \"./shell/admin-menu\";\n// 0.43.0 (kastlan): the entry with the provider's words.\nexport { useAdminMenuEntry } from \"./shell/admin-menu\";\nexport type { UseAdminMenuEntryOptions } from \"./shell/admin-menu\";\n// 0.45.0 (docs/admin-harmonization.md §9.3.4): the row's waiting pill on its own, for\n// IconButton's `badge` (kastlan's platform button); its name is `adminArea.waitingLabel`.\nexport { AdminWaitingBadge } from \"./shell/admin-menu\";\nexport type { AdminWaitingBadgeProps } from \"./shell/admin-menu\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n// 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in\n// §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the\n// local-dev switchers, and their words.\nexport { TopBarActions, TOP_BAR_ACTION_ORDER } from \"./shell/top-bar-actions\";\nexport type { TopBarActionsProps } from \"./shell/top-bar-actions\";\nexport { AccountMenuLanguage } from \"./shell/account-menu-language\";\nexport type { AccountMenuLanguageProps, AccountMenuLanguageOption } from \"./shell/account-menu-language\";\n// 0.46.0 (keksdose live #426): A− / A+ for the text size, beside the language.\nexport { AccountMenuTextSize } from \"./shell/account-menu-text-size\";\nexport type { AccountMenuTextSizeProps } from \"./shell/account-menu-text-size\";\nexport { TourMenu } from \"./shell/tour-menu\";\nexport type { TourMenuProps, TourMenuTour } from \"./shell/tour-menu\";\nexport { SyncStatusIndicator, syncState } from \"./shell/sync-status-indicator\";\nexport type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from \"./shell/sync-status-indicator\";\nexport { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from \"./shell/dev-switchers\";\nexport type { DevSwitchersProps } from \"./shell/dev-switchers\";\nexport { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from \"./shell/top-bar-parts-labels\";\nexport type {\n  TopBarPartsLabels,\n  TourMenuLabels,\n  SyncStatusLabels,\n  DevSwitchersLabels,\n} from \"./shell/top-bar-parts-labels\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,YAAY,yBAAyB;AAI9C,SAAS,gBAAgB,oBAAoB;AAG7C,SAAS,yBAAyB;AAIlC,SAAS,yBAAyB;AAGlC,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;AAK7B,SAAS,eAAe,4BAA4B;AAEpD,SAAS,2BAA2B;AAGpC,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB,iBAAiB;AAE/C,SAAS,cAAc,6BAA6B;AAEpD,SAAS,8BAA8B,4BAA4B;","names":[]}

package/dist/sync/db.d.ts

@@ -0,0 +1,76 @@
+import Dexie, { type Table, type Transaction } from "dexie";
+/** A row as `/sync` carries it: the entity (a table name), its sync id, the server's id
+ *  once it has one, and its fields. */
+export interface SyncedRow {
+    entity: string;
+    id: string;
+    pk: number | null;
+    data: Record<string, unknown>;
+    /** The server's stamp of the row, as the pull carried it BESIDE `data` (kastlan's wire);
+     *  the next edit here is stamped after it (`stampAfter`, D2). */
+    updated_at?: string | null;
+}
+/**
+ * Where a change made here stands. `pending`: queued. `sending`: in the request now out (a
+ * new edit starts a change of its own). `waiting`: refused with a hold code (a lapsed plan,
+ * `holdCodes`), sent again every round. `blocked`: refused with any other code, kept, sent
+ * again only on `retryBlocked()`. `rejected`: the server's rules refused it (`reason` says
+ * why); never sent again.
+ */
+export type OutboxStatus = "pending" | "sending" | "waiting" | "blocked" | "rejected";
+/** A change made on this device, for `/sync`, in the scope its caller named (D11). */
+export interface OutboxChange {
+    seq?: number;
+    scope: string;
+    entity: string;
+    id: string;
+    op: "upsert" | "delete";
+    data: Record<string, unknown>;
+    /** The edit's time on this device (D2), stamped with `stampAfter`. */
+    updated_at: string;
+    status: OutboxStatus;
+    /** The server's words: a rejection's `detail`, a refusal's `detail`. */
+    reason?: string;
+    /** The server's code: a rejection's or a refusal's `code`. */
+    code?: string;
+}
+export interface SyncMetaEntry {
+    key: string;
+    value: unknown;
+}
+/** The engine's database: its three tables, and the app's own under the names it gave. */
+export type SyncDb = Dexie & {
+    rows: Table<SyncedRow, [string, string]>;
+    outbox: Table<OutboxChange, number>;
+    meta: Table<SyncMetaEntry, string>;
+};
+/** A schema step of an existing database (kastlan's v2: `scope` on the outbox). */
+export interface SyncDbUpgrade {
+    version: number;
+    /** Stores this version adds or changes, beside the engine's and `extraStores`. */
+    stores?: Record<string, string | null>;
+    upgrade?(tx: Transaction): Promise<void> | void;
+}
+export interface CreateSyncDbOptions {
+    /** The app's own tables, Dexie schema strings: kastlan `{ photos: "id, roomId, status" }`. */
+    extraStores?: Record<string, string>;
+    /** Later versions of a database that exists on devices already, oldest first. */
+    upgrades?: readonly SyncDbUpgrade[];
+}
+/** The engine's own tables. `scope` is indexed: a round takes one scope's queue (D11). */
+export declare const SYNC_DB_STORES: {
+    readonly rows: "[entity+id], entity";
+    readonly outbox: "++seq, [entity+id], status, scope";
+    readonly meta: "key";
+};
+/**
+ * Open (lazily, on first use) the sync database `name`: the engine's tables plus the app's
+ * `extraStores`, at version 1 or the last of `upgrades`. One database per account (kastlan:
+ * per account and company, `kastlan-handover-<user>-<company>`), and one engine on it (D15).
+ *
+ * An app whose database predates the engine names its next version in `upgrades` and moves
+ * its data there — kastlan: `{ version: 2, upgrade: (tx) => tx.table("outbox").toCollection()
+ * .modify({ scope: "handover" }) }`. Dexie diffs the schema against the one on the device.
+ * Name the app's own type for its tables: `createSyncDb<HandoverDb>(name, { extraStores })`.
+ */
+export declare function createSyncDb<D extends SyncDb = SyncDb>(name: string, options?: CreateSyncDbOptions): D;

package/dist/sync/db.js

@@ -0,0 +1,24 @@
+"use client";
+import Dexie from "dexie";
+const SYNC_DB_STORES = {
+  rows: "[entity+id], entity",
+  outbox: "++seq, [entity+id], status, scope",
+  meta: "key"
+};
+function createSyncDb(name, options = {}) {
+  const db = new Dexie(name);
+  let stores = { ...SYNC_DB_STORES, ...options.extraStores };
+  db.version(1).stores(stores);
+  const upgrades = [...options.upgrades ?? []].sort((a, b) => a.version - b.version);
+  for (const step of upgrades) {
+    stores = { ...stores, ...step.stores };
+    const version = db.version(step.version).stores(stores);
+    if (step.upgrade) version.upgrade(step.upgrade);
+  }
+  return db;
+}
+export {
+  SYNC_DB_STORES,
+  createSyncDb
+};
+//# sourceMappingURL=db.js.map

package/dist/sync/db.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sync/db.ts"],"sourcesContent":["import Dexie, { type Table, type Transaction } from \"dexie\";\n\n/*\n * The device's copy for the sync engine (docs/local-first-harmonization.md §2.3, D10): ONE\n * Dexie database with the engine's three tables — the rows as `/sync` carries them, the\n * outbox of changes made here, and a key/value `meta` — plus the app's own (kastlan's\n * `photos`). A generic store, not keksdose's per-entity tables.\n */\n\n/** A row as `/sync` carries it: the entity (a table name), its sync id, the server's id\n *  once it has one, and its fields. */\nexport interface SyncedRow {\n  entity: string;\n  id: string;\n  pk: number | null;\n  data: Record<string, unknown>;\n  /** The server's stamp of the row, as the pull carried it BESIDE `data` (kastlan's wire);\n   *  the next edit here is stamped after it (`stampAfter`, D2). */\n  updated_at?: string | null;\n}\n\n/**\n * Where a change made here stands. `pending`: queued. `sending`: in the request now out (a\n * new edit starts a change of its own). `waiting`: refused with a hold code (a lapsed plan,\n * `holdCodes`), sent again every round. `blocked`: refused with any other code, kept, sent\n * again only on `retryBlocked()`. `rejected`: the server's rules refused it (`reason` says\n * why); never sent again.\n */\nexport type OutboxStatus = \"pending\" | \"sending\" | \"waiting\" | \"blocked\" | \"rejected\";\n\n/** A change made on this device, for `/sync`, in the scope its caller named (D11). */\nexport interface OutboxChange {\n  seq?: number;\n  scope: string;\n  entity: string;\n  id: string;\n  op: \"upsert\" | \"delete\";\n  data: Record<string, unknown>;\n  /** The edit's time on this device (D2), stamped with `stampAfter`. */\n  updated_at: string;\n  status: OutboxStatus;\n  /** The server's words: a rejection's `detail`, a refusal's `detail`. */\n  reason?: string;\n  /** The server's code: a rejection's or a refusal's `code`. */\n  code?: string;\n}\n\nexport interface SyncMetaEntry {\n  key: string;\n  value: unknown;\n}\n\n/** The engine's database: its three tables, and the app's own under the names it gave. */\nexport type SyncDb = Dexie & {\n  rows: Table<SyncedRow, [string, string]>;\n  outbox: Table<OutboxChange, number>;\n  meta: Table<SyncMetaEntry, string>;\n};\n\n/** A schema step of an existing database (kastlan's v2: `scope` on the outbox). */\nexport interface SyncDbUpgrade {\n  version: number;\n  /** Stores this version adds or changes, beside the engine's and `extraStores`. */\n  stores?: Record<string, string | null>;\n  upgrade?(tx: Transaction): Promise<void> | void;\n}\n\nexport interface CreateSyncDbOptions {\n  /** The app's own tables, Dexie schema strings: kastlan `{ photos: \"id, roomId, status\" }`. */\n  extraStores?: Record<string, string>;\n  /** Later versions of a database that exists on devices already, oldest first. */\n  upgrades?: readonly SyncDbUpgrade[];\n}\n\n/** The engine's own tables. `scope` is indexed: a round takes one scope's queue (D11). */\nexport const SYNC_DB_STORES = {\n  rows: \"[entity+id], entity\",\n  outbox: \"++seq, [entity+id], status, scope\",\n  meta: \"key\",\n} as const;\n\n/**\n * Open (lazily, on first use) the sync database `name`: the engine's tables plus the app's\n * `extraStores`, at version 1 or the last of `upgrades`. One database per account (kastlan:\n * per account and company, `kastlan-handover-<user>-<company>`), and one engine on it (D15).\n *\n * An app whose database predates the engine names its next version in `upgrades` and moves\n * its data there — kastlan: `{ version: 2, upgrade: (tx) => tx.table(\"outbox\").toCollection()\n * .modify({ scope: \"handover\" }) }`. Dexie diffs the schema against the one on the device.\n * Name the app's own type for its tables: `createSyncDb<HandoverDb>(name, { extraStores })`.\n */\nexport function createSyncDb<D extends SyncDb = SyncDb>(name: string, options: CreateSyncDbOptions = {}): D {\n  const db = new Dexie(name) as D;\n  let stores: Record<string, string | null> = { ...SYNC_DB_STORES, ...options.extraStores };\n  db.version(1).stores(stores);\n  const upgrades = [...(options.upgrades ?? [])].sort((a, b) => a.version - b.version);\n  for (const step of upgrades) {\n    stores = { ...stores, ...step.stores };\n    const version = db.version(step.version).stores(stores);\n    if (step.upgrade) version.upgrade(step.upgrade);\n  }\n  return db;\n}\n"],"mappings":";AAAA,OAAO,WAA6C;AA2E7C,MAAM,iBAAiB;AAAA,EAC5B,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,MAAM;AACR;AAYO,SAAS,aAAwC,MAAc,UAA+B,CAAC,GAAM;AAC1G,QAAM,KAAK,IAAI,MAAM,IAAI;AACzB,MAAI,SAAwC,EAAE,GAAG,gBAAgB,GAAG,QAAQ,YAAY;AACxF,KAAG,QAAQ,CAAC,EAAE,OAAO,MAAM;AAC3B,QAAM,WAAW,CAAC,GAAI,QAAQ,YAAY,CAAC,CAAE,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO;AACnF,aAAW,QAAQ,UAAU;AAC3B,aAAS,EAAE,GAAG,QAAQ,GAAG,KAAK,OAAO;AACrC,UAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,EAAE,OAAO,MAAM;AACtD,QAAI,KAAK,QAAS,SAAQ,QAAQ,KAAK,OAAO;AAAA,EAChD;AACA,SAAO;AACT;","names":[]}

package/dist/sync/engine.d.ts

@@ -0,0 +1,124 @@
+import type { OutboxChange, SyncDb } from "./db.js";
+import type { SyncRequestBody, SyncResponseBody } from "./wire.js";
+export interface SyncCounts {
+    pending: number;
+    waiting: number;
+    blocked: number;
+    rejected: number;
+}
+export interface SyncStepContext {
+    signal: AbortSignal;
+    /** False once `forget()` bumped the generation: the step writes nothing more (D15). */
+    isCurrent(): boolean;
+}
+export interface SyncStepResult {
+    /** The step met no connection: the round ends offline. */
+    offline?: boolean;
+    /** One more push/pull in the same round (kastlan's second pass after its photos). */
+    changed?: boolean;
+    /** What the step keeps on the device, added to the engine's counts. */
+    counts?: Partial<SyncCounts>;
+}
+/** Work after the push/pull, such as kastlan's photo upload. */
+export interface SyncStep {
+    name: string;
+    run(db: SyncDb, ctx: SyncStepContext): Promise<SyncStepResult>;
+    /** Its counts read from the device between rounds (a photo taken offline shows at once). */
+    counts?(db: SyncDb): Promise<Partial<SyncCounts>>;
+}
+export interface SyncEngineState {
+    phase: "idle" | "syncing" | "offline" | "error";
+    online: boolean;
+    counts: SyncCounts;
+    /** When a scope's walk last completed (ISO), kept in `meta` (D9). */
+    lastSyncedAt: string | null;
+    /** When the next attempt after an error runs (epoch ms), or `null`. */
+    nextRetryAt: number | null;
+}
+export interface SyncRoundResult {
+    /** `paused`: `paused()` held the round. `dropped`: `forget()` ran during it, its answer unused. */
+    outcome: "synced" | "offline" | "error" | "paused" | "dropped";
+    /** Changes this round set `waiting`, `blocked` or `rejected`. */
+    waiting: number;
+    blocked: number;
+    rejected: number;
+    error?: unknown;
+}
+export interface SyncEngineOptions {
+    db: SyncDb;
+    /** The scopes this session's role holds, in round order (kastlan: handover, meetings, meters,
+     *  maintenance, contacts). Read at the start of every round: roles are per company. */
+    scopes: () => readonly string[];
+    /** Posts one request (`POST /sync`) and answers its body; throws as the app's client does. */
+    send: (body: SyncRequestBody, signal: AbortSignal) => Promise<SyncResponseBody>;
+    /** Default {@link isOfflineError}: no answer, or the session refresh's passing 401. */
+    isOffline?: (err: unknown) => boolean;
+    /** A whole request refused for the plan → every sent change `waiting` with this code.
+     *  Default: a 402 whose body names a `code` (or `detail.code`). */
+    planCode?: (err: unknown) => string | null;
+    /** `refused.code`s kept as `waiting` and sent again every round; any other code is
+     *  `blocked`, sent again only on `retryBlocked()`. Default `["billing_read_only"]`. */
+    holdCodes?: readonly string[];
+    /** Ask for a paged pull and follow its cursor (D12). */
+    paged?: boolean;
+    steps?: readonly SyncStep[];
+    /** No round while this holds (kastlan: a practice tour fakes the server's answers). */
+    paused?: () => boolean;
+    /** The poll (30 s) and the debounce after a write (800 ms). */
+    pollMs?: number;
+    soonMs?: number;
+    /** The waits after consecutive errors; the last repeats (D13). */
+    backoffMs?: readonly number[];
+    /** Default `isSharedComputer`: on a computer marked shared the engine does not start (D15). */
+    sharedComputer?: () => boolean;
+}
+export interface SyncEngine {
+    /** Into the copy at once and into the queue, in the scope the caller names (D11). An edit
+     *  merges into the row's last `pending` upsert; deleting a row that never reached the
+     *  server forgets its queue; stamped with `stampAfter`. */
+    write(scope: string, entity: string, id: string, op: "upsert" | "delete", data?: Record<string, unknown>): Promise<void>;
+    start(): void;
+    /** Stops the poll and the timers, aborts the round in flight and drops its answer (the
+     *  queue is laid back). A new engine's round on the same database waits for it. */
+    stop(): void;
+    /** Sync soon (debounced): after a write. */
+    requestSync(): void;
+    /** "Sync now": resets the backoff, runs a round (after the one under way). */
+    syncNow(): Promise<SyncRoundResult>;
+    /** A round that sends the `blocked` changes too. */
+    retryBlocked(): Promise<void>;
+    /** Drop the rejected changes (of one scope) and pull that scope afresh. */
+    discardRejected(scope?: string): Promise<void>;
+    /** The rejected changes with their reasons, for the app's banner. */
+    rejected(): Promise<OutboxChange[]>;
+    /** Sign-out: bump the generation (a round in flight writes nothing more), then clear the
+     *  rows and `meta` — and the outbox and the app's tables unless `keepQueue` (D15). */
+    forget(opts: {
+        keepQueue: boolean;
+    }): Promise<void>;
+    getState(): SyncEngineState;
+    subscribe(listener: () => void): () => void;
+}
+export declare const DEFAULT_SYNC_BACKOFF_MS: readonly number[];
+export declare const DEFAULT_HOLD_CODES: readonly string[];
+/**
+ * The engine on one database (D15: one engine per database; a company switch builds a new
+ * engine on the new database and stops the old one). Nothing runs until `start()`
+ * (`useSyncWorker`), and `start()` does nothing on a computer marked shared.
+ */
+export declare function createSyncEngine(options: SyncEngineOptions): SyncEngine;
+/**
+ * The engine kept for `options.db` (by its name), built on first use: one engine per
+ * database for the session (D15), so a company switch A→B→A finds A's engine again instead
+ * of building a second one beside a round in flight. The first call's options stand: read
+ * changing values (scopes, the client) through functions. A database object opened afresh
+ * under the same name replaces the kept engine (the old one is stopped).
+ */
+export declare function syncEngineFor(options: SyncEngineOptions): SyncEngine;
+/**
+ * Let go of the engine {@link syncEngineFor} keeps for the database `name` (0.46): it is
+ * stopped, its database closed and forgotten, so a later `syncEngineFor` builds afresh. Call it
+ * on sign-out (and for a company left for good): every database visited in a tab otherwise
+ * keeps its engine and an open IndexedDB connection until a reload. Nothing kept: a no-op.
+ */
+export declare function releaseSyncEngine(name: string): void;