@loom-framework/core 0.1.0-alpha.13 → 0.1.0-alpha.131

package/dist/types/chat.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Chat Event Types (SSE)
+ */
+import type { AIUsage } from './ai.js';
+export interface UserMessageEvent {
+    type: 'user_message';
+    content: string;
+    session_id: string;
+    timestamp: string;
+    /** AI button ID — when set, server resolves prompt from config instead of using content */
+    buttonId?: string;
+    /** Context variables for promptTemplate substitution (e.g. { selectedMember: "张三" }) */
+    context?: Record<string, string>;
+    files?: Array<{
+        uid: string;
+        name: string;
+        size: number;
+        type: string;
+        content?: string;
+    }>;
+}
+export interface AssistantChunkEvent {
+    type: 'assistant_chunk';
+    content: string;
+    message_id: string;
+    session_id: string;
+    is_complete: false;
+}
+export interface AssistantCompleteEvent {
+    type: 'assistant_complete';
+    content: string;
+    message_id: string;
+    session_id: string;
+    is_complete: true;
+    structured_data?: unknown;
+    usage?: AIUsage;
+}
+export interface ToolCallEvent {
+    type: 'tool_call';
+    tool: string;
+    status: 'started' | 'completed' | 'error';
+    result?: unknown;
+    error?: string;
+}
+export type ChatEvent = UserMessageEvent | AssistantChunkEvent | AssistantCompleteEvent | ToolCallEvent;
+//# sourceMappingURL=chat.d.ts.map

package/dist/types/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/types/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,sBAAsB,GACtB,aAAa,CAAC"}

package/dist/types/chat.js

@@ -0,0 +1,5 @@
+/**
+ * Chat Event Types (SSE)
+ */
+export {};
+//# sourceMappingURL=chat.js.map

package/dist/types/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/types/chat.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/command.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI Command Types
+ */
+import type { LoomConfig } from './config.js';
+import type { DataAdapter } from './adapter.js';
+export interface CommandOption {
+    type: 'string' | 'number' | 'boolean' | 'json' | 'string[]';
+    required?: boolean;
+    description?: string;
+    default?: unknown;
+    alias?: string;
+}
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    options?: Record<string, CommandOption>;
+    execute(args: Record<string, unknown>, context: CommandContext): Promise<string | void>;
+}
+export interface CommandContext {
+    config: LoomConfig;
+    configPath: string;
+    projectRoot: string;
+    getDataAdapter(): DataAdapter;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/types/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/types/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,IAAI,WAAW,CAAC;CAC/B"}

package/dist/types/command.js

@@ -0,0 +1,5 @@
+/**
+ * CLI Command Types
+ */
+export {};
+//# sourceMappingURL=command.js.map

package/dist/types/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/types/command.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/config.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Configuration Types
+ */
+import type { ModelSchema } from './model.js';
+import type { AIConfig, AIButtonConfig } from './ai.js';
+import type { DashboardConfig } from './dashboard.js';
+import type { LocaleString } from './locale.js';
+export interface ServerConfig {
+    port?: number;
+    host?: string;
+    cors?: boolean;
+    staticDir?: string;
+}
+export interface DataConfig {
+    defaultAdapter: 'filesystem' | 'sqlite';
+    models: ModelSchema[];
+    /** SQLite specific config */
+    sqlite?: {
+        filename?: string;
+    };
+}
+export interface ThemeConfig {
+    /** Default theme mode. Runtime toggle always available. */
+    defaultMode?: 'light' | 'dark';
+    /** Primary color token override, e.g. { colorPrimary: '#1677ff' } */
+    token?: Record<string, string | number>;
+}
+export interface UIConfig {
+    theme?: ThemeConfig;
+    /** Sidebar collapsed by default on desktop */
+    siderCollapsed?: boolean;
+    /** Show header bar (breadcrumbs + theme toggle) */
+    showHeader?: boolean;
+    /** Locale for i18n */
+    locale?: 'zh-CN' | 'en-US';
+}
+export interface RelationConfig {
+    name: string;
+    label?: LocaleString;
+    from: string;
+    to: string;
+    foreignKey: string;
+    type: 'hasOne' | 'hasMany' | 'manyToMany';
+    through?: string;
+}
+export interface LoomConfig {
+    project: {
+        name: string;
+        description?: LocaleString;
+    };
+    data: DataConfig;
+    ai?: AIConfig;
+    server?: ServerConfig;
+    aiButtons?: AIButtonConfig[];
+    dashboards?: DashboardConfig[];
+    ui?: UIConfig;
+    relations?: RelationConfig[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,YAAY,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,YAAY,CAAC;KAC5B,CAAC;IACF,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/dist/types/config.js

@@ -0,0 +1,5 @@
+/**
+ * Configuration Types
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/dashboard.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Dashboard Types
+ */
+import type { LocaleString } from './locale.js';
+export type DashboardWidgetType = 'stat' | 'pie' | 'ring' | 'bar' | 'line' | 'area' | 'scatter' | 'radar' | 'funnel' | 'treemap' | 'gauge' | 'liquid' | 'heatmap' | 'stacked_bar' | 'grouped_bar';
+export type DashboardAggregate = 'count' | 'sum' | 'avg' | 'min' | 'max' | 'ratio';
+export type DashboardDateInterval = 'day' | 'week' | 'month';
+export interface DashboardWidget {
+    /** Widget type */
+    type: DashboardWidgetType;
+    /** Display title, supports multiple locales */
+    title: LocaleString;
+    /** Data model name from loom.config.ts */
+    model: string;
+    /** Ant Design Grid Col span (1-24), omitted means auto-equal-split */
+    span?: number;
+    /** Group by field for chart data aggregation */
+    groupBy?: string;
+    /** Second group-by field for 2D charts (heatmap, stacked_bar, grouped_bar) */
+    crossGroupBy?: string;
+    /** Aggregate function: count (default) | sum | avg | min | max | ratio */
+    aggregate?: DashboardAggregate;
+    /** Numeric field for sum/avg/min/max aggregation (not needed for count) */
+    field?: string;
+    /** Filter conditions for data before aggregation */
+    filter?: Record<string, unknown>;
+    /** Date interval for groupBy on date fields: day | week | month */
+    interval?: DashboardDateInterval;
+    /** Date field used for date range filtering by DashboardFilterBar */
+    dateField?: string;
+}
+export interface DashboardFilterDimension {
+    /** Field name to filter on */
+    field: string;
+    /** Display label, supports multiple locales */
+    label: LocaleString;
+    /** Filter control type */
+    type: 'select' | 'dateRange';
+    /** Options for 'select' type — if omitted, options are derived from data at runtime */
+    options?: string[];
+}
+export interface DashboardLayoutRow {
+    row: DashboardWidget[];
+}
+export interface DashboardConfig {
+    /** Dashboard identifier, used as page name (same naming rules as model) */
+    name: string;
+    /** Display label for sidebar navigation, supports multiple locales */
+    description?: LocaleString;
+    /** Data models included in this dashboard */
+    models: string[];
+    /** Layout definition: array of rows, each row contains widgets */
+    layout: DashboardLayoutRow[];
+    /** Default date field for date range filtering */
+    defaultDateField?: string;
+    /** Filter dimensions for DashboardFilterBar */
+    filterDimensions?: DashboardFilterDimension[];
+}
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/types/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/types/dashboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAC/E,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAC3E,aAAa,GAAG,aAAa,CAAC;AAElC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEnF,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,+CAA+C;IAC/C,KAAK,EAAE,YAAY,CAAC;IACpB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,YAAY,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,eAAe,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC/C"}

package/dist/types/dashboard.js

@@ -0,0 +1,5 @@
+/**
+ * Dashboard Types
+ */
+export {};
+//# sourceMappingURL=dashboard.js.map

package/dist/types/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/types/dashboard.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Loom Core - Framework types and interfaces
+ *
+ * 编织 AI 能力为应用织物
+ * Skill = 纹理, CLI = 梭子, Data = 纱线, AI = 织力
+ */
+export type { LocaleString, EnumLabels } from './locale.js';
+export { resolveLocale, resolveEnumLabel, resolveEnumLabels } from './locale.js';
+export type { FieldType, FieldDefinition, IndexDefinition, FilesystemAdapterConfig, SQLiteAdapterConfig, ModelAdapterConfig, ModelSchema, CRUDConfig, } from './model.js';
+export type { SortOption, ReadOptions, DataRecord, DataAdapter, } from './adapter.js';
+export type { AIButtonConfig, ClaudeCodeConfig, AIConfig, AIEngine, AICallOptions, AIUsage, AIChunk, } from './ai.js';
+export type { UserMessageEvent, AssistantChunkEvent, AssistantCompleteEvent, ToolCallEvent, ChatEvent, } from './chat.js';
+export type { ServerConfig, DataConfig, ThemeConfig, UIConfig, LoomConfig, RelationConfig, } from './config.js';
+export type { CommandOption, CommandDefinition, CommandContext, } from './command.js';
+export type { DashboardWidgetType, DashboardAggregate, DashboardDateInterval, DashboardWidget, DashboardLayoutRow, DashboardFilterDimension, DashboardConfig, } from './dashboard.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGjF,YAAY,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,OAAO,GACR,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,SAAS,GACV,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Loom Core - Framework types and interfaces
+ *
+ * 编织 AI 能力为应用织物
+ * Skill = 纹理, CLI = 梭子, Data = 纱线, AI = 织力
+ */
+export { resolveLocale, resolveEnumLabel, resolveEnumLabels } from './locale.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/locale.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Locale-aware string types and resolution utilities
+ *
+ * LocaleString allows inline locale objects in config:
+ *   description: '科目'                     — plain string (single locale)
+ *   description: { 'zh-CN': '科目', 'en-US': 'Subject' } — multi-locale
+ *
+ * EnumLabels provides display translations for enum storage values:
+ *   enumLabels: { '语文': { 'zh-CN': '语文', 'en-US': 'Chinese' }, ... }
+ */
+/** Display string that supports multiple locales */
+export type LocaleString = string | Record<string, string>;
+/** Enum display labels: indexed by enum (storage) value, each with locale map */
+export type EnumLabels = Record<string, Record<string, string>>;
+/** Extract text for a given locale from a LocaleString */
+export declare function resolveLocale(value: LocaleString | undefined, locale: string): string;
+/** Extract display label for a specific enum value in a given locale */
+export declare function resolveEnumLabel(labels: EnumLabels | undefined, enumValue: string, locale: string): string;
+/** Resolve all enum labels for a given locale into a flat value→label map */
+export declare function resolveEnumLabels(labels: EnumLabels | undefined, locale: string): Record<string, string>;
+//# sourceMappingURL=locale.d.ts.map

package/dist/types/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIrF;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI1G;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxG"}

package/dist/types/locale.js

@@ -0,0 +1,36 @@
+/**
+ * Locale-aware string types and resolution utilities
+ *
+ * LocaleString allows inline locale objects in config:
+ *   description: '科目'                     — plain string (single locale)
+ *   description: { 'zh-CN': '科目', 'en-US': 'Subject' } — multi-locale
+ *
+ * EnumLabels provides display translations for enum storage values:
+ *   enumLabels: { '语文': { 'zh-CN': '语文', 'en-US': 'Chinese' }, ... }
+ */
+/** Extract text for a given locale from a LocaleString */
+export function resolveLocale(value, locale) {
+    if (!value)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    return value[locale] || value['zh-CN'] || Object.values(value)[0] || '';
+}
+/** Extract display label for a specific enum value in a given locale */
+export function resolveEnumLabel(labels, enumValue, locale) {
+    if (!labels?.[enumValue])
+        return enumValue;
+    const map = labels[enumValue];
+    return map[locale] || map['zh-CN'] || Object.values(map)[0] || enumValue;
+}
+/** Resolve all enum labels for a given locale into a flat value→label map */
+export function resolveEnumLabels(labels, locale) {
+    if (!labels)
+        return {};
+    const result = {};
+    for (const [enumVal, localeMap] of Object.entries(labels)) {
+        result[enumVal] = localeMap[locale] || localeMap['zh-CN'] || Object.values(localeMap)[0] || enumVal;
+    }
+    return result;
+}
+//# sourceMappingURL=locale.js.map

package/dist/types/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/types/locale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,KAA+B,EAAE,MAAc;IAC3E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,MAA8B,EAAE,SAAiB,EAAE,MAAc;IAChG,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC3E,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,MAA8B,EAAE,MAAc;IAC9E,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACtG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types/model.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Field & Model Types
+ */
+import type { LocaleString, EnumLabels } from './locale.js';
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'string[]' | 'number[]' | 'json';
+export interface FieldDefinition {
+    name: string;
+    type: FieldType;
+    required?: boolean;
+    description?: LocaleString;
+    default?: unknown;
+    /** For string fields: enum of allowed values */
+    enum?: string[];
+    /** Display labels for enum values, indexed by enum value then locale */
+    enumLabels?: EnumLabels;
+}
+export interface IndexDefinition {
+    fields: string[];
+    unique?: boolean;
+}
+export interface FilesystemAdapterConfig {
+    dir: string;
+    format: 'json' | 'yaml';
+    /** Date pattern in dir path, e.g. 'YYYY-MM' for work-logs/YYYY-MM/ */
+    datePattern?: string;
+}
+export interface SQLiteAdapterConfig {
+    table: string;
+}
+export interface ModelAdapterConfig {
+    filesystem?: FilesystemAdapterConfig;
+    sqlite?: SQLiteAdapterConfig;
+}
+export interface CRUDConfig {
+    batch?: boolean;
+    export?: boolean;
+    import?: boolean;
+    deleteWithUndo?: boolean;
+}
+/**
+ * Data model definition.
+ *
+ * Rule: the model name becomes the React component name in generated pages.
+ * It must start with a letter and contain only letters, digits, or underscores.
+ * Use camelCase or snake_case — no hyphens allowed.
+ *
+ * @example
+ * ```ts
+ * { name: 'wrongQuestions', ... }    // camelCase → WrongQuestions component
+ * { name: 'wrong_questions', ... }   // snake_case → WrongQuestions component
+ * { name: 'users', ... }             // simple → Users component
+ *
+ * // Invalid: hyphens are not allowed
+ * { name: 'wrong-questions', ... }   // ✗ use wrong_questions or wrongQuestions instead
+ * ```
+ */
+export interface ModelSchema {
+    /**
+     * Model name — will be used as the React component name in generated pages.
+     * Must start with a letter and contain only letters, digits, or underscores (no hyphens).
+     */
+    name: string;
+    fields: FieldDefinition[];
+    indexes?: IndexDefinition[];
+    adapters?: ModelAdapterConfig;
+    crud?: CRUDConfig;
+    description?: LocaleString;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/types/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/types/model.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wEAAwE;IACxE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B"}

package/dist/types/model.js

@@ -0,0 +1,5 @@
+/**
+ * Field & Model Types
+ */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/types/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/types/model.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types.d.ts

@@ -1,204 +1,9 @@
 /**
  * Loom Core - Framework types and interfaces
  *
- * 编织 AI 能力为应用织物
- * Skill = 纹理, CLI = 梭子, Data = 纱线, AI = 织力
+ * Barrel re-export from types/ directory modules.
+ * This file exists for backward compatibility: all existing imports
+ * from './types.js' continue to work without changes.
  */
-export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'string[]' | 'number[]' | 'json';
-export interface FieldDefinition {
-    name: string;
-    type: FieldType;
-    required?: boolean;
-    description?: string;
-    default?: unknown;
-    /** For string fields: enum of allowed values */
-    enum?: string[];
-}
-export interface IndexDefinition {
-    fields: string[];
-    unique?: boolean;
-}
-export interface FilesystemAdapterConfig {
-    dir: string;
-    format: 'json' | 'yaml';
-    /** Date pattern in dir path, e.g. 'YYYY-MM' for work-logs/YYYY-MM/ */
-    datePattern?: string;
-}
-export interface SQLiteAdapterConfig {
-    table: string;
-}
-export interface ModelAdapterConfig {
-    filesystem?: FilesystemAdapterConfig;
-    sqlite?: SQLiteAdapterConfig;
-}
-export interface ModelSchema {
-    name: string;
-    fields: FieldDefinition[];
-    indexes?: IndexDefinition[];
-    adapters?: ModelAdapterConfig;
-    description?: string;
-}
-export interface AIButtonConfig {
-    id: string;
-    label: string;
-    icon?: string;
-    /** Static prompt text */
-    prompt?: string;
-    /** Dynamic prompt template with {{var}} placeholders */
-    promptTemplate?: string;
-    /** Required context variables for promptTemplate */
-    contextVars?: string[];
-    /** Which page this button appears on */
-    placement?: string;
-}
-export interface ClaudeCodeConfig {
-    path?: string;
-    pluginRoot?: string;
-    timeout?: number;
-    skipPermissions?: boolean;
-    defaultModel?: string;
-}
-export interface AIConfig {
-    engine?: string;
-    claudeCode?: ClaudeCodeConfig;
-}
-export interface ServerConfig {
-    port?: number;
-    host?: string;
-    cors?: boolean;
-    staticDir?: string;
-}
-export interface DataConfig {
-    defaultAdapter: 'filesystem' | 'sqlite';
-    models: ModelSchema[];
-    /** SQLite specific config */
-    sqlite?: {
-        filename?: string;
-    };
-}
-export interface LoomConfig {
-    project: {
-        name: string;
-        description?: string;
-    };
-    data: DataConfig;
-    ai?: AIConfig;
-    server?: ServerConfig;
-    aiButtons?: AIButtonConfig[];
-}
-export interface ReadOptions {
-    id?: string;
-    filter?: Record<string, unknown>;
-    limit?: number;
-    offset?: number;
-}
-export interface DataAdapter {
-    readonly name: string;
-    read(model: string, options?: ReadOptions): Promise<unknown>;
-    write(model: string, data: Record<string, unknown>): Promise<unknown>;
-    update(model: string, id: string, data: Record<string, unknown>): Promise<unknown>;
-    delete(model: string, id: string): Promise<void>;
-    getSchema(model: string): Promise<ModelSchema | undefined>;
-    listModels(): Promise<string[]>;
-    initialize(): Promise<void>;
-    healthCheck(): Promise<boolean>;
-}
-export interface CommandOption {
-    type: 'string' | 'number' | 'boolean' | 'json' | 'string[]';
-    required?: boolean;
-    description?: string;
-    default?: unknown;
-    alias?: string;
-}
-export interface CommandDefinition {
-    name: string;
-    description: string;
-    options?: Record<string, CommandOption>;
-    execute(args: Record<string, unknown>, context: CommandContext): Promise<string | void>;
-}
-export interface CommandContext {
-    config: LoomConfig;
-    configPath: string;
-    projectRoot: string;
-    getDataAdapter(): DataAdapter;
-}
-export interface AICallOptions {
-    sessionId: string;
-    resumeSessionId?: string;
-    model?: string;
-    files?: Array<{
-        name: string;
-        path: string;
-    }>;
-    timeout?: number;
-}
-export interface AIUsage {
-    inputTokens: number;
-    outputTokens: number;
-    contextWindow: number;
-}
-export interface AIChunk {
-    type: 'content' | 'thinking' | 'session_info' | 'error' | 'done' | 'tool_call' | 'tool_result';
-    content?: string;
-    sessionId?: string;
-    usage?: AIUsage;
-    error?: string;
-    toolUseId?: string;
-    toolName?: string;
-    toolInput?: unknown;
-    toolResult?: unknown;
-}
-export interface AIEngine {
-    readonly name: string;
-    call(prompt: string, options: AICallOptions): AsyncGenerator<AIChunk>;
-}
-export interface ActiveSession {
-    id: string;
-    claudeSessionId?: string;
-    lastActivity: number;
-    createdAt: number;
-}
-export interface UserMessageEvent {
-    type: 'user_message';
-    content: string;
-    session_id: string;
-    timestamp: string;
-    /** AI button ID — when set, server resolves prompt from config instead of using content */
-    buttonId?: string;
-    /** Context variables for promptTemplate substitution (e.g. { selectedMember: "张三" }) */
-    context?: Record<string, string>;
-    files?: Array<{
-        uid: string;
-        name: string;
-        size: number;
-        type: string;
-        content?: string;
-    }>;
-}
-export interface AssistantChunkEvent {
-    type: 'assistant_chunk';
-    content: string;
-    message_id: string;
-    session_id: string;
-    is_complete: false;
-}
-export interface AssistantCompleteEvent {
-    type: 'assistant_complete';
-    content: string;
-    message_id: string;
-    session_id: string;
-    is_complete: true;
-    structured_data?: unknown;
-    usage?: AIUsage;
-}
-export interface ToolCallEvent {
-    type: 'tool_call';
-    tool: string;
-    status: 'started' | 'completed' | 'error';
-    result?: unknown;
-    error?: string;
-}
-/** @deprecated Use ChatEvent instead */
-export type WebSocketEvent = ChatEvent;
-export type ChatEvent = UserMessageEvent | AssistantChunkEvent | AssistantCompleteEvent | ToolCallEvent;
+export * from './types/index.js';
 //# sourceMappingURL=types.d.ts.map