@dforge-core/metadata 0.0.30 → 0.0.32

package/src/index.ts

@@ -6,7 +6,7 @@
 //     from a friendly field-type choice;
 //   • structural types — the authoring shape of every module-package file
 //     (manifest, entities, data views, reports, stored procedures, menus, folders,
-//     roles, settings, jobs, triggers, webhooks, print templates, seed data,
+//     roles, settings, jobs, triggers, webhooks, print templates, seed data, translations,
 //     actions, diagrams), mirrored from the JSON schemas under docs/schemas/.
 //
 // No runtime dependencies; safe to import from editors, the web app, the CLI,
@@ -69,6 +69,7 @@ export type {
 	SignConfig,
 	LedgerRegistryEntry,
 	TraitCd,
+	AuditHistoryLevel,
 } from "./entity";
 
 // Entity introspection helpers (primary keys, identity keys, reference links).
@@ -120,6 +121,15 @@ export type { MenusFile, MenuDef, MenuItemDef, MenuItemType } from "./menus";
 export type { FoldersFile, FolderDef, FolderEntityBinding } from "./folders";
 export type { DiagramFile, DiagramDef, DiagramEntity, DiagramDetail, DiagramRelation } from "./diagrams";
 export type { RolesFile, RoleDef } from "./roles";
+export type {
+	TranslationsFile,
+	TranslatedAction,
+	TranslatedEntity,
+	TranslatedMenu,
+	TranslatedOption,
+	TranslatedReport,
+	TranslatedWithOptions,
+} from "./translations";
 export type { SettingsFile, SettingDef, SettingBaseDatatype } from "./settings";
 export type { JobsFile, JobDef } from "./jobs";
 export type { TriggersFile, TriggerDef, EntityEvent } from "./triggers";

package/src/manifest.ts

@@ -1,6 +1,8 @@
 // Module manifest — authoring shape of `manifest.json`.
 // Mirror of manifest.schema.json.
 
+import type { AuditHistoryLevel } from "./entity";
+
 /** Author block on a manifest. */
 export interface ManifestAuthor {
 	name: string;
@@ -42,8 +44,8 @@ export interface ManifestDef {
 	license?: string;
 	/** Module code → semver range or partial-dep object. */
 	dependencies?: Record<string, ModuleDependency>;
-	/** Default audit history mode for this module's entities. */
-	auditHistory?: "none" | "minimal" | "full";
+	/** Default audit history level for this module's entities; each entity may override. */
+	auditHistory?: AuditHistoryLevel;
 	/** Default for `comments` on this module's entities; each entity may override. */
 	comments?: boolean;
 	/** Entity code → relative path of its JSON file (dotted keys = extensions). */

package/src/translations.ts

@@ -0,0 +1,61 @@
+// Translations — authoring shape of `translations/<locale>.json`. Mirror of translations.schema.json.
+
+/** A translated option: the label alone, or label with icon / color overrides. */
+export type TranslatedOption = string | { label?: string; icon?: string; color?: string };
+
+/** A label with optional option translations (fields, domains, params). */
+export interface TranslatedWithOptions {
+	label?: string;
+	/** Option value (stored code) → translation. */
+	options?: Record<string, TranslatedOption>;
+}
+
+export interface TranslatedEntity {
+	label?: string;
+	desc?: string;
+	/** Column code → label and option labels. */
+	fields?: Record<string, TranslatedWithOptions>;
+	/** Card-layout section code → heading. */
+	columnGroups?: Record<string, { label?: string }>;
+	/** Constraint name → violation message. */
+	constraints?: Record<string, { message?: string }>;
+}
+
+export interface TranslatedMenu {
+	label?: string;
+	/** Item code → label. Flat, even when ui/menus.json nests the items. */
+	items?: Record<string, { label?: string }>;
+}
+
+export interface TranslatedReport {
+	label?: string;
+	/** Dataset code → caption. */
+	datasets?: Record<string, { caption?: string }>;
+	params?: Record<string, TranslatedWithOptions>;
+}
+
+export interface TranslatedAction {
+	label?: string;
+	/** Tooltip. */
+	desc?: string;
+	params?: Record<string, TranslatedWithOptions>;
+}
+
+/** A `translations/<locale>.json` file. Every key is optional; a gap falls back to the base text. */
+export interface TranslationsFile {
+	entities?: Record<string, TranslatedEntity>;
+	domains?: Record<string, TranslatedWithOptions>;
+	/** Folder code (flat, not the path) → label. */
+	folders?: Record<string, { label?: string }>;
+	views?: Record<string, { label?: string }>;
+	menus?: Record<string, TranslatedMenu>;
+	settings?: Record<string, { label?: string; desc?: string }>;
+	/** Module-qualified role code → label. */
+	roles?: Record<string, { label?: string }>;
+	reports?: Record<string, TranslatedReport>;
+	actions?: Record<string, TranslatedAction>;
+	/** Accepted, not applied at install yet. */
+	print_templates?: Record<string, { label?: string }>;
+	/** Exact text of a DSL info / warn / error / exit call → translation. */
+	messages?: Record<string, string>;
+}