@pylonts/dsl 1.1.4 → 1.1.5

package/src/mermaid-driver.ts

@@ -1,85 +1,85 @@
-import { FlowEdge, FlowNode, FlowSchema } from './flow.js';
-import { Page } from './page.js';
-import { PageEdge, PageFlow } from './page-flow.js';
-
-// Mermaid driver: converts a FlowSchema into a Mermaid flowchart (TD).
-// Node ids are hierarchical (n0, n0_0, n0_0_0, ...) so nested sub-flows stay
-// globally unique. A node with a sub-flow renders as a subgraph block whose
-// internals are rendered recursively. ok edges render as -->, conditional
-// edges render as -->|"WHEN"|.
-
-function escapeLabel(s: string): string {
-  return s.replace(/"/g, '\\"').replace(/\n/g, '<br/>');
-}
-
-export function renderFlowMermaid(schema: FlowSchema): string {
-  const lines: string[] = ['flowchart TD'];
-  const ids = new Map<FlowNode, string>();
-  renderFlow(schema, 'n', lines, ids);
-  lines.push('');
-  lines.push('    classDef start fill:#e6f4ea,stroke:#333,stroke-width:1px;');
-  lines.push(`    class ${ids.get(schema.start)} start;`);
-  return lines.join('\n');
-}
-
-function renderFlow(schema: FlowSchema, prefix: string, lines: string[], ids: Map<FlowNode, string>): void {
-  schema.nodes.forEach((n, i) => ids.set(n, `${prefix}${i}`));
-  for (const n of schema.nodes) {
-    const id = ids.get(n)!;
-    if (n.flow) {
-      lines.push(`    subgraph ${id}["${escapeLabel(n.name)}"]`);
-      renderFlow(n.flow, `${id}_`, lines, ids);
-      lines.push('    end');
-    } else {
-      lines.push(`    ${id}["${escapeLabel(n.name)}"]`);
-    }
-  }
-  for (const e of schema.edges) {
-    lines.push(renderEdge(e, ids));
-  }
-}
-
-function renderEdge(e: FlowEdge, ids: Map<FlowNode, string>): string {
-  const label = e.when ? `|"${escapeLabel(e.when)}"|` : '';
-  return `    ${ids.get(e.start)} -->${label} ${ids.get(e.end)}`;
-}
-
-// Page-driven flow renderer: groups pages by their app into swimlane
-// subgraphs, then renders edges across the whole flow.
-
-export function renderPageFlowMermaid(schema: PageFlow): string {
-  const lines: string[] = ['flowchart TD'];
-  const ids = new Map<Page, string>();
-
-  const byApp = new Map<string, Page[]>();
-  for (const p of schema.pages) {
-    const list = byApp.get(p.app.name);
-    if (!list) {
-      byApp.set(p.app.name, [p]);
-    } else {
-      list.push(p);
-    }
-  }
-
-  let appIdx = 0;
-  for (const [appName, pages] of byApp) {
-    lines.push(`    subgraph app${appIdx}["${escapeLabel(appName)}"]`);
-    pages.forEach((p, i) => ids.set(p, `app${appIdx}_p${i}`));
-    for (const p of pages) {
-      const display = p.label ?? p.name;
-      lines.push(`    ${ids.get(p)}["${escapeLabel(display)}"]`);
-    }
-    appIdx++;
-    lines.push('    end');
-  }
-
-  for (const e of schema.edges) {
-    const label = e.when ? `|"${escapeLabel(e.when.name)}"|` : '';
-    lines.push(`    ${ids.get(e.start)} -->${label} ${ids.get(e.end)}`);
-  }
-
-  lines.push('');
-  lines.push('    classDef start fill:#e6f4ea,stroke:#333,stroke-width:1px;');
-  lines.push(`    class ${ids.get(schema.start)} start;`);
-  return lines.join('\n');
+import { FlowEdge, FlowNode, FlowSchema } from './flow.js';
+import { Page } from './page.js';
+import { PageEdge, PageFlow } from './page-flow.js';
+
+// Mermaid driver: converts a FlowSchema into a Mermaid flowchart (TD).
+// Node ids are hierarchical (n0, n0_0, n0_0_0, ...) so nested sub-flows stay
+// globally unique. A node with a sub-flow renders as a subgraph block whose
+// internals are rendered recursively. ok edges render as -->, conditional
+// edges render as -->|"WHEN"|.
+
+function escapeLabel(s: string): string {
+  return s.replace(/"/g, '\\"').replace(/\n/g, '<br/>');
+}
+
+export function renderFlowMermaid(schema: FlowSchema): string {
+  const lines: string[] = ['flowchart TD'];
+  const ids = new Map<FlowNode, string>();
+  renderFlow(schema, 'n', lines, ids);
+  lines.push('');
+  lines.push('    classDef start fill:#e6f4ea,stroke:#333,stroke-width:1px;');
+  lines.push(`    class ${ids.get(schema.start)} start;`);
+  return lines.join('\n');
+}
+
+function renderFlow(schema: FlowSchema, prefix: string, lines: string[], ids: Map<FlowNode, string>): void {
+  schema.nodes.forEach((n, i) => ids.set(n, `${prefix}${i}`));
+  for (const n of schema.nodes) {
+    const id = ids.get(n)!;
+    if (n.flow) {
+      lines.push(`    subgraph ${id}["${escapeLabel(n.name)}"]`);
+      renderFlow(n.flow, `${id}_`, lines, ids);
+      lines.push('    end');
+    } else {
+      lines.push(`    ${id}["${escapeLabel(n.name)}"]`);
+    }
+  }
+  for (const e of schema.edges) {
+    lines.push(renderEdge(e, ids));
+  }
+}
+
+function renderEdge(e: FlowEdge, ids: Map<FlowNode, string>): string {
+  const label = e.when ? `|"${escapeLabel(e.when)}"|` : '';
+  return `    ${ids.get(e.start)} -->${label} ${ids.get(e.end)}`;
+}
+
+// Page-driven flow renderer: groups pages by their app into swimlane
+// subgraphs, then renders edges across the whole flow.
+
+export function renderPageFlowMermaid(schema: PageFlow): string {
+  const lines: string[] = ['flowchart TD'];
+  const ids = new Map<Page, string>();
+
+  const byApp = new Map<string, Page[]>();
+  for (const p of schema.pages) {
+    const list = byApp.get(p.app.name);
+    if (!list) {
+      byApp.set(p.app.name, [p]);
+    } else {
+      list.push(p);
+    }
+  }
+
+  let appIdx = 0;
+  for (const [appName, pages] of byApp) {
+    lines.push(`    subgraph app${appIdx}["${escapeLabel(appName)}"]`);
+    pages.forEach((p, i) => ids.set(p, `app${appIdx}_p${i}`));
+    for (const p of pages) {
+      const display = p.label ?? p.name;
+      lines.push(`    ${ids.get(p)}["${escapeLabel(display)}"]`);
+    }
+    appIdx++;
+    lines.push('    end');
+  }
+
+  for (const e of schema.edges) {
+    const label = e.when ? `|"${escapeLabel(e.when.name)}"|` : '';
+    lines.push(`    ${ids.get(e.start)} -->${label} ${ids.get(e.end)}`);
+  }
+
+  lines.push('');
+  lines.push('    classDef start fill:#e6f4ea,stroke:#333,stroke-width:1px;');
+  lines.push(`    class ${ids.get(schema.start)} start;`);
+  return lines.join('\n');
 }

package/src/mock.ts

@@ -1,12 +1,12 @@
-/**
- * Pure-data mock descriptor. Stored on DTO fields, consumed by pylonts lint mock
- * or MockRegistry.resolve. No function references — serializable and gen-readable.
- *
- * @example { fn: 'abc', count: 20 }
- * @example { fn: 'amt', min: 10, max: 500 }
- * @example { fn: 'phone' }
- */
-export interface MockDescriptor {
-  fn: string;
-  [args: string]: unknown;
-}
+/**
+ * Pure-data mock descriptor. Stored on DTO fields, consumed by pylonts lint mock
+ * or MockRegistry.resolve. No function references — serializable and gen-readable.
+ *
+ * @example { fn: 'abc', count: 20 }
+ * @example { fn: 'amt', min: 10, max: 500 }
+ * @example { fn: 'phone' }
+ */
+export interface MockDescriptor {
+  fn: string;
+  [args: string]: unknown;
+}

package/src/mysql-driver.ts

@@ -1,4 +1,4 @@
-import { Field } from './dsl.js';
+import { Field, rateScale } from './dsl.js';
 import { ForeignKey, Index, TableSchema } from './db.js';
 
 // MySQL driver: converts a TableSchema into a CREATE TABLE statement.
@@ -21,6 +21,8 @@ function columnType(field: Field): string {
       return 'BIGINT';
     case 'decimal':
       return `DECIMAL(${field.precision}, ${field.scale})`;
+    case 'rate':
+      return `DECIMAL(5, ${rateScale(field.unit)})`;
     case 'boolean':
       return 'TINYINT(1)';
     case 'date':
@@ -43,7 +45,7 @@ function renderDefault(field: Field): string {
   // NULL, etc.) — render bare, no quotes.
   if (/^[A-Z]/.test(field.default)) return ` DEFAULT ${field.default}`;
   // Numeric columns take a bare literal, not a quoted one.
-  if (field.type === 'integer' || field.type === 'bigint' || field.type === 'decimal' || field.type === 'boolean') {
+  if (field.type === 'integer' || field.type === 'bigint' || field.type === 'decimal' || field.type === 'rate' || field.type === 'boolean') {
     return ` DEFAULT ${field.default}`;
   }
   return ` DEFAULT '${field.default}'`;

package/src/navigation.ts

@@ -1,29 +1,29 @@
-import type { RouteDataSchema } from './route.js';
-import type { ActionSchema } from './action.js';
-import { PageSchema } from './page.js';
-
-/** Navigation primitives: front-end routing actions that are not provider calls. */
-export interface NavigationAction extends ActionSchema {
-  type: 'navigation';
-  method: 'back' | 'push' | 'popup' | 'home';
-  /** Target page for push navigation. */
-  target?: PageSchema;
-  /** Route params type for push navigation. Auto-derived from target.params if omitted. */
-  params?: RouteDataSchema;
-}
-
-export const navigation = {
-  back(description?: string): NavigationAction {
-    return { name: 'back', type: 'navigation', method: 'back', description };
-  },
-  push(options: { target: PageSchema; params?: RouteDataSchema; description?: string }): NavigationAction {
-    const { target, params, description } = options;
-    return { name: 'push', type: 'navigation', method: 'push', target, params: params ?? target.params, description };
-  },
-  popup(description?: string): NavigationAction {
-    return { name: 'popup', type: 'navigation', method: 'popup', description };
-  },
-  home(description?: string): NavigationAction {
-    return { name: 'home', type: 'navigation', method: 'home', description };
-  },
+import type { RouteDataSchema } from './route.js';
+import type { ActionSchema } from './action.js';
+import { PageSchema } from './page.js';
+
+/** Navigation primitives: front-end routing actions that are not provider calls. */
+export interface NavigationAction extends ActionSchema {
+  type: 'navigation';
+  method: 'back' | 'push' | 'popup' | 'home';
+  /** Target page for push navigation. */
+  target?: PageSchema;
+  /** Route params type for push navigation. Auto-derived from target.params if omitted. */
+  params?: RouteDataSchema;
+}
+
+export const navigation = {
+  back(description?: string): NavigationAction {
+    return { name: 'back', type: 'navigation', method: 'back', description };
+  },
+  push(options: { target: PageSchema; params?: RouteDataSchema; description?: string }): NavigationAction {
+    const { target, params, description } = options;
+    return { name: 'push', type: 'navigation', method: 'push', target, params: params ?? target.params, description };
+  },
+  popup(description?: string): NavigationAction {
+    return { name: 'popup', type: 'navigation', method: 'popup', description };
+  },
+  home(description?: string): NavigationAction {
+    return { name: 'home', type: 'navigation', method: 'home', description };
+  },
 };

package/src/page-def.ts

@@ -1,80 +1,80 @@
-import type { ImportableSchemaBase, CollectionSchemaBase, SchemaBase } from './dsl.js';
-import { DtoField } from './dto.js';
-import type { DtoMessage, DtoArrayField, DtoObjectField } from './dto.js';
-import type { ComponentSchema } from './component.js';
-import type { ActionSchema } from './action.js';
-
-export type { RouteDataSchema } from './route.js';
-export { defineRouteData } from './route.js';
-
-// PageDef: a page skeleton declaration. Describes what data a page needs
-// and where each field comes from (route params, provider calls, or literals).
-// Driver identifies the source by inspecting each field's .schema back-reference.
-
-/** Page lifecycle events that trigger data loading. */
-export interface EventSchema extends SchemaBase {
-  type: 'onLoad' | 'onShow' | 'onHide' | 'onPullDownRefresh' | 'onReachBottom';
-  /** Actions that fire when this event occurs. */
-  actions?: ActionSchema[];
-}
-
-export const events = {
-  onLoad(actions?: ActionSchema[], description?: string): EventSchema {
-    return { name: 'onLoad', type: 'onLoad', actions, description };
-  },
-  onShow(actions?: ActionSchema[], description?: string): EventSchema {
-    return { name: 'onShow', type: 'onShow', actions, description };
-  },
-  onHide(actions?: ActionSchema[], description?: string): EventSchema {
-    return { name: 'onHide', type: 'onHide', actions, description };
-  },
-  onPullDownRefresh(actions?: ActionSchema[], description?: string): EventSchema {
-    return { name: 'onPullDownRefresh', type: 'onPullDownRefresh', actions, description };
-  },
-  onReachBottom(actions?: ActionSchema[], description?: string): EventSchema {
-    return { name: 'onReachBottom', type: 'onReachBottom', actions, description };
-  },
-};
-
-/** Page data: a named collection of fields that defines the page's data shape. */
-export interface PageDataSchema extends CollectionSchemaBase {
-  type: 'pageData';
-  fields: Record<string, DtoField | DtoMessage | DtoArrayField | DtoObjectField>;
-}
-
-export function definePageData(fields: PageDataSchema['fields']): PageDataSchema {
-  // Page data has no meaningful identity of its own; the page name already
-  // scopes it, so the schema name defaults to 'data'.
-  const data: PageDataSchema = { name: 'data', type: 'pageData', fields };
-  // Write back field names (same convention as buildMessage) so defineRef
-  // produces refs with a real field name instead of ''.
-  for (const key of Object.keys(data.fields)) {
-    const df = data.fields[key];
-    if (df instanceof DtoField) {
-      df.name = key;
-      df.schema = data;
-    }
-  }
-  return data;
-}
-
-/** Page skeleton definition. */
-export interface PageDef extends ImportableSchemaBase {
-  data: PageDataSchema;
-  /** Lifecycle events that trigger data loading. */
-  events: EventSchema[];
-  /** Page actions (provider calls, navigation, etc.). */
-  actions: ActionSchema[];
-  /** UI component declarations that make up the page skeleton. */
-  components: ComponentSchema[];
-  /** Whether the driver should generate page-level loading / error / empty state wrappers. */
-  handleStates?: boolean;
-}
-
-/** Define a page skeleton. */
-export function definePageDef(
-  name: string,
-  schema: Omit<PageDef, 'name'>,
-): PageDef {
-  return { name, ...schema };
+import type { ImportableSchemaBase, CollectionSchemaBase, SchemaBase } from './dsl.js';
+import { DtoField } from './dto.js';
+import type { DtoMessage, DtoArrayField, DtoObjectField } from './dto.js';
+import type { ComponentSchema } from './component.js';
+import type { ActionSchema } from './action.js';
+
+export type { RouteDataSchema } from './route.js';
+export { defineRouteData } from './route.js';
+
+// PageDef: a page skeleton declaration. Describes what data a page needs
+// and where each field comes from (route params, provider calls, or literals).
+// Driver identifies the source by inspecting each field's .schema back-reference.
+
+/** Page lifecycle events that trigger data loading. */
+export interface EventSchema extends SchemaBase {
+  type: 'onLoad' | 'onShow' | 'onHide' | 'onPullDownRefresh' | 'onReachBottom';
+  /** Actions that fire when this event occurs. */
+  actions?: ActionSchema[];
+}
+
+export const events = {
+  onLoad(actions?: ActionSchema[], description?: string): EventSchema {
+    return { name: 'onLoad', type: 'onLoad', actions, description };
+  },
+  onShow(actions?: ActionSchema[], description?: string): EventSchema {
+    return { name: 'onShow', type: 'onShow', actions, description };
+  },
+  onHide(actions?: ActionSchema[], description?: string): EventSchema {
+    return { name: 'onHide', type: 'onHide', actions, description };
+  },
+  onPullDownRefresh(actions?: ActionSchema[], description?: string): EventSchema {
+    return { name: 'onPullDownRefresh', type: 'onPullDownRefresh', actions, description };
+  },
+  onReachBottom(actions?: ActionSchema[], description?: string): EventSchema {
+    return { name: 'onReachBottom', type: 'onReachBottom', actions, description };
+  },
+};
+
+/** Page data: a named collection of fields that defines the page's data shape. */
+export interface PageDataSchema extends CollectionSchemaBase {
+  type: 'pageData';
+  fields: Record<string, DtoField | DtoMessage | DtoArrayField | DtoObjectField>;
+}
+
+export function definePageData(fields: PageDataSchema['fields']): PageDataSchema {
+  // Page data has no meaningful identity of its own; the page name already
+  // scopes it, so the schema name defaults to 'data'.
+  const data: PageDataSchema = { name: 'data', type: 'pageData', fields };
+  // Write back field names (same convention as buildMessage) so defineRef
+  // produces refs with a real field name instead of ''.
+  for (const key of Object.keys(data.fields)) {
+    const df = data.fields[key];
+    if (df instanceof DtoField) {
+      df.name = key;
+      df.schema = data;
+    }
+  }
+  return data;
+}
+
+/** Page skeleton definition. */
+export interface PageDef extends ImportableSchemaBase {
+  data: PageDataSchema;
+  /** Lifecycle events that trigger data loading. */
+  events: EventSchema[];
+  /** Page actions (provider calls, navigation, etc.). */
+  actions: ActionSchema[];
+  /** UI component declarations that make up the page skeleton. */
+  components: ComponentSchema[];
+  /** Whether the driver should generate page-level loading / error / empty state wrappers. */
+  handleStates?: boolean;
+}
+
+/** Define a page skeleton. */
+export function definePageDef(
+  name: string,
+  schema: Omit<PageDef, 'name'>,
+): PageDef {
+  return { name, ...schema };
 }