@cosmicdrift/kumiko-types 0.336.0 → 0.337.1

package/dist/feature.d.ts

@@ -39,8 +39,27 @@ export type SecretKeyDefinition = {
     };
     readonly scope: "tenant";
     readonly required?: boolean;
+    readonly writeRoles?: readonly string[];
 };
 export type SecretOptions = Omit<SecretKeyDefinition, "shortName" | "qualifiedName">;
+export type SecretNamespaceDefinition = {
+    readonly shortName: string;
+    readonly qualifiedPrefix: string;
+    readonly label: {
+        readonly [locale: string]: string;
+    };
+    readonly hint?: {
+        readonly [locale: string]: string;
+    };
+    readonly scope: "tenant";
+    readonly writeRoles?: readonly string[];
+    readonly nameSchema?: ZodType<string>;
+};
+export type SecretNamespaceOptions = Omit<SecretNamespaceDefinition, "shortName" | "qualifiedPrefix">;
+export type SecretNamespaceHandle = {
+    readonly prefix: string;
+    keyFor(name: string): string;
+};
 export type SecretKeyHandle = {
     readonly name: string;
 };
@@ -150,6 +169,7 @@ export type FeatureDefinition = {
     readonly handlerEntityMappings: Readonly<Record<string, string>>;
     readonly metrics: Readonly<Record<string, FeatureMetricDef>>;
     readonly secretKeys: Readonly<Record<string, SecretKeyDefinition>>;
+    readonly secretNamespaces: Readonly<Record<string, SecretNamespaceDefinition>>;
     readonly projections: Readonly<Record<string, ProjectionDefinition>>;
     readonly entityProjectionExtensions?: Readonly<Record<string, readonly EntityProjectionExtension[]>>;
     readonly multiStreamProjections: Readonly<Record<string, MultiStreamProjectionDefinition>>;
@@ -409,6 +429,10 @@ export type FeatureRegistrar<TFeature extends string = string> = {
     secret(definition: {
         readonly name: string;
     } & SecretOptions): SecretKeyHandle;
+    secretNamespace(shortName: string, options: SecretNamespaceOptions): SecretNamespaceHandle;
+    secretNamespace(definition: {
+        readonly name: string;
+    } & SecretNamespaceOptions): SecretNamespaceHandle;
     projection(definition: ProjectionDefinition): void;
     multiStreamProjection(definition: MultiStreamProjectionDefinition): void;
     extendEntityProjection(entityName: string, extension: EntityProjectionExtension): void;
@@ -485,6 +509,7 @@ export type Registry = {
     getAllConfigSeeds(): readonly ConfigSeedDef[];
     getAllSecretKeys(): ReadonlyMap<string, SecretKeyDefinition>;
     getSecretKey(qualifiedName: string): SecretKeyDefinition | undefined;
+    findSecretNamespace(key: string): SecretNamespaceDefinition | undefined;
     getJob(qualifiedName: string): JobDefinition | undefined;
     getAllJobs(): ReadonlyMap<string, JobDefinition>;
     getEvent(qualifiedName: string): EventDef | undefined;

package/dist/screen.d.ts

@@ -920,13 +920,17 @@ export type RelatedListGroupBy = {
     readonly collapsedWhen?: string | number | boolean | null;
     /** i18n key of the group header. Placeholders: `{count}` rows in the group,
      *  `{value}` the group's field value, `{lastDate}` the group's latest
-     *  `dateField` value as a locale date. */
-    readonly label: string;
+     *  `dateField` value as a locale date. A group with neither `label` nor an
+     *  entry in `labels` renders its rows without a header and never collapses. */
+    readonly label?: string;
     /** Header i18n key per group value (as string), overriding `label`. */
     readonly labels?: Readonly<Record<string, string>>;
     /** Row field (ISO date or timestamp) behind `{lastDate}`. */
     readonly dateField?: string;
 };
+/** Group key of a field value; `collapsedWhen` and row values both go through it. */
+export declare function relatedListGroupKey(value: unknown): string;
+export declare function relatedListGroupHeaderLabel(groupBy: RelatedListGroupBy, groupKey: string): string | undefined;
 /** Row tint rule: rows where the `FieldCondition` (`{ field, eq }`, `{ field,
  *  in }` …) holds get the tone. `bad` renders red. */
 export type RelatedListRowTone = Exclude<FieldCondition, boolean> & {
@@ -969,7 +973,8 @@ export type EditRelatedListSection = {
     readonly itemNoun?: string;
     readonly pageSize?: number;
     /** Initial sort on mount, applied client-side over the already-loaded rows
-     *  (this section has no pager, so there is no "loaded subset" to mislead).
+     *  (this section has no pager; if the fetch is truncated, `nextCursor !== null`,
+     *  the section shows a hint banner that the sort covers only the loaded rows).
      *  `field` must name a column with `sortable: true` — boot-validator pins
      *  that, same as `entityList.defaultSort`. */
     readonly defaultSort?: ListSortSpec;
@@ -1481,6 +1486,10 @@ export type SecretsEditScreenDefinition = {
     readonly fieldHints?: Readonly<Record<string, string>>;
     /** field ids whose declaration set `required: true`. */
     readonly requiredFields?: readonly string[];
+    /** field id -> write access derived from the key's `writeRoles`. The screen
+     *  hides fields the viewer fails; UI only, the secrets write gate stays
+     *  authoritative. */
+    readonly fieldAccess?: Readonly<Record<string, AccessRule>>;
     readonly sections: readonly SecretsEditSection[];
     readonly access?: AccessRule;
 };

package/dist/screen.js

@@ -1,3 +1,11 @@
 export function metricField(metric) {
     return typeof metric === "string" ? metric : metric.field;
 }
+/** Group key of a field value; `collapsedWhen` and row values both go through it. */
+export function relatedListGroupKey(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+export function relatedListGroupHeaderLabel(groupBy, groupKey) {
+    const labels = groupBy.labels;
+    return labels !== undefined && Object.hasOwn(labels, groupKey) ? labels[groupKey] : groupBy.label;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.336.0",
+  "version": "0.337.1",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/changes.json

@@ -1,4 +1,11 @@
 [
+  {
+    "version": "0.337.0",
+    "type": "improvement",
+    "title": "relatedList groupBy.label is optional; groups without a header show their rows directly",
+    "detail": "`RelatedListGroupBy.label` is optional. The header key of a group is `labels[value] ?? label`; a group without one renders its rows without a header row and never collapses. `relatedListGroupKey` and `relatedListGroupHeaderLabel` resolve the group key and its header key; `collapsedWhen: null` now matches rows whose field is empty.",
+    "migration": "No code change needed. To hide a header, drop `label` and name only the groups that keep one in `labels`, for example `{ field: \"status\", collapsedWhen: \"done\", labels: { done: \"<key>\" } }`."
+  },
   {
     "version": "0.336.0",
     "type": "improvement",