air-dml 2.1.11 โ†’ 2.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +19 -22
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  *The Open Standard for AI-Ready Data Modeling*
6
6
 
7
- AIR-DML is an extended DBML (Database Markup Language) parser designed for AI-driven development. It adds powerful features for modern data modeling while maintaining full backward compatibility with standard DBML.
7
+ AIR-DML is a data modeling language designed for AI-driven development. It provides a structured, human- and machine-readable syntax for database schemas enriched with business context.
8
8
 
9
9
  [![npm version](https://badge.fury.io/js/air-dml.svg)](https://www.npmjs.com/package/air-dml)
10
10
  [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -21,7 +21,7 @@ Generate ER diagrams from natural language using AI. Mode-ai is the reference im
21
21
 
22
22
  - Natural language to ER diagram generation
23
23
  - Interactive visual editor with drag & drop
24
- - Export to SQL, DBML, and more
24
+ - Export to SQL, AIR-DML, and more
25
25
 
26
26
  <br clear="left"/>
27
27
 
@@ -32,7 +32,7 @@ Generate ER diagrams from natural language using AI. Mode-ai is the reference im
32
32
  ๐ŸŒ **Multilingual**: Logical names (aliases) in any language
33
33
  ๐ŸŽจ **Visual Design**: Coordinate and color information for diagram rendering
34
34
  ๐Ÿ”„ **Polyglot Persistence**: Different database types per area
35
- ๐Ÿ“ฆ **Extends DBML**: Fully compatible with standard DBML syntax
35
+ ๐Ÿ“ฆ **Zero Dependencies**: Independent parser with no external dependencies
36
36
  ๐Ÿ’ฌ **Comment Preservation**: Leading comments are preserved and associated with elements
37
37
 
38
38
  ## Installation
@@ -103,7 +103,7 @@ console.log(output);
103
103
 
104
104
  ### Table Definition
105
105
 
106
- ```dbml
106
+ ```airdml
107
107
  Table table_name [alias: "่ซ–็†ๅ", pos_x: 100, pos_y: 200, color: "#1976D2"] {
108
108
  column_name data_type [constraints, alias: "ใ‚ซใƒฉใƒ ่ซ–็†ๅ"]
109
109
 
@@ -130,7 +130,7 @@ Table table_name [alias: "่ซ–็†ๅ", pos_x: 100, pos_y: 200, color: "#1976D2"]
130
130
 
131
131
  Define allowed values for a column (status codes, flags, etc.):
132
132
 
133
- ```dbml
133
+ ```airdml
134
134
  status varchar(1) [
135
135
  not null,
136
136
  alias: "ใ‚นใƒ†ใƒผใ‚ฟใ‚น",
@@ -143,7 +143,7 @@ Format: `"key=label/key2=label2/..."` โ€” key and label separated by `=`, entrie
143
143
 
144
144
  ### Relationships
145
145
 
146
- ```dbml
146
+ ```airdml
147
147
  Ref: table_a.column > table_b.column // Many-to-One (A โ†’ B)
148
148
  Ref: table_a.column < table_b.column // One-to-Many (A โ† B)
149
149
  Ref: table_a.column - table_b.column // One-to-One
@@ -153,7 +153,7 @@ Ref: table_a.column ~ table_b.column // AI-inferred (undetermined)
153
153
 
154
154
  ### Area (Bounded Context)
155
155
 
156
- ```dbml
156
+ ```airdml
157
157
  Area "Area Name" [
158
158
  pos_x: 50,
159
159
  pos_y: 50,
@@ -188,7 +188,7 @@ When using AI to generate AIR-DML, follow these rules:
188
188
 
189
189
  **Example Output:**
190
190
 
191
- ```dbml
191
+ ```airdml
192
192
  // ๅฎšๆœŸ่ณผๅ…ฅๆฉŸ่ƒฝ
193
193
  Table subscriptions [alias: "ๅฎšๆœŸ่ณผๅ…ฅ"] {
194
194
  id serial [pk, alias: "ๅฎšๆœŸ่ณผๅ…ฅID"]
@@ -317,17 +317,17 @@ interface Area {
317
317
  }
318
318
  ```
319
319
 
320
- ## Comparison: DBML vs AIR-DML
320
+ ## Key Features At a Glance
321
321
 
322
- | Feature | DBML | AIR-DML |
323
- |---------|------|---------|
324
- | **Focus** | Database schema | AI-ready + Business context |
325
- | **Logical names** | โŒ | โœ… `alias` attribute |
326
- | **Area management** | TableGroup (basic) | Area (extended: CommonColumns, database_type) |
327
- | **Visual info** | โŒ | โœ… Coordinates, colors, sizes |
328
- | **Multi-DB** | Project-level | Area-level (polyglot persistence) |
329
- | **AI optimization** | โŒ | โœ… LLM-friendly design |
330
- | **Comment preservation** | โŒ | โœ… Leading comments (v1.2.0+) |
322
+ | Feature | Description |
323
+ |---------|-------------|
324
+ | **Logical names** | `alias` attribute for human-readable names in any language |
325
+ | **Classification values** | `values` attribute for enums and status codes |
326
+ | **Area management** | Bounded context grouping with CommonColumns and per-area database type |
327
+ | **Visual layout** | Coordinates, colors, and sizes for diagram rendering |
328
+ | **Multi-DB** | Area-level database type (polyglot persistence) |
329
+ | **AI-optimized** | LLM-friendly syntax designed for generation and interpretation |
330
+ | **Zero dependencies** | Independent recursive descent parser |
331
331
 
332
332
  ## Changelog
333
333
 
@@ -383,13 +383,10 @@ For the complete AIR-DML specification, see [SPECIFICATION.md](./SPECIFICATION.m
383
383
 
384
384
  Apache-2.0 License - see [LICENSE](./LICENSE) file for details.
385
385
 
386
- AIR-DML extends [DBML](https://github.com/holistics/dbml) (also Apache-2.0).
387
-
388
386
  ## Credits
389
387
 
390
388
  - **Created by**: Data-mination Partners
391
- - **Technical collaboration**: Claude Opus 4.5 (Anthropic)
392
- - **Based on**: [@dbml/core](https://www.npmjs.com/package/@dbml/core) by Holistics
389
+ - **Technical collaboration**: Claude Sonnet 4.6 (Anthropic)
393
390
 
394
391
  ## Links
395
392
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "air-dml",
3
- "version": "2.1.11",
3
+ "version": "2.1.13",
4
4
  "description": "AI-Ready Data Modeling Language - Independent AIR-DML parser with zero dependencies",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",