@cosmicdrift/kumiko-framework 0.328.0 → 0.329.0

package/src/time/tz-context.ts

@@ -1,100 +0,0 @@
-// ctx.tz — the feature-code API for TZ operations.
-//
-// A consistent shape for every date/time need in handler code:
-//   - "now as a UTC instant"          → ctx.tz.now()
-//   - "today in the tenant's TZ"      → ctx.tz.today(ctx.tz.tenant)
-//   - "parse a wall-clock string"     → ctx.tz.parse("2026-04-03T10:00", "Europe/Lisbon")
-//   - "ZonedDateTime → JSON pair"     → ctx.tz.toLocatedJson(zdt)
-//   - "JSON pair → ZonedDateTime"     → ctx.tz.fromLocatedJson({ at, tz })
-//
-// Feature code should no longer call `new Date()` — the lint rule for that
-// lands in a later iteration, once all existing usages are migrated.
-//
-// `tenant` + `user` are the TZ defaults for the current request — resolved
-// by buildHandlerContext (tenant:config:timezone, then SessionUser.timezone,
-// falling back to "UTC" at each step) and passed in via TzContextOptions.
-// This factory itself stays a pure default-filler.
-//
-// The pure type contracts (TzContext, TzContextOptions, LocatedTimestampJson)
-// live in @cosmicdrift/kumiko-types/tz-context — only the factories are here.
-
-import type { TzContext, TzContextOptions } from "@cosmicdrift/kumiko-types/tz-context";
-import { Temporal as TemporalPolyfill } from "temporal-polyfill";
-import { ensureTemporalPolyfill } from "./polyfill";
-
-// Back-compat shim: re-exported so existing `from "@cosmicdrift/kumiko-framework/time/tz-context"`
-// imports keep working. Prefer importing from @cosmicdrift/kumiko-types/tz-context directly in
-// new code — drop this re-export once no framework-path imports remain.
-export type {
-  LocatedTimestampJson,
-  TzContext,
-  TzContextOptions,
-} from "@cosmicdrift/kumiko-types/tz-context";
-
-/**
- * Factory: creates a TzContext for the current request.
- * Uses temporal-polyfill's module export (not globalThis.Temporal) so
- * buildHandlerContext stays ambient-free (fw#1525/#1550).
- */
-export function createTzContext(options: TzContextOptions = {}): TzContext {
-  const tenant = options.tenant ?? "UTC";
-  const user = options.user ?? tenant;
-  const geoTz = options.geoTz;
-  // @cast-boundary temporal-polyfill-vs-ambient: same TC39 Temporal values at
-  // runtime; TzContext is typed against ambient Temporal from temporal-spec.
-  const T = TemporalPolyfill as unknown as typeof Temporal;
-
-  return {
-    tenant,
-    user,
-    now: () => T.Now.instant(), // @wrapper-known semantic-alias
-    nowIn: (tz: string) => T.Now.zonedDateTimeISO(tz), // @wrapper-known semantic-alias
-    today: (tz: string) => T.Now.plainDateISO(tz), // @wrapper-known semantic-alias
-    todayRange: (tz: string) => {
-      const today = T.Now.plainDateISO(tz);
-      const startZdt = today.toZonedDateTime({ timeZone: tz });
-      const endZdt = today.add({ days: 1 }).toZonedDateTime({ timeZone: tz });
-      return { start: startZdt.toInstant(), end: endZdt.toInstant() };
-    },
-    parse: (wallClock: string, tz: string) => T.PlainDateTime.from(wallClock).toZonedDateTime(tz),
-    toInstant: (zdt) => zdt.toInstant(),
-    toLocatedJson: (zdt) => ({
-      // Wall-clock WITHOUT offset (no "Z", no "+01:00") plus the IANA name.
-      // .toPlainDateTime().toString() returns "YYYY-MM-DDTHH:MM:SS[.fff]"
-      // without an offset — exactly our contract.
-      at: zdt.toPlainDateTime().toString(),
-      tz: zdt.timeZoneId,
-    }),
-    fromLocatedJson: (obj) => T.PlainDateTime.from(obj.at).toZonedDateTime(obj.tz),
-    fromCoordinates: async (coords) => {
-      if (geoTz === undefined) {
-        throw new Error(
-          "ctx.tz.fromCoordinates requires a GeoTzProvider — inject one via the app context (e.g. buildServer({ context: { geoTzProvider } }) or runProdApp({ extraContext: { geoTzProvider } })) or install a provider package.",
-        );
-      }
-      return geoTz.fromCoordinates(coords);
-    },
-    fromAddress: async (address) => {
-      if (geoTz === undefined) {
-        throw new Error(
-          "ctx.tz.fromAddress requires a GeoTzProvider — inject one via the app context (e.g. buildServer({ context: { geoTzProvider } }) or runProdApp({ extraContext: { geoTzProvider } })) or install a provider package.",
-        );
-      }
-      if (geoTz.fromAddress === undefined) {
-        throw new Error(
-          "ctx.tz.fromAddress requires a GeoTzProvider that implements fromAddress (geocoding). Offline lat/lng providers only support fromCoordinates.",
-        );
-      }
-      return geoTz.fromAddress(address);
-    },
-  };
-}
-
-/**
- * Convenience: ensures the polyfill is loaded AND creates the TzContext in
- * one await. Prefer this in boot code.
- */
-export async function createTzContextAsync(options?: TzContextOptions): Promise<TzContext> {
-  await ensureTemporalPolyfill();
-  return createTzContext(options);
-}

package/src/ui-types/__tests__/plural.test.ts

@@ -1,108 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { resolveTranslationValue, translationValueOtherText } from "../plural";
-
-const messageCount = {
-  de: { one: "{count} ungelesene Nachricht", other: "{count} ungelesene Nachrichten" },
-  en: { one: "{count} unread message", other: "{count} unread messages" },
-  pl: {
-    one: "{count} nieprzeczytana wiadomość",
-    few: "{count} nieprzeczytane wiadomości",
-    many: "{count} nieprzeczytanych wiadomości",
-    other: "{count} nieprzeczytanej wiadomości",
-  },
-} as const;
-
-describe("resolveTranslationValue — plain strings", () => {
-  test("interpolates {name} placeholders", () => {
-    expect(resolveTranslationValue("Hello, {name}!", "en", { name: "Ada" })).toBe("Hello, Ada!");
-  });
-
-  test("leaves an unknown placeholder untouched", () => {
-    expect(resolveTranslationValue("Hello, {name}!", "en")).toBe("Hello, {name}!");
-  });
-});
-
-describe("resolveTranslationValue — plural forms", () => {
-  test("en: singular vs plural", () => {
-    expect(resolveTranslationValue(messageCount.en, "en", { count: 1 })).toBe("1 unread message");
-    expect(resolveTranslationValue(messageCount.en, "en", { count: 0 })).toBe("0 unread messages");
-    expect(resolveTranslationValue(messageCount.en, "en", { count: 2 })).toBe("2 unread messages");
-    expect(resolveTranslationValue(messageCount.en, "en", { count: 5 })).toBe("5 unread messages");
-    expect(resolveTranslationValue(messageCount.en, "en", { count: 21 })).toBe(
-      "21 unread messages",
-    );
-  });
-
-  test("de: singular vs plural", () => {
-    expect(resolveTranslationValue(messageCount.de, "de", { count: 1 })).toBe(
-      "1 ungelesene Nachricht",
-    );
-    expect(resolveTranslationValue(messageCount.de, "de", { count: 5 })).toBe(
-      "5 ungelesene Nachrichten",
-    );
-  });
-
-  test("pl: one/few/many CLDR categories", () => {
-    expect(resolveTranslationValue(messageCount.pl, "pl", { count: 1 })).toBe(
-      "1 nieprzeczytana wiadomość",
-    );
-    expect(resolveTranslationValue(messageCount.pl, "pl", { count: 2 })).toBe(
-      "2 nieprzeczytane wiadomości",
-    );
-    expect(resolveTranslationValue(messageCount.pl, "pl", { count: 5 })).toBe(
-      "5 nieprzeczytanych wiadomości",
-    );
-    expect(resolveTranslationValue(messageCount.pl, "pl", { count: 21 })).toBe(
-      "21 nieprzeczytanych wiadomości",
-    );
-    expect(resolveTranslationValue(messageCount.pl, "pl", { count: 22 })).toBe(
-      "22 nieprzeczytane wiadomości",
-    );
-  });
-
-  test("a formal BCP-47 subtag still resolves plural categories (renderer's <locale>-x-formal tier)", () => {
-    expect(resolveTranslationValue(messageCount.pl, "pl-x-formal", { count: 2 })).toBe(
-      "2 nieprzeczytane wiadomości",
-    );
-  });
-
-  test("falls back to `other` when the selected category has no form", () => {
-    const partial = { one: "one item", other: "{count} items" };
-    // pl "5" selects "many", which `partial` doesn't define.
-    expect(resolveTranslationValue(partial, "pl", { count: 5 })).toBe("5 items");
-  });
-
-  test("falls back to `other` when count is missing", () => {
-    expect(resolveTranslationValue(messageCount.en, "en")).toBe("{count} unread messages");
-  });
-
-  test("falls back to `other` when count is not a finite number", () => {
-    expect(resolveTranslationValue(messageCount.en, "en", { count: "many" })).toBe(
-      "many unread messages",
-    );
-    // count is present (interpolated verbatim) but non-finite, so the plural
-    // category still falls back to `other`.
-    expect(resolveTranslationValue(messageCount.en, "en", { count: Number.NaN })).toBe(
-      "NaN unread messages",
-    );
-  });
-
-  test("an invalid locale tag falls back to `other` without throwing", () => {
-    expect(() =>
-      resolveTranslationValue(messageCount.en, "not-a-locale-!!", { count: 1 }),
-    ).not.toThrow();
-    expect(resolveTranslationValue(messageCount.en, "not-a-locale-!!", { count: 1 })).toBe(
-      "1 unread messages",
-    );
-  });
-});
-
-describe("translationValueOtherText", () => {
-  test("returns a plain string as-is", () => {
-    expect(translationValueOtherText("Welcome")).toBe("Welcome");
-  });
-
-  test("returns the `other` form for a plural entry", () => {
-    expect(translationValueOtherText(messageCount.en)).toBe("{count} unread messages");
-  });
-});

package/src/ui-types/app-schema.ts

@@ -1,91 +0,0 @@
-// Client-safe Schema-Types. Wohnen in framework/ui-types statt renderer
-// damit der Server (createKumikoServer / buildAppSchema) sie produzieren
-// kann ohne renderer als Dependency zu ziehen. Renderer + Renderer-Web
-// re-exporten dieselben Symbole — Konsumenten merken den Umzug nicht.
-//
-// Pattern: Types fließen "downstream" (framework → renderer → renderer-
-// web), Runtime-Helpers (toAppSchema, isAppSchema) bleiben renderer-side
-// weil das die Layer ist die mit den AppSchemas zur Laufzeit arbeitet.
-
-import type { TranslationKeys } from "../engine/types/config";
-import type { EntityDefinition } from "../engine/types/fields";
-import type { ContentCollectionDefinition, NavDefinition } from "../engine/types/nav";
-import type { ScreenDefinition } from "../engine/types/screen";
-import type { WorkspaceDefinition } from "../engine/types/workspace";
-
-export type FeatureSchema = {
-  readonly featureName: string;
-  readonly entities: Readonly<Record<string, EntityDefinition>>;
-  readonly screens: readonly ScreenDefinition[];
-  // Flat list; resolveNavigation builds the tree at render-time from
-  // the registry's indexes. Omitted when the app has no top-level nav.
-  readonly navs?: readonly NavDefinition[];
-  // Content collections declared via r.contentCollection(), each with its nav
-  // QN already qualified. The matching nav entries are in `navs` like any
-  // other; this list only carries what a NavDefinition can't express — which
-  // template-resource `kind` the node lists — so the client can build one
-  // tree provider per collection. Omitted when a feature declares none.
-  readonly contentCollections?: readonly QualifiedContentCollection[];
-  // Server-authored `r.translations({ keys })`, projected verbatim — byte-
-  // identical keys, NOT re-prefixed with featureName (unlike the registry's
-  // internal mergedTranslations, which double-prefixes features that
-  // already qualify their own keys — see registry-ingest.ts populate
-  // Translations). Nav/screen labels resolve these keys directly via
-  // `t(label)`, so shipping anything other than the raw authored string
-  // would break the lookup. Omitted when a feature declares none. #1059:
-  // without this, nav labels only resolved when an app ALSO duplicated the
-  // key in `web/i18n.ts` — most bundled features never did, so labels
-  // rendered as raw i18n keys in the shell.
-  readonly translations?: TranslationKeys;
-  // Workspaces — Legacy-Slot für single-feature-Apps. Bevorzugt liegt
-  // workspaces auf der AppSchema-Ebene weil ihre navMembers regelmäßig
-  // Cross-Feature-Navs referenzieren (siehe AppSchema-Doc). Hier als
-  // Fallback erhalten damit alte clientSchema-Files (vor AppSchema)
-  // ohne Migration weiter laufen — toAppSchema() hebt die Liste hoch.
-  readonly workspaces?: readonly WorkspaceSchema[];
-  // True only when the server confirmed at boot that no SearchAdapter is
-  // wired on context.searchAdapter — mirrors the global (not per-entity)
-  // check behind api/server.ts's boot warning (#2051). Duplicated
-  // identically across every feature purely so it threads through the
-  // existing per-feature prop chain into screen renderers (kumiko-screen.tsx)
-  // without a separate app-level plumbing path. Omitted for schemas that
-  // don't flow through buildAppSchema() (hand-authored fixtures, legacy
-  // toAppSchema()) — treated as "not missing" so search bars keep rendering
-  // exactly as before this flag existed (#2062).
-  readonly searchAdapterMissing?: boolean;
-};
-
-// A content collection as it reaches the client: the declaration plus the
-// already-qualified nav QN, so consumers don't rebuild "<feature>:nav:<id>".
-export type QualifiedContentCollection = ContentCollectionDefinition & {
-  readonly navQn: string;
-};
-
-// Per-workspace projection of the engine's WorkspaceDefinition + the
-// pre-resolved member nav QNs. The shell renders the switcher from
-// `definition` and filters the nav tree using `navMembers`.
-export type WorkspaceSchema = {
-  readonly definition: WorkspaceDefinition;
-  // Nav QNs that belong to this workspace, in the order the engine
-  // resolved them (explicit r.workspace.nav first, then nav-self-assigned
-  // entries — deduped). Empty when no nav has been assigned.
-  readonly navMembers: readonly string[];
-};
-
-// App-level schema. Bündelt ein oder mehrere FeatureSchemas + die App-
-// weiten Workspaces. Sinn der Trennung: Workspaces aggregieren über
-// Feature-Grenzen (admin-Workspace zeigt navs aus mehreren Features), und
-// die navMembers-Liste enthält voll qualifizierte QNs die der Browser
-// gegen die jeweilige feature-spezifische `navs`-Liste auflöst.
-//
-// Backwards-Compat: createKumikoApp + die Layouts (DefaultAppShell,
-// WorkspaceShell) akzeptieren beides — `FeatureSchema` (single-feature,
-// historisch) und `AppSchema` (multi-feature). Ein `toAppSchema(input)`-
-// Adapter normalisiert intern, sodass die ganze inneren Renderer-Pipeline
-// nur noch AppSchema kennt.
-export type AppSchema = {
-  readonly features: readonly FeatureSchema[];
-  // Optional — Apps ohne Workspaces nutzen DefaultAppShell und sehen
-  // schlicht die NavTree aller Features.
-  readonly workspaces?: readonly WorkspaceSchema[];
-};

package/src/ui-types/formality.ts

@@ -1,7 +0,0 @@
-export type Formality = "formal" | "informal";
-
-// BCP-47 private-use subtag: a translation bundle keyed "de-x-formal" holds the
-// formal ("Sie") wording and only needs the keys that differ from plain "de".
-export function formalLocaleTag<Locale extends string>(locale: Locale): `${Locale}-x-formal` {
-  return `${locale}-x-formal`;
-}

package/src/ui-types/index.ts

@@ -1,159 +0,0 @@
-// @runtime client
-//
-// Client-safe subset of engine types + the two normalize helpers. Split
-// out into its own subpath (`@cosmicdrift/kumiko-framework/ui-types`) so ui-core and
-// renderer packages can import without pulling node-only framework
-// internals (postgres, drizzle-kit, ioredis, bullmq, ...) into the
-// browser or Expo bundle through the main `./engine` barrel.
-//
-// The main `./engine` barrel re-exports `createApp`, `defineFeature`,
-// and other server-runtime factories. Even with `import type` on the
-// consumer side, some bundlers pull evaluation of the barrel, which
-// transitively reaches `pg` / `ioredis` / `tls`. This entry stays narrow:
-// types + the two pure-fn normalize helpers. No runtime imports of node
-// built-ins or of framework DB / pipeline modules.
-//
-// The `type` re-exports below still chain into files that contain
-// runtime code (fields.ts → ownership.ts → drizzle-orm; handlers.ts →
-// ioredis etc.). With `verbatimModuleSyntax: true` and `import type` on
-// every hop the bundler strips those; this file reaches only type-space.
-// When adding a symbol here, verify it's either a type or a pure
-// helper with no cross-module side-effects.
-
-export { NO_WIDGET_FIELD_TYPES } from "@cosmicdrift/kumiko-types/fields";
-export type { DerivedCellRoundingTarget } from "../engine/embedded-derived";
-export { computeDerivedCellValue, roundDerivedCellValue } from "../engine/embedded-derived";
-export type { ParsedRefTarget } from "../engine/parse-ref-target";
-export { parseRefTarget } from "../engine/parse-ref-target";
-export type { FieldsOrGroupsSection } from "../engine/screen-helpers";
-export {
-  evalFieldCondition,
-  explicitListScreenId,
-  isExtensionEditSection,
-  isFieldsEditSection,
-  isFormatSpec,
-  isWriteFormEditSection,
-  normalizeEditField,
-  normalizeListColumn,
-  resolveNavParentScreen,
-  sectionFieldSpecs,
-} from "../engine/screen-helpers";
-// Entity + field types. EntityDefinition is the canonical shape that
-// view-model builders iterate; FieldDefinition is the per-field union
-// (text, number, boolean, ...) they branch on. AccessRule is used by
-// resolveNavigation to gate entries by user roles.
-export type {
-  BooleanFieldDef,
-  DateFieldDef,
-  EmbeddedDerivedCellDef,
-  EntityDefinition,
-  FieldDefinition,
-  FileFieldDef,
-  FilesFieldDef,
-  ImageFieldDef,
-  ImagesFieldDef,
-  NumberFieldDef,
-  SelectFieldDef,
-  SelectOptionTone,
-  TextFieldDef,
-} from "../engine/types/fields";
-export type {
-  AccessRule,
-  OpenToAllAccessRule,
-  OpenToAllDeclaration,
-  OpenToAllPersonalData,
-  RoleAccessPersonalData,
-  RoleAccessRule,
-} from "../engine/types/handlers";
-export { isOpenToAllGranted, isUiAccessGranted } from "../engine/types/handlers";
-export type { IconKey, NavDefinition, NavIconKey } from "../engine/types/nav";
-export type {
-  ActionFormRedirect,
-  ActionFormScreenDefinition,
-  ConfigEditScreenDefinition,
-  CustomScreenDefinition,
-  CustomScreenRoute,
-  DashboardChartPanel,
-  DashboardCustomPanel,
-  DashboardFeedPanel,
-  DashboardFilterDefinition,
-  DashboardListPanel,
-  DashboardPanelDefinition,
-  DashboardPanelVisibility,
-  DashboardProgressListPanel,
-  DashboardScreenDefinition,
-  DashboardScreenPanel,
-  DashboardStatGroupPanel,
-  DashboardStatPanel,
-  EditExtensionSection,
-  EditFieldSpec,
-  EditFieldsSection,
-  EditLayout,
-  EditRelatedListSection,
-  EditSectionSpec,
-  EditWriteFormSection,
-  EntityEditScreenDefinition,
-  EntityListScreenDefinition,
-  FieldCondition,
-  FieldIconKey,
-  FieldRenderer,
-  FormWidth,
-  ListColumnSpec,
-  ListFacetSpec,
-  ListSortSpec,
-  MetricNavigate,
-  MetricSpec,
-  PlatformComponent,
-  ProjectionDetailScreenDefinition,
-  ProjectionListScreenDefinition,
-  RelatedListToolbarAction,
-  RowAction,
-  RowActionDrawer,
-  RowActionNavigate,
-  RowActionWriteHandler,
-  RowFieldExtractor,
-  ScreenDefinition,
-  ScreenFilter,
-  ScreenFilterOp,
-  ScreenSlots,
-  SecretMintConfirmStep,
-  SecretMintScreenDefinition,
-  SecretReveal,
-  SecretRevealField,
-  SecretsEditScreenDefinition,
-  SecretsEditSection,
-  ToolbarAction,
-} from "../engine/types/screen";
-export { metricField } from "../engine/types/screen";
-export type { TargetRef } from "../engine/types/target-ref";
-export type { TreeAction, TreeNode, TreeNodeState } from "../engine/types/tree-node";
-export type { WorkspaceDefinition } from "../engine/types/workspace";
-export {
-  PROJECTION_DETAIL_ENTITY,
-  WRITE_FORM_SECTION_ENTITY,
-} from "../i18n/required-surface-keys";
-export type {
-  AppSchema,
-  FeatureSchema,
-  QualifiedContentCollection,
-  WorkspaceSchema,
-} from "./app-schema";
-export { type Formality, formalLocaleTag } from "./formality";
-export type {
-  ListRowMetaColumnType,
-  ListRowMetaReference,
-  ReferenceLookupSource,
-  SystemReferenceLabel,
-} from "./list-row-meta";
-export {
-  LIST_ROW_META_COLUMNS,
-  LIST_ROW_META_REFERENCES,
-  REFERENCE_LOOKUP_SOURCES,
-  SYSTEM_REFERENCE_LABELS,
-} from "./list-row-meta";
-export {
-  type PluralForms,
-  resolveTranslationValue,
-  type TranslationValue,
-  translationValueOtherText,
-} from "./plural";

package/src/ui-types/list-row-meta.ts

@@ -1,87 +0,0 @@
-// Base row-meta columns (id/tenantId/version/insertedAt/modifiedAt/
-// insertedById/modifiedById) exist on every entity table without being
-// declared entity fields (see rowMetaFieldNames in db/table-builder.ts).
-// computeListViewModel needs a type + sortable hint per column when a screen
-// picks one of these as a list column (e.g. a SystemAdmin cross-tenant view
-// exposing tenantId). This stays a plain string map instead of importing
-// db/table-builder directly, so headless (client bundle) doesn't pull
-// drizzle in through this type-only subpath. list-row-meta-drift.test.ts
-// guards the key set against drift from rowMetaFieldNames(false).
-//
-// Deliberately excludes the softDelete-only columns (isDeleted/deletedAt/
-// deletedById) — this is also the SAME set the boot-validator's entityList
-// column checks accept, so a softDelete column stays a boot-time error
-// instead of a renderer-side throw (see screens.ts / entity-list-screens.ts).
-import { SYSTEM_TENANT_ID, SYSTEM_USER_ID } from "../engine/types/identifiers";
-
-export type ListRowMetaColumnType = "text" | "number" | "timestamp";
-
-export const LIST_ROW_META_COLUMNS: Readonly<Record<string, ListRowMetaColumnType>> = {
-  id: "text",
-  tenantId: "text",
-  version: "number",
-  insertedAt: "timestamp",
-  modifiedAt: "timestamp",
-  insertedById: "text",
-  modifiedById: "text",
-};
-
-export type ListRowMetaReference = {
-  readonly refFeature: string;
-  readonly refEntity: string;
-  readonly refLabelField: string;
-};
-
-// tenantId would otherwise render the raw GUID; the lookup query is resolved
-// through REFERENCE_LOOKUP_SOURCES (tenant-directory), not the
-// entity-convention `tenant:query:tenant:list`.
-// ponytail: bulk lookup is capped at REFERENCE_LIST_LOOKUP_LIMIT (200) —
-// above that, rows fall back to the GUID; paginate the lookup if an install
-// ever exceeds it.
-export const LIST_ROW_META_REFERENCES: Readonly<Record<string, ListRowMetaReference>> = {
-  tenantId: { refFeature: "tenant", refEntity: "tenant", refLabelField: "name" },
-};
-
-export type ReferenceLookupSource = {
-  readonly queryQn: string;
-  readonly labelKey: string;
-};
-
-// Overrides the `<refFeature>:query:<refEntity>:list` convention the renderer
-// otherwise derives for a reference lookup. Keyed by `${refFeature}:${refEntity}`
-// like SYSTEM_REFERENCE_LABELS, so the override holds for every screen that
-// references the entity instead of each one re-declaring it.
-//
-// user:user — the convention QN is a SystemAdmin cross-tenant roster whose
-// `tenants` join must not reach a TenantAdmin, so it stays SystemAdmin-only and
-// the label lookup goes through the member directory instead: own-tenant
-// members for an admin, every user for a SystemAdmin (fw#3107).
-//
-// tenant:tenant — the convention QN, `tenant:query:tenant:list`, is a
-// SystemAdmin-only entity-list handler, so a TenantAdmin got a 403 and every
-// tenant cell fell back to the raw UUID. The label lookup goes through the
-// tenant directory instead: the caller's own tenant for an admin, every
-// tenant for a SystemAdmin (fw#3142).
-export const REFERENCE_LOOKUP_SOURCES: Readonly<Record<string, ReferenceLookupSource>> = {
-  "user:user": { queryQn: "tenant:query:member-directory", labelKey: "label" },
-  "tenant:tenant": { queryQn: "tenant:query:tenant-directory", labelKey: "label" },
-};
-
-export type SystemReferenceLabel = {
-  readonly id: string;
-  readonly labelKey: string;
-};
-
-// Reference ids that never resolve through the bulk id->row lookup because
-// no row exists for them (e.g. SYSTEM_TENANT_ID has no tenant record, see
-// isSystemTenant()) — every reference column falls back to the raw id
-// otherwise. Keyed by `${refFeature}:${refEntity}` so useReferenceLookup can
-// consult this generically instead of any screen/hook hardcoding an entity
-// name. Central so the label applies to every screen that references this
-// entity, not just delivery-log (fw#2662).
-export const SYSTEM_REFERENCE_LABELS: Readonly<Record<string, SystemReferenceLabel>> = {
-  "tenant:tenant": { id: SYSTEM_TENANT_ID, labelKey: "kumiko.reference.system-tenant" },
-  // createdBy on a system write (fw#3103) — SYSTEM_USER_ID is an alias for
-  // "no human caller", so read_users never holds a matching row.
-  "user:user": { id: SYSTEM_USER_ID, labelKey: "kumiko.reference.system-user" },
-};

package/src/ui-types/plural.ts

@@ -1,69 +0,0 @@
-import type { PluralForms, TranslationValue } from "@cosmicdrift/kumiko-types/config";
-
-export type { PluralForms, TranslationValue } from "@cosmicdrift/kumiko-types/config";
-
-// Hermes on older Expo/React Native builds doesn't ship Intl.PluralRules —
-// fall back to `other` there instead of hand-rolling CLDR plural rules.
-const hasPluralRulesSupport = typeof Intl !== "undefined" && typeof Intl.PluralRules === "function";
-
-// `null` cache entries mark a locale tag Intl.PluralRules rejected, so a bad
-// tag doesn't retry the constructor (and its exception) on every call.
-const pluralRulesCache = new Map<string, Intl.PluralRules | null>();
-
-function pluralRulesFor(locale: string): Intl.PluralRules | null {
-  if (!hasPluralRulesSupport) return null;
-  const cached = pluralRulesCache.get(locale);
-  if (cached !== undefined) return cached;
-  let rules: Intl.PluralRules | null;
-  try {
-    rules = new Intl.PluralRules(locale);
-  } catch {
-    rules = null;
-  }
-  pluralRulesCache.set(locale, rules);
-  return rules;
-}
-
-function isFiniteCount(value: unknown): value is number {
-  return typeof value === "number" && Number.isFinite(value);
-}
-
-function pluralFormText(forms: PluralForms, locale: string, count: unknown): string {
-  if (!isFiniteCount(count)) return forms.other;
-  const rules = pluralRulesFor(locale);
-  if (rules === null) return forms.other;
-  const category = rules.select(count);
-  return forms[category] ?? forms.other;
-}
-
-function interpolate(
-  template: string,
-  params: Readonly<Record<string, unknown>> | undefined,
-): string {
-  if (params === undefined) return template;
-  return template.replace(/\{(\w+)\}/g, (_, name: string) => {
-    const value = params[name];
-    return value !== undefined ? String(value) : `{${name}}`;
-  });
-}
-
-/** Text-only reading of a TranslationValue — the CLDR `other` form for a
- *  plural entry, or the string as-is. For call sites that render a single
- *  string (agent manifests, labels) without a locale/count context. */
-export function translationValueOtherText(value: TranslationValue): string {
-  return typeof value === "string" ? value : value.other;
-}
-
-/** Resolve a TranslationValue to display text: a plural entry picks its CLDR
- *  category via `Intl.PluralRules` from `params.count`, falling back to
- *  `other` when `count` is missing, non-finite, or `locale` is invalid.
- *  `{name}` interpolation then applies to the resolved string — an unknown
- *  placeholder is left as-is. */
-export function resolveTranslationValue(
-  value: TranslationValue,
-  locale: string,
-  params?: Readonly<Record<string, unknown>>,
-): string {
-  const text = typeof value === "string" ? value : pluralFormText(value, locale, params?.["count"]);
-  return interpolate(text, params);
-}