@gzl10/nexus-sdk 0.16.8 → 0.18.0

package/dist/{chunk-E7K3RKDO.js → chunk-WHLUKKQO.js}

@@ -95,10 +95,10 @@ function useTextField(config) {
     validation,
     meta,
     ...overrides
-  } = config;
+  } = config ?? {};
   const min = minLength ?? (required ? 1 : 0);
   return {
-    label,
+    label: label ?? { en: "Text", es: "Texto" },
     input: "text",
     hint,
     required: required ?? false,
@@ -136,9 +136,9 @@ function useTextUniqueField(config) {
 
 // src/fields/color.ts
 function useColorField(config) {
-  const { label, hint, defaultValue, placeholder, required, nullable, meta, ...overrides } = config;
+  const { label, hint, defaultValue, placeholder, required, nullable, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Color", es: "Color" },
     input: "color",
     hint,
     required: required ?? false,
@@ -188,9 +188,9 @@ function useImageField(config) {
     nullable,
     meta,
     ...overrides
-  } = config;
+  } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Image", es: "Imagen" },
     input: "image",
     hint,
     required: required ?? false,
@@ -224,9 +224,9 @@ function useFileField(config) {
     nullable,
     meta,
     ...overrides
-  } = config;
+  } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "File", es: "Archivo" },
     input: "file",
     hint,
     required: required ?? false,
@@ -262,9 +262,9 @@ function useMultiImageField(config) {
     nullable,
     meta,
     ...overrides
-  } = config;
+  } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Images", es: "Im\xE1genes" },
     input: "multiimage",
     hint,
     required: required ?? false,
@@ -301,9 +301,9 @@ function useMultiFileField(config) {
     nullable,
     meta,
     ...overrides
-  } = config;
+  } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Files", es: "Archivos" },
     input: "multifile",
     hint,
     required: required ?? false,
@@ -339,9 +339,9 @@ function useUrlField(config) {
     placeholder,
     meta,
     ...overrides
-  } = config;
+  } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "URL", es: "URL" },
     input: "url",
     hint,
     required: required ?? false,
@@ -372,7 +372,7 @@ function createStaticSelect(config) {
     (opt) => typeof opt === "string" ? { value: opt, label: opt } : opt
   );
   return {
-    label,
+    label: label ?? { en: "Select", es: "Selecci\xF3n" },
     input: "select",
     hint,
     required: required ?? false,
@@ -412,7 +412,7 @@ function createRelationSelect(config) {
     ...overrides
   } = config;
   return {
-    label,
+    label: label ?? { en: "Select", es: "Selecci\xF3n" },
     input: "select",
     hint,
     required: required ?? false,
@@ -453,7 +453,7 @@ function createMasterSelect(config) {
     ...overrides
   } = config;
   return {
-    label,
+    label: label ?? { en: "Select", es: "Selecci\xF3n" },
     input: "select",
     defaultValue,
     hint,
@@ -487,9 +487,9 @@ function useSelectField(config) {
 
 // src/fields/textarea.ts
 function useTextareaField(config) {
-  const { label, hint, required, nullable, defaultValue, placeholder, meta, ...overrides } = config;
+  const { label, hint, required, nullable, defaultValue, placeholder, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Text", es: "Texto" },
     input: "textarea",
     hint,
     required: required ?? false,
@@ -509,9 +509,9 @@ function useTextareaField(config) {
 
 // src/fields/code.ts
 function useCodeField(config) {
-  const { label, hint, required, nullable, defaultValue, language, placeholder, meta, ...overrides } = config;
+  const { label, hint, required, nullable, defaultValue, language, placeholder, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Code", es: "C\xF3digo" },
     input: "code",
     hint,
     required: required ?? false,
@@ -529,9 +529,9 @@ function useCodeField(config) {
 
 // src/fields/json.ts
 function useJsonField(config) {
-  const { label, hint, required, nullable, meta, ...overrides } = config;
+  const { label, hint, required, nullable, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Data", es: "Datos" },
     input: "json",
     hint,
     required: required ?? false,
@@ -549,9 +549,9 @@ function useJsonField(config) {
 
 // src/fields/datetime.ts
 function useDatetimeField(config) {
-  const { label, hint, required, nullable, meta, ...overrides } = config;
+  const { label, hint, required, nullable, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Date", es: "Fecha" },
     input: "datetime",
     hint,
     required: required ?? false,
@@ -568,9 +568,9 @@ function useDatetimeField(config) {
 
 // src/fields/number.ts
 function useNumberField(config) {
-  const { label, hint, required, defaultValue, nullable, validation, meta, ...overrides } = config;
+  const { label, hint, required, defaultValue, nullable, validation, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Number", es: "N\xFAmero" },
     input: "number",
     hint,
     required: required ?? false,
@@ -591,9 +591,9 @@ function useNumberField(config) {
 
 // src/fields/switch.ts
 function useSwitchField(config) {
-  const { label, hint, defaultValue = false, meta, ...overrides } = config;
+  const { label, hint, defaultValue = false, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Switch", es: "Switch" },
     input: "switch",
     hint,
     defaultValue,
@@ -611,12 +611,13 @@ function useSwitchField(config) {
 
 // src/fields/localized.ts
 function useLocalizedField(config) {
-  const { label, hint, required = true, meta, ...overrides } = config;
+  const { label, hint, required = true, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Content", es: "Contenido" },
     input: "text",
     hint,
     required,
+    defaultValue: {},
     db: {
       type: "json",
       nullable: !required
@@ -632,9 +633,9 @@ function useLocalizedField(config) {
 
 // src/fields/icon.ts
 function useIconField(config) {
-  const { label, hint, required, size = 100, placeholder, meta, ...overrides } = config;
+  const { label, hint, required, size = 100, placeholder, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Icon", es: "Icono" },
     input: "icon",
     hint,
     required: required ?? false,
@@ -653,9 +654,9 @@ function useIconField(config) {
 
 // src/fields/email.ts
 function useEmailField(config) {
-  const { label, hint, required, nullable, unique, placeholder, meta, ...overrides } = config;
+  const { label, hint, required, nullable, unique, placeholder, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Email", es: "Email" },
     input: "email",
     hint,
     required: required ?? false,
@@ -679,9 +680,9 @@ function useEmailField(config) {
 
 // src/fields/checkbox.ts
 function useCheckboxField(config) {
-  const { label, hint, defaultValue = false, meta, ...overrides } = config;
+  const { label, hint, defaultValue = false, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Checkbox", es: "Checkbox" },
     input: "checkbox",
     hint,
     defaultValue,
@@ -697,9 +698,9 @@ function useCheckboxField(config) {
 
 // src/fields/password.ts
 function usePasswordField(config) {
-  const { label, hint, required, nullable, size = 255, placeholder, validation, meta, ...overrides } = config;
+  const { label, hint, required, nullable, size = 255, placeholder, validation, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Password", es: "Contrase\xF1a" },
     input: "password",
     hint,
     required: required ?? false,
@@ -721,9 +722,9 @@ function usePasswordField(config) {
 
 // src/fields/tags.ts
 function useTagsField(config) {
-  const { label, hint, required, nullable, placeholder, validation, options, meta, ...overrides } = config;
+  const { label, hint, required, nullable, placeholder, validation, options, meta, ...overrides } = config ?? {};
   return {
-    label,
+    label: label ?? { en: "Tags", es: "Etiquetas" },
     input: "tags",
     hint,
     required: required ?? false,
@@ -845,7 +846,7 @@ function useEnabledField(config) {
 
 // src/fields/public.ts
 function usePublicField(config) {
-  const { hint, searchable, meta, ...overrides } = config;
+  const { hint, searchable, meta, ...overrides } = config ?? { hint: "" };
   return {
     label: { en: "Public", es: "P\xFAblico" },
     input: "switch",

package/dist/collection/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LocalizedString, b as FieldDefinition } from '../field-KvvQ9oHe.js';
-import { s as RolePermission, d as CollectionEntityDefinition, f as DagEntityDefinition, e as EventEntityDefinition } from '../entity-Bwf8yboo.js';
+import { L as LocalizedString, b as FieldDefinition } from '../field-Bs1fIux8.js';
+import { d as CollectionEntityDefinition, f as DagEntityDefinition, e as EventEntityDefinition, aK as RolePermission } from '../entity-B5WrLI1H.js';
 import 'knex';
 import 'express';
 import 'pino';

package/dist/collection/index.js

@@ -17,7 +17,7 @@ import {
   useTextareaField,
   useUrlField,
   userIdField
-} from "../chunk-E7K3RKDO.js";
+} from "../chunk-WHLUKKQO.js";
 
 // src/collection/helpers.ts
 var polymorphicCaslPermissions = {

package/dist/{entity-Bwf8yboo.d.ts → entity-B5WrLI1H.d.ts}

@@ -1,6 +1,6 @@
 import { Knex } from 'knex';
 import { Request, Router, RequestHandler, Response } from 'express';
-import { L as LocalizedString, b as FieldDefinition, E as EntityIndex, F as FieldCondition } from './field-KvvQ9oHe.js';
+import { L as LocalizedString, b as FieldDefinition, j as LocaleConfig, E as EntityIndex, F as FieldCondition } from './field-Bs1fIux8.js';
 import { Logger } from 'pino';
 
 /**
@@ -1106,6 +1106,8 @@ interface PluginManifest {
     icon?: string;
     /** Absolute path to plugin image file. Auto-detected from image.png if present. */
     image?: string;
+    /** LLM-oriented documentation. Auto-detected from llms.txt if present. */
+    llms?: string;
     /** Category for sidebar grouping */
     category: Category;
     /** Plugin version following SemVer */
@@ -1383,6 +1385,8 @@ interface DbContext {
     getPagination: (query?: EntityQuery) => PaginationParamsWithOffset;
     buildPaginatedResult: <T>(items: T[], total: number, pagination: PaginationParamsWithOffset) => PaginatedResult<T>;
     getKnex: (adapter?: string) => Knex;
+    /** Run full seed for a module (manifest seed + entity auto-seed). Injected from db layer. */
+    seedModule: (mod: ModuleManifest) => Promise<boolean>;
 }
 /**
  * Runtime namespace.
@@ -1473,6 +1477,8 @@ interface ModuleContext {
     /** Semantic event API for cross-module communication (notify/query/command). */
     events: ContextEvents;
     createRouter: () => Router;
+    /** Supported locales for the platform */
+    locales: LocaleConfig[];
 }
 /**
  * HTTP method for custom routes
@@ -1517,6 +1523,86 @@ interface CustomRouteDefinition {
     operationId?: string;
     tags?: string[];
 }
+/**
+ * Seed context passed to onSeed hook.
+ * Provides typed helpers for seeding data without direct DB access.
+ *
+ * Note: masters.register() is lazy (data flushed after onSeed completes).
+ * All other methods (roles.add, users.add, plugin().entity().upsert, raw) are eager.
+ */
+interface SeedContext {
+    /** Register master reference data. Lazy: flushed after onSeed completes. */
+    masters: {
+        register(type: string, entries: Array<{
+            code: string;
+            label: string | {
+                en?: string;
+                es?: string;
+                [key: string]: string | undefined;
+            };
+            order?: number;
+            is_active?: boolean;
+            metadata?: Record<string, unknown>;
+        }>, options?: {
+            seed?: 'if-empty' | 'always';
+        }): void;
+    };
+    /**
+     * Add roles to the system. Eager: inserts immediately. Idempotent by name.
+     *
+     * Optional `permissions` map assigns CASL abilities to the role.
+     * Keys are subject names (case-insensitive: 'masters' = 'Masters').
+     * Values are action arrays.
+     *
+     * Core subjects: Masters, Users, Roles, Auth, Mail, Storage, System.
+     * Plugin subjects: documented in each plugin's llms.txt.
+     *
+     * @example
+     * ```typescript
+     * await seed.roles.add({
+     *   name: 'SALES',
+     *   description: { en: 'Sales team' },
+     *   permissions: {
+     *     'masters': ['read'],
+     *     'contacts': ['read', 'create', 'update'],
+     *   }
+     * })
+     * ```
+     */
+    roles: {
+        add(role: {
+            name: string;
+            description?: string | {
+                en?: string;
+                es?: string;
+                [key: string]: string | undefined;
+            };
+            is_system?: boolean;
+            /** CASL permissions. Keys: subject (case-insensitive). Values: action arrays. */
+            permissions?: Record<string, Array<'read' | 'create' | 'update' | 'delete' | 'manage' | 'execute'>>;
+        }): Promise<void>;
+    };
+    /** Add users to the system. Eager: inserts immediately. Idempotent by email. */
+    users: {
+        add(user: {
+            email: string;
+            password: string;
+            name?: string;
+            type?: 'human' | 'bot' | 'service';
+            roles?: string[];
+        }): Promise<void>;
+    };
+    /** Access plugin entities for seeding. Resolves table prefix automatically. */
+    plugin(name: string): {
+        entity(name: string): {
+            upsert(data: Record<string, unknown>[], options?: {
+                key?: string;
+            }): Promise<number>;
+        };
+    };
+    /** Raw table insert (escape hatch). Returns number of rows inserted. */
+    raw(table: string, data: Record<string, unknown> | Record<string, unknown>[]): Promise<number>;
+}
 
 /**
  * Entity definition types - discriminated union for all entity types
@@ -1691,10 +1777,16 @@ interface BaseEntityDefinition {
     order?: number;
     /** UI display mode */
     displayMode?: DisplayMode;
+    /** Restrict available display modes. If omitted, auto-detected from entity config. */
+    availableDisplayModes?: DisplayMode[];
     /** Field name to group by in board/list/masonry displays */
     groupBy?: string;
     /** Field name for secondary grouping (collapsible) */
     subgroupBy?: string;
+    /** Explicit list of fields eligible for grouping. If omitted, auto-detected from field input types. */
+    groupableFields?: string[];
+    /** Subset of groupableFields where drag between board columns is allowed. Default: all groupable. */
+    columnDragFields?: string[];
     /** Date field for calendar start (enables calendar display) */
     calendarFrom?: string;
     /** Date field for calendar end (range display) */
@@ -1706,6 +1798,8 @@ interface BaseEntityDefinition {
     };
     /** If true, hides from UI sidebar */
     hidden?: boolean;
+    /** If false, HTTP routes are not mounted and entity is excluded from frontend DTO. Service, hooks, and CASL still work. Default: true */
+    expose?: boolean;
     /** Middleware applied to all routes */
     middleware?: (ctx: ModuleContext) => RequestHandler | RequestHandler[];
     /** External adapter name for this entity's data source */
@@ -1719,7 +1813,7 @@ interface BaseEntityDefinition {
  * Public type exposing the common properties shared by all entity definition types.
  * Use this when writing generic code that works with any entity definition.
  */
-type SharedEntityProperties = Pick<BaseEntityDefinition, 'table' | 'label' | 'labelPlural' | 'icon' | 'fields' | 'casl' | 'public' | 'routePrefix' | 'order' | 'displayMode' | 'groupBy' | 'subgroupBy' | 'calendarFrom' | 'calendarTo' | 'defaultSort' | 'hidden' | 'middleware' | 'adapter' | 'hooks' | 'realtime'>;
+type SharedEntityProperties = Pick<BaseEntityDefinition, 'table' | 'label' | 'labelPlural' | 'icon' | 'fields' | 'casl' | 'public' | 'routePrefix' | 'order' | 'displayMode' | 'groupBy' | 'subgroupBy' | 'calendarFrom' | 'calendarTo' | 'defaultSort' | 'hidden' | 'expose' | 'middleware' | 'adapter' | 'hooks' | 'realtime'>;
 /**
  * Collection entity - the most common entity type with full CRUD operations.
  */
@@ -1762,7 +1856,7 @@ interface CollectionEntityDefinition extends BaseEntityDefinition {
  * Singleton entity - stores a single record in the shared single_records table.
  * When scopeField is set, operates in scoped mode (multiple records keyed by scope).
  */
-interface SingleEntityDefinition extends Pick<BaseEntityDefinition, 'label' | 'labelPlural' | 'icon' | 'fields' | 'casl' | 'public' | 'routePrefix' | 'order' | 'hidden' | 'hooks' | 'realtime'> {
+interface SingleEntityDefinition extends Pick<BaseEntityDefinition, 'label' | 'labelPlural' | 'icon' | 'fields' | 'casl' | 'public' | 'routePrefix' | 'order' | 'hidden' | 'expose' | 'hooks' | 'realtime'> {
     type: 'single' | 'config';
     /** Unique key in single_records table */
     key: string;
@@ -1905,6 +1999,8 @@ interface ComputedEntityDefinition {
         order: 'asc' | 'desc';
     };
     hidden?: boolean;
+    /** If false, HTTP routes are not mounted and entity is excluded from frontend DTO. Service, hooks, and CASL still work. Default: true */
+    expose?: boolean;
     /** Real-time mode: 'live' pushes recomputed data to subscribed clients */
     realtime?: RealtimeMode;
     /** Auto-refresh interval in ms. Frontend polls data at this rate when the entity tab is active. */
@@ -1929,6 +2025,8 @@ interface ViewEntityDefinition {
     public?: boolean;
     routePrefix?: string;
     order?: number;
+    /** If false, HTTP routes are not mounted and entity is excluded from frontend DTO. Service, hooks, and CASL still work. Default: true */
+    expose?: boolean;
     /** Tables whose changes trigger live push to subscribed clients. Only used when realtime: 'live'. */
     liveOn?: string[];
     /** Real-time mode: 'live' pushes data to subscribed clients when liveOn tables change */
@@ -1951,4 +2049,4 @@ type TempEntityDefinition = Omit<CollectionEntityDefinition, 'type'> & {
  */
 type EntityDefinition = CollectionEntityDefinition | SingleEntityDefinition | ExternalEntityDefinition | VirtualEntityDefinition | ComputedEntityDefinition | ViewEntityDefinition | ReferenceEntityDefinition | TreeEntityDefinition | DagEntityDefinition | EventEntityDefinition;
 
-export { type RetentionPolicy as $, type ActionDefinition as A, type BatchProgressEvent as B, type ConfirmConfig as C, type DisplayMode as D, type EntityType as E, type ForbiddenErrorInstance as F, type EntityQuery as G, type TypedEntityQuery as H, type DatabaseAdapter as I, type SchemaColumnInfo as J, type SchemaColumnBuilder as K, type SchemaTableBuilder as L, type ModuleContext as M, type SchemaForeignKeyBuilder as N, type SchemaAlterTableBuilder as O, type PostActionPipeline as P, type SchemaAdapter as Q, type RealtimeMode as R, type SingleEntityDefinition as S, type TreeEntityDefinition as T, type ModuleRequirements as U, type ViewEntityDefinition as V, type PostAction as W, type ConfirmationType as X, type EntityAction as Y, type SeedConfig as Z, type ReferenceEntityDefinition as _, type Category as a, type AppManifest as a$, type TempRetentionPolicy as a0, type ExternalEntityDefinition as a1, type VirtualEntityDefinition as a2, type ConfigEntityDefinition as a3, type TempEntityDefinition as a4, type SharedEntityProperties as a5, type BaseEntityService as a6, type CollectionEntityService as a7, type TempEntityService as a8, type EventEntityService as a9, type ContextCrypto as aA, type SocketIOServer as aB, type SocketIOBroadcastOperator as aC, type ContextSocket as aD, type ContextEventsHub as aE, type ContextHelpers as aF, type EntityHandler as aG, type EntityController as aH, type CoreContext as aI, type DbContext as aJ, type RuntimeContext as aK, type ConfigContext as aL, type EngineContext as aM, type ServicesContext as aN, type AdaptersContext as aO, type HttpMethod as aP, type RouteParameterDefinition as aQ, type RouteResponseDefinition as aR, type CustomRouteDefinition as aS, type CacheOptions as aT, type CacheStats as aU, type ManagedCache as aV, type ScopedCacheManager as aW, type CacheManagerContract as aX, type CategoryMeta as aY, type ActionInjection as aZ, type ModuleManifest as a_, type SingleEntityService as aa, type ConfigEntityService as ab, type ReferenceEntityService as ac, type ViewEntityService as ad, type ComputedEntityService as ae, type ExternalEntityService as af, type VirtualEntityService as ag, type TreeNode as ah, type TreeEntityService as ai, type DagEntityService as aj, type ActionEntityService as ak, type EntityServiceHooks as al, type CreateEntityServiceOptions as am, type BaseRolesService as an, type BaseUsersService as ao, type SendMailOptions as ap, type SendMailResult as aq, type BaseMailService as ar, type LoggerReporter as as, type CoreServices as at, type ValidationSchema as au, type ValidateSchemas as av, type RateLimitOptions as aw, type ModuleMiddlewares as ax, type EventEmitterLike as ay, type ContextEvents as az, type PageDefinitionDTO as b, type PluginEnvVar as b0, type PluginConfigField as b1, type PluginConfigSchema as b2, type PluginSetupInfo as b3, type PluginManifest as b4, type RegisterPluginOptions as b5, CATEGORIES as b6, CATEGORY_ORDER as b7, type PageType as b8, type WidgetLayout as b9, type WidgetDefinition as ba, type PageDefinition as bb, DEFAULT_TENANT_ID as bc, entityRoom as bd, type EntityChangePayload as be, type EntityRealtimeEvents as bf, type EntityRealtimeEmits as bg, type BridgeTarget as bh, type BridgeRule as bi, type EntityDefinition as c, type CollectionEntityDefinition as d, type EventEntityDefinition as e, type DagEntityDefinition as f, type ComputedEntityDefinition as g, type SSEHelper as h, type SSESender as i, type SSEOptions as j, type BatchLogEntry as k, type BaseAuthRequest as l, type BaseUser as m, type PaginationParams as n, type PaginationParamsWithOffset as o, type PaginatedResult as p, type ValidationDetail as q, type CaslAction as r, type RolePermission as s, type EntityCaslConfig as t, type AbilityLike as u, type ForbiddenErrorConstructor as v, type ModuleAbilities as w, type AuthRequest as x, type FilterOperators as y, type FilterValue as z };
+export { type CreateEntityServiceOptions as $, type ActionDefinition as A, type BaseAuthRequest as B, type ConfirmConfig as C, type DisplayMode as D, type EntityType as E, type CacheStats as F, type CaslAction as G, type CategoryMeta as H, type CollectionEntityService as I, type ComputedEntityService as J, type ConfigContext as K, type ConfigEntityDefinition as L, type ModuleContext as M, type ConfigEntityService as N, type ConfirmationType as O, type PostActionPipeline as P, type ContextCrypto as Q, type RealtimeMode as R, type SingleEntityDefinition as S, type TreeEntityDefinition as T, type ContextEvents as U, type ViewEntityDefinition as V, type ContextEventsHub as W, type ContextHelpers as X, type ContextSocket as Y, type CoreContext as Z, type CoreServices as _, type Category as a, type SendMailResult as a$, type CustomRouteDefinition as a0, DEFAULT_TENANT_ID as a1, type DagEntityService as a2, type DatabaseAdapter as a3, type DbContext as a4, type EngineContext as a5, type EntityAction as a6, type EntityCaslConfig as a7, type EntityChangePayload as a8, type EntityController as a9, type PluginConfigSchema as aA, type PluginEnvVar as aB, type PluginManifest as aC, type PluginSetupInfo as aD, type PostAction as aE, type RateLimitOptions as aF, type ReferenceEntityDefinition as aG, type ReferenceEntityService as aH, type RegisterPluginOptions as aI, type RetentionPolicy as aJ, type RolePermission as aK, type RouteParameterDefinition as aL, type RouteResponseDefinition as aM, type RuntimeContext as aN, type SSEHelper as aO, type SSEOptions as aP, type SSESender as aQ, type SchemaAdapter as aR, type SchemaAlterTableBuilder as aS, type SchemaColumnBuilder as aT, type SchemaColumnInfo as aU, type SchemaForeignKeyBuilder as aV, type SchemaTableBuilder as aW, type ScopedCacheManager as aX, type SeedConfig as aY, type SeedContext as aZ, type SendMailOptions as a_, type EntityHandler as aa, type EntityQuery as ab, type EntityRealtimeEmits as ac, type EntityRealtimeEvents as ad, type EntityServiceHooks as ae, type EventEmitterLike as af, type EventEntityService as ag, type ExternalEntityDefinition as ah, type ExternalEntityService as ai, type FilterOperators as aj, type FilterValue as ak, type ForbiddenErrorConstructor as al, type ForbiddenErrorInstance as am, type HttpMethod as an, type LoggerReporter as ao, type ManagedCache as ap, type ModuleAbilities as aq, type ModuleManifest as ar, type ModuleMiddlewares as as, type ModuleRequirements as at, type PageDefinition as au, type PageType as av, type PaginatedResult as aw, type PaginationParams as ax, type PaginationParamsWithOffset as ay, type PluginConfigField as az, type PageDefinitionDTO as b, type ServicesContext as b0, type SharedEntityProperties as b1, type SingleEntityService as b2, type SocketIOBroadcastOperator as b3, type SocketIOServer as b4, type TempEntityDefinition as b5, type TempEntityService as b6, type TempRetentionPolicy as b7, type TreeEntityService as b8, type TreeNode as b9, type TypedEntityQuery as ba, type ValidateSchemas as bb, type ValidationDetail as bc, type ValidationSchema as bd, type ViewEntityService as be, type VirtualEntityDefinition as bf, type VirtualEntityService as bg, type WidgetDefinition as bh, type WidgetLayout as bi, entityRoom as bj, type ComputedEntityDefinition as c, type CollectionEntityDefinition as d, type EventEntityDefinition as e, type DagEntityDefinition as f, type EntityDefinition as g, type AbilityLike as h, type ActionEntityService as i, type ActionInjection as j, type AdaptersContext as k, type AppManifest as l, type AuthRequest as m, type BaseEntityService as n, type BaseMailService as o, type BaseRolesService as p, type BaseUser as q, type BaseUsersService as r, type BatchLogEntry as s, type BatchProgressEvent as t, type BridgeRule as u, type BridgeTarget as v, CATEGORIES as w, CATEGORY_ORDER as x, type CacheManagerContract as y, type CacheOptions as z };

package/dist/{field-KvvQ9oHe.d.ts → field-Bs1fIux8.d.ts}

@@ -15,6 +15,19 @@
 type LocalizedString = string | ({
     en: string;
 } & Record<string, string>);
+/** Configuration for a supported locale */
+interface LocaleConfig {
+    /** ISO 639-1 code (e.g. 'en', 'es', 'fr') */
+    code: string;
+    /** Human-readable label (e.g. 'English', 'Español') */
+    label: string;
+    /** Is this the fallback locale? Only one should be true. Default: false */
+    fallback?: boolean;
+}
+/** Default supported locales — used when no config is provided */
+declare const DEFAULT_LOCALES: LocaleConfig[];
+/** Get the fallback locale code from a locales array */
+declare function getFallbackLocale(locales: LocaleConfig[]): string;
 /**
  * Auth provider information for dynamic login buttons.
  * Plugins register this info so the UI can render buttons without knowing provider details.
@@ -63,7 +76,7 @@ interface AuthProviderService {
  * @param locale - The target locale (e.g., 'en', 'es')
  * @returns The resolved string for the given locale
  */
-declare function resolveLocalized(value: LocalizedString | undefined, locale: string): string;
+declare function resolveLocalized(value: LocalizedString | undefined, locale: string, fallback?: string): string;
 /**
  * Gets the appropriate label based on count (pluralization).
  * Returns labelPlural for count !== 1, label otherwise.
@@ -375,4 +388,4 @@ declare function refOptions(module: string, entityOrLabel?: string, labelField?:
     labelField: string;
 };
 
-export { type AuthProviderInfo as A, type ConditionalBoolean as C, type DbType as D, type EntityIndex as E, type FieldCondition as F, type InputType as I, type LocalizedString as L, type FieldMeta as a, type FieldDefinition as b, type AuthProviderService as c, type FieldDbConfig as d, type FieldRelation as e, type FieldValidationConfig as f, getCountLabel as g, type FieldOptions as h, type FieldStorageConfig as i, refOptions as j, resolveLocalized as r };
+export { type AuthProviderInfo as A, type ConditionalBoolean as C, DEFAULT_LOCALES as D, type EntityIndex as E, type FieldCondition as F, type InputType as I, type LocalizedString as L, type FieldMeta as a, type FieldDefinition as b, type AuthProviderService as c, type DbType as d, type FieldDbConfig as e, type FieldOptions as f, type FieldRelation as g, type FieldStorageConfig as h, type FieldValidationConfig as i, type LocaleConfig as j, getCountLabel as k, getFallbackLocale as l, resolveLocalized as m, refOptions as r };

package/dist/fields/index.d.ts

@@ -1,4 +1,4 @@
-import { b as FieldDefinition } from '../field-KvvQ9oHe.js';
+import { b as FieldDefinition } from '../field-Bs1fIux8.js';
 import { MasterType } from '../masters/index.js';
 
 /**
@@ -163,7 +163,7 @@ type FieldOverrides = Partial<Pick<FieldDefinition, 'hidden' | 'disabled' | 'inp
  */
 interface TextFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -228,7 +228,7 @@ type TextUniqueFieldConfig = Omit<TextFieldConfig, 'unique' | 'index' | 'require
  * })
  * ```
  */
-declare function useTextField(config: TextFieldConfig & FieldOverrides): FieldDefinition;
+declare function useTextField(config?: TextFieldConfig & FieldOverrides): FieldDefinition;
 /**
  * Create a unique text field (required + unique + index always true).
  *
@@ -247,7 +247,7 @@ declare function useTextField(config: TextFieldConfig & FieldOverrides): FieldDe
  * })
  * ```
  */
-declare function useTextUniqueField(config: TextUniqueFieldConfig): FieldDefinition;
+declare function useTextUniqueField(config?: TextUniqueFieldConfig): FieldDefinition;
 
 /**
  * Color Field Factory
@@ -260,7 +260,7 @@ declare function useTextUniqueField(config: TextUniqueFieldConfig): FieldDefinit
  */
 interface ColorFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -296,7 +296,7 @@ interface ColorFieldConfig {
  * })
  * ```
  */
-declare function useColorField(config: ColorFieldConfig & FieldOverrides): FieldDefinition;
+declare function useColorField(config?: ColorFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Media Field Factories
@@ -322,7 +322,7 @@ declare function parseFileSize(size: FileSize): number;
  */
 interface ImageFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -369,13 +369,13 @@ interface ImageFieldConfig {
  * })
  * ```
  */
-declare function useImageField(config: ImageFieldConfig & FieldOverrides): FieldDefinition;
+declare function useImageField(config?: ImageFieldConfig & FieldOverrides): FieldDefinition;
 /**
  * Configuration for file fields.
  */
 interface FileFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -430,13 +430,13 @@ interface FileFieldConfig {
  * })
  * ```
  */
-declare function useFileField(config: FileFieldConfig & FieldOverrides): FieldDefinition;
+declare function useFileField(config?: FileFieldConfig & FieldOverrides): FieldDefinition;
 /**
  * Configuration for multi-image fields (gallery).
  */
 interface MultiImageFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -490,13 +490,13 @@ interface MultiImageFieldConfig {
  * })
  * ```
  */
-declare function useMultiImageField(config: MultiImageFieldConfig & FieldOverrides): FieldDefinition;
+declare function useMultiImageField(config?: MultiImageFieldConfig & FieldOverrides): FieldDefinition;
 /**
  * Configuration for multi-file fields.
  */
 interface MultiFileFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -546,7 +546,7 @@ interface MultiFileFieldConfig {
  * })
  * ```
  */
-declare function useMultiFileField(config: MultiFileFieldConfig & FieldOverrides): FieldDefinition;
+declare function useMultiFileField(config?: MultiFileFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * URL Field Factory
@@ -559,7 +559,7 @@ declare function useMultiFileField(config: MultiFileFieldConfig & FieldOverrides
  */
 interface UrlFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -601,7 +601,7 @@ interface UrlFieldConfig {
  * })
  * ```
  */
-declare function useUrlField(config: UrlFieldConfig & FieldOverrides): FieldDefinition;
+declare function useUrlField(config?: UrlFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Select Field Factory
@@ -626,7 +626,7 @@ interface SelectOption {
  */
 interface StaticSelectConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -655,7 +655,7 @@ interface StaticSelectConfig {
  */
 interface RelationSelectConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -693,7 +693,7 @@ interface RelationSelectConfig {
  */
 interface MasterSelectConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -798,7 +798,7 @@ declare function useSelectField(config: MasterSelectConfig & FieldOverrides): Fi
  */
 interface TextareaFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -833,7 +833,7 @@ interface TextareaFieldConfig {
  * })
  * ```
  */
-declare function useTextareaField(config: TextareaFieldConfig & FieldOverrides): FieldDefinition;
+declare function useTextareaField(config?: TextareaFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Code Field Factory
@@ -846,7 +846,7 @@ declare function useTextareaField(config: TextareaFieldConfig & FieldOverrides):
  */
 interface CodeFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -885,7 +885,7 @@ interface CodeFieldConfig {
  * })
  * ```
  */
-declare function useCodeField(config: CodeFieldConfig & FieldOverrides): FieldDefinition;
+declare function useCodeField(config?: CodeFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * JSON Field Factory
@@ -898,7 +898,7 @@ declare function useCodeField(config: CodeFieldConfig & FieldOverrides): FieldDe
  */
 interface JsonFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -929,7 +929,7 @@ interface JsonFieldConfig {
  * })
  * ```
  */
-declare function useJsonField(config: JsonFieldConfig & FieldOverrides): FieldDefinition;
+declare function useJsonField(config?: JsonFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Datetime Field Factory
@@ -942,7 +942,7 @@ declare function useJsonField(config: JsonFieldConfig & FieldOverrides): FieldDe
  */
 interface DatetimeFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -974,7 +974,7 @@ interface DatetimeFieldConfig {
  * })
  * ```
  */
-declare function useDatetimeField(config: DatetimeFieldConfig & FieldOverrides): FieldDefinition;
+declare function useDatetimeField(config?: DatetimeFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Number Field Factory
@@ -987,7 +987,7 @@ declare function useDatetimeField(config: DatetimeFieldConfig & FieldOverrides):
  */
 interface NumberFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1028,7 +1028,7 @@ interface NumberFieldConfig {
  * })
  * ```
  */
-declare function useNumberField(config: NumberFieldConfig & FieldOverrides): FieldDefinition;
+declare function useNumberField(config?: NumberFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Switch Field Factory
@@ -1041,7 +1041,7 @@ declare function useNumberField(config: NumberFieldConfig & FieldOverrides): Fie
  */
 interface SwitchFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1071,7 +1071,7 @@ interface SwitchFieldConfig {
  * })
  * ```
  */
-declare function useSwitchField(config: SwitchFieldConfig & FieldOverrides): FieldDefinition;
+declare function useSwitchField(config?: SwitchFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Localized Field Factory
@@ -1085,7 +1085,7 @@ declare function useSwitchField(config: SwitchFieldConfig & FieldOverrides): Fie
  */
 interface LocalizedFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1119,7 +1119,7 @@ interface LocalizedFieldConfig {
  * })
  * ```
  */
-declare function useLocalizedField(config: LocalizedFieldConfig & FieldOverrides): FieldDefinition;
+declare function useLocalizedField(config?: LocalizedFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Icon Field Factory
@@ -1132,7 +1132,7 @@ declare function useLocalizedField(config: LocalizedFieldConfig & FieldOverrides
  */
 interface IconFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1167,7 +1167,7 @@ interface IconFieldConfig {
  * })
  * ```
  */
-declare function useIconField(config: IconFieldConfig & FieldOverrides): FieldDefinition;
+declare function useIconField(config?: IconFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Email Field Factory
@@ -1180,7 +1180,7 @@ declare function useIconField(config: IconFieldConfig & FieldOverrides): FieldDe
  */
 interface EmailFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1220,7 +1220,7 @@ interface EmailFieldConfig {
  * })
  * ```
  */
-declare function useEmailField(config: EmailFieldConfig & FieldOverrides): FieldDefinition;
+declare function useEmailField(config?: EmailFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Checkbox Field Factory
@@ -1233,7 +1233,7 @@ declare function useEmailField(config: EmailFieldConfig & FieldOverrides): Field
  */
 interface CheckboxFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1263,7 +1263,7 @@ interface CheckboxFieldConfig {
  * })
  * ```
  */
-declare function useCheckboxField(config: CheckboxFieldConfig & FieldOverrides): FieldDefinition;
+declare function useCheckboxField(config?: CheckboxFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Password Field Factory
@@ -1276,7 +1276,7 @@ declare function useCheckboxField(config: CheckboxFieldConfig & FieldOverrides):
  */
 interface PasswordFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1321,7 +1321,7 @@ interface PasswordFieldConfig {
  * })
  * ```
  */
-declare function usePasswordField(config: PasswordFieldConfig & FieldOverrides): FieldDefinition;
+declare function usePasswordField(config?: PasswordFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Tags Field Factory
@@ -1334,7 +1334,7 @@ declare function usePasswordField(config: PasswordFieldConfig & FieldOverrides):
  */
 interface TagsFieldConfig {
     /** Field label (localized) */
-    label: string | {
+    label?: string | {
         en: string;
         es?: string;
     };
@@ -1376,7 +1376,7 @@ interface TagsFieldConfig {
  * })
  * ```
  */
-declare function useTagsField(config: TagsFieldConfig & FieldOverrides): FieldDefinition;
+declare function useTagsField(config?: TagsFieldConfig & FieldOverrides): FieldDefinition;
 
 /**
  * Name Field Factory
@@ -1554,7 +1554,7 @@ interface PublicFieldConfig extends FieldOverrides {
  * })
  * ```
  */
-declare function usePublicField(config: PublicFieldConfig): FieldDefinition;
+declare function usePublicField(config?: PublicFieldConfig): FieldDefinition;
 
 /**
  * Expires At Field Factory

package/dist/fields/index.js

@@ -35,7 +35,7 @@ import {
   useTextareaField,
   useUrlField,
   userIdField
-} from "../chunk-E7K3RKDO.js";
+} from "../chunk-WHLUKKQO.js";
 export {
   auditFields,
   idField,

package/dist/index.d.ts

@@ -2,10 +2,10 @@ import { Knex } from 'knex';
 export { Knex } from 'knex';
 import { Request, Response } from 'express';
 export { CookieOptions, NextFunction, Request, RequestHandler, Response, Router } from 'express';
-import { C as ConfirmConfig, P as PostActionPipeline, E as EntityType, D as DisplayMode, R as RealtimeMode, a as Category, b as PageDefinitionDTO, c as EntityDefinition, d as CollectionEntityDefinition, e as EventEntityDefinition, V as ViewEntityDefinition, T as TreeEntityDefinition, f as DagEntityDefinition, S as SingleEntityDefinition, g as ComputedEntityDefinition, A as ActionDefinition, M as ModuleContext } from './entity-Bwf8yboo.js';
-export { u as AbilityLike, ak as ActionEntityService, aZ as ActionInjection, aO as AdaptersContext, a$ as AppManifest, x as AuthRequest, l as BaseAuthRequest, a6 as BaseEntityService, ar as BaseMailService, an as BaseRolesService, m as BaseUser, ao as BaseUsersService, k as BatchLogEntry, B as BatchProgressEvent, bi as BridgeRule, bh as BridgeTarget, b6 as CATEGORIES, b7 as CATEGORY_ORDER, aX as CacheManagerContract, aT as CacheOptions, aU as CacheStats, r as CaslAction, aY as CategoryMeta, a7 as CollectionEntityService, ae as ComputedEntityService, aL as ConfigContext, a3 as ConfigEntityDefinition, ab as ConfigEntityService, X as ConfirmationType, aA as ContextCrypto, az as ContextEvents, aE as ContextEventsHub, aF as ContextHelpers, aD as ContextSocket, aI as CoreContext, at as CoreServices, am as CreateEntityServiceOptions, aS as CustomRouteDefinition, bc as DEFAULT_TENANT_ID, aj as DagEntityService, I as DatabaseAdapter, aJ as DbContext, aM as EngineContext, Y as EntityAction, t as EntityCaslConfig, be as EntityChangePayload, aH as EntityController, aG as EntityHandler, G as EntityQuery, bg as EntityRealtimeEmits, bf as EntityRealtimeEvents, al as EntityServiceHooks, ay as EventEmitterLike, a9 as EventEntityService, a1 as ExternalEntityDefinition, af as ExternalEntityService, y as FilterOperators, z as FilterValue, v as ForbiddenErrorConstructor, F as ForbiddenErrorInstance, aP as HttpMethod, as as LoggerReporter, aV as ManagedCache, w as ModuleAbilities, a_ as ModuleManifest, ax as ModuleMiddlewares, U as ModuleRequirements, bb as PageDefinition, b8 as PageType, p as PaginatedResult, n as PaginationParams, o as PaginationParamsWithOffset, b1 as PluginConfigField, b2 as PluginConfigSchema, b0 as PluginEnvVar, b4 as PluginManifest, b3 as PluginSetupInfo, W as PostAction, aw as RateLimitOptions, _ as ReferenceEntityDefinition, ac as ReferenceEntityService, b5 as RegisterPluginOptions, $ as RetentionPolicy, s as RolePermission, aQ as RouteParameterDefinition, aR as RouteResponseDefinition, aK as RuntimeContext, h as SSEHelper, j as SSEOptions, i as SSESender, Q as SchemaAdapter, O as SchemaAlterTableBuilder, K as SchemaColumnBuilder, J as SchemaColumnInfo, N as SchemaForeignKeyBuilder, L as SchemaTableBuilder, aW as ScopedCacheManager, Z as SeedConfig, ap as SendMailOptions, aq as SendMailResult, aN as ServicesContext, a5 as SharedEntityProperties, aa as SingleEntityService, aC as SocketIOBroadcastOperator, aB as SocketIOServer, a4 as TempEntityDefinition, a8 as TempEntityService, a0 as TempRetentionPolicy, ai as TreeEntityService, ah as TreeNode, H as TypedEntityQuery, av as ValidateSchemas, q as ValidationDetail, au as ValidationSchema, ad as ViewEntityService, a2 as VirtualEntityDefinition, ag as VirtualEntityService, ba as WidgetDefinition, b9 as WidgetLayout, bd as entityRoom } from './entity-Bwf8yboo.js';
-import { L as LocalizedString, I as InputType, F as FieldCondition, a as FieldMeta, b as FieldDefinition } from './field-KvvQ9oHe.js';
-export { A as AuthProviderInfo, c as AuthProviderService, C as ConditionalBoolean, D as DbType, E as EntityIndex, d as FieldDbConfig, h as FieldOptions, e as FieldRelation, i as FieldStorageConfig, f as FieldValidationConfig, g as getCountLabel, j as refOptions, r as resolveLocalized } from './field-KvvQ9oHe.js';
+import { C as ConfirmConfig, P as PostActionPipeline, a as Category, E as EntityType, D as DisplayMode, R as RealtimeMode, b as PageDefinitionDTO, c as ComputedEntityDefinition, d as CollectionEntityDefinition, e as EventEntityDefinition, V as ViewEntityDefinition, T as TreeEntityDefinition, f as DagEntityDefinition, g as EntityDefinition, S as SingleEntityDefinition, A as ActionDefinition, M as ModuleContext } from './entity-B5WrLI1H.js';
+export { h as AbilityLike, i as ActionEntityService, j as ActionInjection, k as AdaptersContext, l as AppManifest, m as AuthRequest, B as BaseAuthRequest, n as BaseEntityService, o as BaseMailService, p as BaseRolesService, q as BaseUser, r as BaseUsersService, s as BatchLogEntry, t as BatchProgressEvent, u as BridgeRule, v as BridgeTarget, w as CATEGORIES, x as CATEGORY_ORDER, y as CacheManagerContract, z as CacheOptions, F as CacheStats, G as CaslAction, H as CategoryMeta, I as CollectionEntityService, J as ComputedEntityService, K as ConfigContext, L as ConfigEntityDefinition, N as ConfigEntityService, O as ConfirmationType, Q as ContextCrypto, U as ContextEvents, W as ContextEventsHub, X as ContextHelpers, Y as ContextSocket, Z as CoreContext, _ as CoreServices, $ as CreateEntityServiceOptions, a0 as CustomRouteDefinition, a1 as DEFAULT_TENANT_ID, a2 as DagEntityService, a3 as DatabaseAdapter, a4 as DbContext, a5 as EngineContext, a6 as EntityAction, a7 as EntityCaslConfig, a8 as EntityChangePayload, a9 as EntityController, aa as EntityHandler, ab as EntityQuery, ac as EntityRealtimeEmits, ad as EntityRealtimeEvents, ae as EntityServiceHooks, af as EventEmitterLike, ag as EventEntityService, ah as ExternalEntityDefinition, ai as ExternalEntityService, aj as FilterOperators, ak as FilterValue, al as ForbiddenErrorConstructor, am as ForbiddenErrorInstance, an as HttpMethod, ao as LoggerReporter, ap as ManagedCache, aq as ModuleAbilities, ar as ModuleManifest, as as ModuleMiddlewares, at as ModuleRequirements, au as PageDefinition, av as PageType, aw as PaginatedResult, ax as PaginationParams, ay as PaginationParamsWithOffset, az as PluginConfigField, aA as PluginConfigSchema, aB as PluginEnvVar, aC as PluginManifest, aD as PluginSetupInfo, aE as PostAction, aF as RateLimitOptions, aG as ReferenceEntityDefinition, aH as ReferenceEntityService, aI as RegisterPluginOptions, aJ as RetentionPolicy, aK as RolePermission, aL as RouteParameterDefinition, aM as RouteResponseDefinition, aN as RuntimeContext, aO as SSEHelper, aP as SSEOptions, aQ as SSESender, aR as SchemaAdapter, aS as SchemaAlterTableBuilder, aT as SchemaColumnBuilder, aU as SchemaColumnInfo, aV as SchemaForeignKeyBuilder, aW as SchemaTableBuilder, aX as ScopedCacheManager, aY as SeedConfig, aZ as SeedContext, a_ as SendMailOptions, a$ as SendMailResult, b0 as ServicesContext, b1 as SharedEntityProperties, b2 as SingleEntityService, b3 as SocketIOBroadcastOperator, b4 as SocketIOServer, b5 as TempEntityDefinition, b6 as TempEntityService, b7 as TempRetentionPolicy, b8 as TreeEntityService, b9 as TreeNode, ba as TypedEntityQuery, bb as ValidateSchemas, bc as ValidationDetail, bd as ValidationSchema, be as ViewEntityService, bf as VirtualEntityDefinition, bg as VirtualEntityService, bh as WidgetDefinition, bi as WidgetLayout, bj as entityRoom } from './entity-B5WrLI1H.js';
+import { L as LocalizedString, F as FieldCondition, I as InputType, a as FieldMeta, b as FieldDefinition } from './field-Bs1fIux8.js';
+export { A as AuthProviderInfo, c as AuthProviderService, C as ConditionalBoolean, D as DEFAULT_LOCALES, d as DbType, E as EntityIndex, e as FieldDbConfig, f as FieldOptions, g as FieldRelation, h as FieldStorageConfig, i as FieldValidationConfig, j as LocaleConfig, k as getCountLabel, l as getFallbackLocale, r as refOptions, m as resolveLocalized } from './field-Bs1fIux8.js';
 import 'pino';
 
 /** Webhook configuration record */
@@ -178,10 +178,9 @@ interface EntityDefinitionDTO {
         label: string;
     }>;
     /** Fields eligible for grouping (select, boolean, relation, tags) */
-    groupableFields?: Array<{
-        value: string;
-        label: string;
-    }>;
+    groupableFields?: string[];
+    /** Subset of groupableFields where drag between board columns is allowed (default: all) */
+    columnDragFields?: string[];
     /** Default groupBy field from entity definition */
     groupBy?: string;
     /** Default subgroupBy field from entity definition */
@@ -252,6 +251,8 @@ interface PluginDTO {
     icon?: string;
     /** URL to plugin image (served by backend) */
     image?: string;
+    /** LLM-oriented documentation from llms.txt */
+    llms?: string;
     category?: Category;
     version: string;
     description: LocalizedString;
@@ -334,6 +335,12 @@ interface CapabilitiesDTO {
     version: string;
     /** 3-char codes of registered plugins */
     plugins: string[];
+    /** Supported locales for the platform */
+    locales: Array<{
+        code: string;
+        label: string;
+        fallback?: boolean;
+    }>;
 }
 
 /** Status of a ticket as seen by the end user */
@@ -642,7 +649,7 @@ declare function assertAllowedDomain(email: string, allowedDomainsJson: string |
  * Official Nexus plugins maintained by the core team.
  * Used by the backend to populate the plugin store.
  */
-declare const OFFICIAL_PLUGINS: readonly ["@gzl10/nexus-plugin-ai", "@gzl10/nexus-plugin-auth-providers", "@gzl10/nexus-plugin-baserow", "@gzl10/nexus-plugin-charts", "@gzl10/nexus-plugin-cms", "@gzl10/nexus-plugin-compliance", "@gzl10/nexus-plugin-docker", "@gzl10/nexus-plugin-dropbox", "@gzl10/nexus-plugin-google-drive", "@gzl10/nexus-plugin-headscale", "@gzl10/nexus-plugin-importer", "@gzl10/nexus-plugin-links", "@gzl10/nexus-plugin-n8n", "@gzl10/nexus-plugin-notifications", "@gzl10/nexus-plugin-notion", "@gzl10/nexus-plugin-oidc-server", "@gzl10/nexus-plugin-opnsense", "@gzl10/nexus-plugin-plane", "@gzl10/nexus-plugin-prisma", "@gzl10/nexus-plugin-remote", "@gzl10/nexus-plugin-schedules", "@gzl10/nexus-plugin-scim", "@gzl10/nexus-plugin-tags", "@gzl10/nexus-plugin-uptime", "@gzl10/nexus-plugin-webhooks"];
+declare const OFFICIAL_PLUGINS: readonly ["@gzl10/nexus-plugin-ai", "@gzl10/nexus-plugin-auth-providers", "@gzl10/nexus-plugin-baserow", "@gzl10/nexus-plugin-charts", "@gzl10/nexus-plugin-cms", "@gzl10/nexus-plugin-compliance", "@gzl10/nexus-plugin-docker", "@gzl10/nexus-plugin-dropbox", "@gzl10/nexus-plugin-feeds", "@gzl10/nexus-plugin-google-drive", "@gzl10/nexus-plugin-headscale", "@gzl10/nexus-plugin-importer", "@gzl10/nexus-plugin-links", "@gzl10/nexus-plugin-n8n", "@gzl10/nexus-plugin-notifications", "@gzl10/nexus-plugin-notion", "@gzl10/nexus-plugin-oidc-server", "@gzl10/nexus-plugin-opnsense", "@gzl10/nexus-plugin-plane", "@gzl10/nexus-plugin-prisma", "@gzl10/nexus-plugin-remote", "@gzl10/nexus-plugin-schedules", "@gzl10/nexus-plugin-scim", "@gzl10/nexus-plugin-scraper", "@gzl10/nexus-plugin-secrets", "@gzl10/nexus-plugin-tags", "@gzl10/nexus-plugin-uptime", "@gzl10/nexus-plugin-webhooks"];
 type OfficialPluginName = typeof OFFICIAL_PLUGINS[number];
 
 /**

package/dist/index.js

@@ -1,8 +1,15 @@
 // src/types/localization.ts
-function resolveLocalized(value, locale) {
+var DEFAULT_LOCALES = [
+  { code: "en", label: "English", fallback: true },
+  { code: "es", label: "Espa\xF1ol" }
+];
+function getFallbackLocale(locales) {
+  return locales.find((l) => l.fallback)?.code ?? "en";
+}
+function resolveLocalized(value, locale, fallback = "en") {
   if (!value) return "";
   if (typeof value === "string") return value;
-  return value[locale] || value["en"] || Object.values(value)[0] || "";
+  return value[locale] || value[fallback] || Object.values(value)[0] || "";
 }
 function getCountLabel(label, labelPlural, count, locale) {
   const resolved = count === 1 ? label : labelPlural || label;
@@ -236,6 +243,7 @@ var OFFICIAL_PLUGINS = [
   "@gzl10/nexus-plugin-compliance",
   "@gzl10/nexus-plugin-docker",
   "@gzl10/nexus-plugin-dropbox",
+  "@gzl10/nexus-plugin-feeds",
   "@gzl10/nexus-plugin-google-drive",
   "@gzl10/nexus-plugin-headscale",
   "@gzl10/nexus-plugin-importer",
@@ -250,6 +258,8 @@ var OFFICIAL_PLUGINS = [
   "@gzl10/nexus-plugin-remote",
   "@gzl10/nexus-plugin-schedules",
   "@gzl10/nexus-plugin-scim",
+  "@gzl10/nexus-plugin-scraper",
+  "@gzl10/nexus-plugin-secrets",
   "@gzl10/nexus-plugin-tags",
   "@gzl10/nexus-plugin-uptime",
   "@gzl10/nexus-plugin-webhooks"
@@ -309,6 +319,7 @@ function validateEntityDefinition(def) {
 export {
   CATEGORIES,
   CATEGORY_ORDER,
+  DEFAULT_LOCALES,
   DEFAULT_TENANT_ID,
   OFFICIAL_PLUGINS,
   assertAllowedDomain,
@@ -322,6 +333,7 @@ export {
   getCountLabel,
   getEntityName,
   getEntitySubject,
+  getFallbackLocale,
   getOidcClient,
   hasTable,
   isPersistentEntity,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gzl10/nexus-sdk",
-  "version": "0.16.8",
+  "version": "0.18.0",
   "description": "SDK types for creating Nexus plugins and modules",
   "type": "module",
   "main": "./dist/index.js",