synthra 0.1.0

data/vscode-extension/README.md

@@ -0,0 +1,246 @@
+# FakeDataDSL for VS Code
+
+Syntax highlighting and snippets for FakeDataDSL schema files.
+
+## Features
+
+- 🎨 **Syntax Highlighting** - Full syntax highlighting for `.dsl` and `.fdsl` files
+- ✨ **Snippets** - Quick templates for common schema patterns
+- 📝 **Comments** - Support for `#` line comments
+- 🔧 **Auto-formatting** - Smart indentation for schemas
+
+## Installation
+
+### From VS Code Marketplace
+
+1. Open VS Code
+2. Press `Ctrl+P` / `Cmd+P`
+3. Type `ext install fakedatadsl.fake-data-dsl`
+4. Press Enter
+
+### Manual Installation (Local Development)
+
+#### For VS Code:
+
+```bash
+# Copy extension to VS Code extensions folder
+mkdir -p ~/.vscode/extensions/fakedatadsl.fake-data-dsl-1.0.0
+cp -r /path/to/fake_data_dsl/vscode-extension/* ~/.vscode/extensions/fakedatadsl.fake-data-dsl-1.0.0/
+
+# Restart VS Code
+```
+
+#### For Cursor:
+
+```bash
+# Copy extension to Cursor extensions folder
+mkdir -p ~/.cursor/extensions/fakedatadsl.fake-data-dsl-1.0.0
+cp -r /path/to/fake_data_dsl/vscode-extension/* ~/.cursor/extensions/fakedatadsl.fake-data-dsl-1.0.0/
+
+# Restart Cursor
+```
+
+## ✅ Verifying Installation
+
+After installation, verify the extension is working:
+
+### Step 1: Check Extension is Loaded
+
+1. Open VS Code/Cursor
+2. Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux)
+3. Type "Extensions: Show Installed Extensions"
+4. Search for "FakeDataDSL" - it should appear in the list
+
+### Step 2: Check Language Detection
+
+1. Create or open a `.dsl` file
+2. Look at the bottom-right status bar
+3. It should show "FakeDataDSL" as the language (not "Plain Text")
+
+### Step 3: Test Syntax Highlighting
+
+Create a test file `test.dsl` with:
+
+```dsl
+User:
+  id: uuid
+  name: full_name
+  email: email
+```
+
+You should see:
+- `User` highlighted as a schema name
+- `id`, `name`, `email` highlighted as field names
+- `uuid`, `full_name`, `email` highlighted as types
+
+### Step 4: Test Snippets
+
+1. Open a `.dsl` file
+2. Type `schema` and press Tab
+3. A template should expand
+
+## Troubleshooting
+
+### Extension Not Loading
+
+**Symptoms**: `.dsl` files show as "Plain Text", no syntax highlighting
+
+**Solutions**:
+
+1. **Restart the editor**:
+   - Completely quit VS Code/Cursor (Cmd+Q on Mac)
+   - Reopen the editor
+
+2. **Reload the window**:
+   - Press `Cmd+Shift+P`
+   - Type "Developer: Reload Window"
+   - Press Enter
+
+3. **Check extension folder structure**:
+   ```bash
+   # For VS Code
+   ls ~/.vscode/extensions/fakedatadsl.fake-data-dsl-1.0.0/
+   
+   # For Cursor
+   ls ~/.cursor/extensions/fakedatadsl.fake-data-dsl-1.0.0/
+   ```
+   
+   You should see:
+   ```
+   package.json
+   language-configuration.json
+   syntaxes/
+   snippets/
+   ```
+
+4. **Verify package.json is valid**:
+   ```bash
+   cat ~/.vscode/extensions/fakedatadsl.fake-data-dsl-1.0.0/package.json | python3 -m json.tool
+   ```
+
+### Language Not Auto-Detected
+
+**Symptoms**: File opens but shows "Plain Text" instead of "FakeDataDSL"
+
+**Solutions**:
+
+1. **Manually set language**:
+   - Click on "Plain Text" in the bottom-right status bar
+   - Search for "FakeDataDSL"
+   - Select it
+
+2. **Check file extension**:
+   - File must end with `.dsl` or `.fdsl`
+
+3. **Force file association**:
+   - Press `Cmd+Shift+P`
+   - Type "Change Language Mode"
+   - Select "Configure File Association for '.dsl'"
+   - Choose "FakeDataDSL"
+
+### Snippets Not Working
+
+**Symptoms**: Typing `schema` + Tab doesn't expand
+
+**Solutions**:
+
+1. **Check language mode**: Must be "FakeDataDSL" not "Plain Text"
+
+2. **Check snippet settings**:
+   - Open Settings (`Cmd+,`)
+   - Search for "snippets"
+   - Ensure "Editor: Snippet Suggestions" is not "none"
+
+3. **Manual snippet test**:
+   - Press `Cmd+Shift+P`
+   - Type "Insert Snippet"
+   - Search for "schema"
+
+## Syntax Highlighting
+
+The extension provides highlighting for:
+
+- **Schema names** - Capitalized class names (PascalCase)
+- **Field names** - Lowercase with underscores (snake_case)
+- **Types** - Built-in and custom types
+- **Annotations** - `@version`, `@deprecated`, `@latency`, etc.
+- **Strings** - Double-quoted values
+- **Numbers** - Including ranges (`1..100`) and percentages (`80%`)
+- **Comments** - Lines starting with `#`
+- **Keywords** - `if`, `true`, `false`, `Ref`
+
+## Snippets Reference
+
+| Prefix | Description | Example |
+|--------|-------------|---------|
+| `schema` | Basic schema | `SchemaName:` with fields |
+| `schemav` | Schema with version | Includes `@version` |
+| `user` | User schema template | Complete user with common fields |
+| `apiresponse` | API response with behaviors | Includes `@latency`, `@failure` |
+| `fuuid` | UUID field | `id: uuid` |
+| `ftext` | Text field with range | `name: text(5..50)` |
+| `fnumber` | Number field with range | `age: number(18..65)` |
+| `femail` | Email field | `email: email` |
+| `fbool` | Boolean with probability | `active: boolean(true:80%)` |
+| `fenum` | Enum field | `status: enum(a, b, c)` |
+| `fconst` | Constant value | `type: const("value")` |
+| `farray` | Array field | `items: array(Item, 1..5)` |
+| `fcopy` | Copy field value | `user_id: copy("user.id")` |
+| `fshared` | Shared across batch | `recipient: shared(User)` |
+| `fmapby` | Map by field | `users: map_by_field(...)` |
+| `fref` | Schema reference | `user_id: Ref(User.id)` |
+| `foneof` | Polymorphic field | `payload: one_of(A, B)` |
+| `fopt` | Optional field | `phone?: phone` |
+| `fnull` | Nullable field | `bio: text?` |
+| `fif` | Conditional field | `tracking: text if shipped` |
+| `blatency` | Latency behavior | `@latency 100..500ms` |
+| `bfailure` | Failure behavior | `@failure 5%` |
+| `bversion` | Version annotation | `@version 1.0` |
+| `bdeprecated` | Deprecated annotation | `@deprecated Use X instead` |
+| `twitterdm` | Full Twitter DM template | Complete webhook schema |
+
+## Example
+
+```dsl
+# User schema for authentication system
+User:
+  @version 2.0
+  
+  id: uuid(unique: true)
+  name: full_name
+  email: email
+  age: number(18..65)
+  active: boolean(true:80%)
+  role: enum(user, admin:10%, moderator:15%)
+  created_at: past_date(1y)
+  profile?: UserProfile
+
+UserProfile:
+  bio?: text(20..200)
+  avatar_url?: url
+  website?: url
+```
+
+## Requirements
+
+- VS Code 1.60.0 or higher (or Cursor)
+
+## Release Notes
+
+### 1.0.0
+
+- Initial release
+- Full syntax highlighting for DSL constructs
+- 30+ snippets for common patterns
+- Comment support
+- Smart bracket matching
+- Auto-indentation
+
+## Contributing
+
+Found a bug or want to add a feature? 
+Visit [GitHub](https://github.com/talaatmagdyx/fake_data_dsl)
+
+## License
+
+MIT

data/vscode-extension/language-configuration.json

@@ -0,0 +1,31 @@
+{
+  "comments": {
+    "lineComment": "#"
+  },
+  "brackets": [
+    ["(", ")"],
+    ["[", "]"]
+  ],
+  "autoClosingPairs": [
+    { "open": "(", "close": ")" },
+    { "open": "[", "close": "]" },
+    { "open": "\"", "close": "\"", "notIn": ["string", "comment"] }
+  ],
+  "surroundingPairs": [
+    ["(", ")"],
+    ["[", "]"],
+    ["\"", "\""]
+  ],
+  "indentationRules": {
+    "increaseIndentPattern": "^\\s*\\w+:\\s*$",
+    "decreaseIndentPattern": "^\\s*$"
+  },
+  "folding": {
+    "markers": {
+      "start": "^\\s*\\w+:\\s*$",
+      "end": "^(?=\\S)"
+    }
+  },
+  "wordPattern": "(-?\\d*\\.\\d\\w*)|([^\\`\\~\\!\\@\\#\\%\\^\\&\\*\\(\\)\\-\\=\\+\\[\\{\\]\\}\\\\\\|\\;\\:\\'\\\"\\,\\.\\<\\>\\/\\?\\s]+)"
+}
+

data/vscode-extension/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "fake-data-dsl",
+  "displayName": "FakeDataDSL",
+  "description": "Syntax highlighting and snippets for FakeDataDSL schema files",
+  "version": "1.0.0",
+  "publisher": "fakedatadsl",
+  "engines": {
+    "vscode": "^1.60.0"
+  },
+  "categories": [
+    "Programming Languages",
+    "Snippets"
+  ],
+  "keywords": [
+    "fake data",
+    "dsl",
+    "schema",
+    "testing",
+    "mock data"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/talaatmagdyx/fake_data_dsl"
+  },
+  "contributes": {
+    "languages": [
+      {
+        "id": "fakedatadsl",
+        "aliases": [
+          "FakeDataDSL",
+          "fakedatadsl"
+        ],
+        "extensions": [
+          ".dsl",
+          ".fdsl"
+        ],
+        "configuration": "./language-configuration.json"
+      }
+    ],
+    "grammars": [
+      {
+        "language": "fakedatadsl",
+        "scopeName": "source.fakedatadsl",
+        "path": "./syntaxes/fakedatadsl.tmLanguage.json"
+      }
+    ],
+    "snippets": [
+      {
+        "language": "fakedatadsl",
+        "path": "./snippets/fakedatadsl.json"
+      }
+    ]
+  }
+}
+

data/vscode-extension/snippets/fakedatadsl.json

@@ -0,0 +1,198 @@
+{
+  "Schema": {
+    "prefix": "schema",
+    "body": [
+      "${1:SchemaName}:",
+      "  ${2:field}: ${3:type}",
+      "$0"
+    ],
+    "description": "Create a new schema"
+  },
+  "Schema with Version": {
+    "prefix": "schemav",
+    "body": [
+      "${1:SchemaName}:",
+      "  @version ${2:1.0}",
+      "  ",
+      "  ${3:field}: ${4:type}",
+      "$0"
+    ],
+    "description": "Create a versioned schema"
+  },
+  "User Schema": {
+    "prefix": "user",
+    "body": [
+      "User:",
+      "  id: uuid",
+      "  name: full_name",
+      "  email: email",
+      "  created_at: past_date(1y)",
+      "$0"
+    ],
+    "description": "Common user schema template"
+  },
+  "API Response": {
+    "prefix": "apiresponse",
+    "body": [
+      "APIResponse:",
+      "  @latency 50..200ms",
+      "  @failure 2%",
+      "  ",
+      "  success: boolean(true:95%)",
+      "  data: ${1:DataSchema}",
+      "  timestamp: now",
+      "$0"
+    ],
+    "description": "API response with behaviors"
+  },
+  "Field - UUID": {
+    "prefix": "fuuid",
+    "body": "${1:id}: uuid",
+    "description": "UUID field"
+  },
+  "Field - Text": {
+    "prefix": "ftext",
+    "body": "${1:name}: text(${2:5}..${3:50})",
+    "description": "Text field with length range"
+  },
+  "Field - Number": {
+    "prefix": "fnumber",
+    "body": "${1:count}: number(${2:1}..${3:100})",
+    "description": "Number field with range"
+  },
+  "Field - Email": {
+    "prefix": "femail",
+    "body": "${1:email}: email",
+    "description": "Email field"
+  },
+  "Field - Boolean": {
+    "prefix": "fbool",
+    "body": "${1:active}: boolean(${2:true}:${3:80}%)",
+    "description": "Boolean field with probability"
+  },
+  "Field - Enum": {
+    "prefix": "fenum",
+    "body": "${1:status}: enum(${2:pending}, ${3:active}, ${4:completed})",
+    "description": "Enum field"
+  },
+  "Field - Const": {
+    "prefix": "fconst",
+    "body": "${1:type}: const(\"${2:value}\")",
+    "description": "Constant field"
+  },
+  "Field - Array": {
+    "prefix": "farray",
+    "body": "${1:items}: array(${2:Item}, ${3:1}..${4:5})",
+    "description": "Array field"
+  },
+  "Field - Copy": {
+    "prefix": "fcopy",
+    "body": "${1:user_id}: copy(\"${2:user.id}\")",
+    "description": "Copy field value"
+  },
+  "Field - Shared": {
+    "prefix": "fshared",
+    "body": "${1:recipient}: shared(${2:User})",
+    "description": "Shared value across batch"
+  },
+  "Field - Map By Field": {
+    "prefix": "fmapby",
+    "body": "${1:users}: map_by_field(\"${2:id}\", ${3:sender}: ${4:User}, ${5:recipient}: ${6:User})",
+    "description": "Map with dynamic keys"
+  },
+  "Field - Reference": {
+    "prefix": "fref",
+    "body": "${1:user_id}: Ref(${2:User}.${3:id})",
+    "description": "Reference to another schema"
+  },
+  "Field - One Of": {
+    "prefix": "foneof",
+    "body": "${1:payload}: one_of(${2:TypeA}, ${3:TypeB}, ${4:TypeC})",
+    "description": "Polymorphic field"
+  },
+  "Field - Optional": {
+    "prefix": "fopt",
+    "body": "${1:phone}?: ${2:phone}",
+    "description": "Optional field"
+  },
+  "Field - Nullable": {
+    "prefix": "fnull",
+    "body": "${1:nickname}: ${2:text}?",
+    "description": "Nullable field"
+  },
+  "Field - Conditional": {
+    "prefix": "fif",
+    "body": "${1:tracking}: ${2:text} if ${3:shipped}",
+    "description": "Conditional field"
+  },
+  "Behavior - Latency": {
+    "prefix": "blatency",
+    "body": "@latency ${1:100}..${2:500}ms",
+    "description": "Add latency behavior"
+  },
+  "Behavior - Failure": {
+    "prefix": "bfailure",
+    "body": "@failure ${1:5}%",
+    "description": "Add failure behavior"
+  },
+  "Behavior - Partial Data": {
+    "prefix": "bpartial",
+    "body": "@partial_data ${1:10}%",
+    "description": "Add partial data behavior"
+  },
+  "Behavior - Version": {
+    "prefix": "bversion",
+    "body": "@version ${1:1.0}",
+    "description": "Set schema version"
+  },
+  "Behavior - Deprecated": {
+    "prefix": "bdeprecated",
+    "body": "@deprecated ${1:Use NewSchema instead}",
+    "description": "Mark schema as deprecated"
+  },
+  "Twitter DM Webhook": {
+    "prefix": "twitterdm",
+    "body": [
+      "TwitterDMWebhook:",
+      "  eventName: const(\"new_twitter_direct_message\")",
+      "  eventData: EventData",
+      "",
+      "EventData:",
+      "  users: map_by_field(\"id\", sender: TwitterUser, recipient: shared(TwitterUser))",
+      "  for_user_id: copy(\"users.recipient.id\")",
+      "  direct_message_events: array(DirectMessageEvent, 1..1)",
+      "",
+      "DirectMessageEvent:",
+      "  type: const(\"message_create\")",
+      "  id: snowflake_id",
+      "  created_timestamp: unix_timestamp_ms",
+      "  message_create: MessageCreate",
+      "",
+      "MessageCreate:",
+      "  target: Target",
+      "  sender_id: copy(\"users.sender.id\")",
+      "  message_data: MessageData",
+      "",
+      "Target:",
+      "  recipient_id: copy(\"users.recipient.id\")",
+      "",
+      "MessageData:",
+      "  text: message_text",
+      "  entities: Entities",
+      "",
+      "Entities:",
+      "  hashtags: empty_array",
+      "  symbols: empty_array",
+      "  user_mentions: empty_array",
+      "  urls: empty_array",
+      "",
+      "TwitterUser:",
+      "  id: snowflake_id",
+      "  name: full_name",
+      "  screen_name: social_handle",
+      "$0"
+    ],
+    "description": "Complete Twitter DM webhook template"
+  }
+}
+

data/vscode-extension/syntaxes/fakedatadsl.tmLanguage.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "name": "FakeDataDSL",
+  "scopeName": "source.fakedatadsl",
+  "patterns": [
+    { "include": "#comments" },
+    { "include": "#schema-definition" },
+    { "include": "#annotations" },
+    { "include": "#field-definition" }
+  ],
+  "repository": {
+    "comments": {
+      "name": "comment.line.number-sign.fakedatadsl",
+      "match": "#.*$"
+    },
+    "schema-definition": {
+      "name": "entity.name.class.fakedatadsl",
+      "match": "^([A-Z][a-zA-Z0-9_]*):",
+      "captures": {
+        "1": { "name": "entity.name.type.fakedatadsl" }
+      }
+    },
+    "annotations": {
+      "name": "meta.annotation.fakedatadsl",
+      "match": "(@)(version|deprecated|latency|failure|partial_data|close_connection|simulate_error|randomize_order|seed)\\s*(.*)?$",
+      "captures": {
+        "1": { "name": "punctuation.definition.annotation.fakedatadsl" },
+        "2": { "name": "storage.type.annotation.fakedatadsl" },
+        "3": { "name": "string.unquoted.annotation-value.fakedatadsl" }
+      }
+    },
+    "field-definition": {
+      "patterns": [
+        { "include": "#field-name" },
+        { "include": "#type-reference" },
+        { "include": "#builtin-types" },
+        { "include": "#special-types" },
+        { "include": "#strings" },
+        { "include": "#numbers" },
+        { "include": "#operators" },
+        { "include": "#keywords" }
+      ]
+    },
+    "field-name": {
+      "name": "variable.other.field.fakedatadsl",
+      "match": "^\\s+([a-z_][a-zA-Z0-9_]*)(\\??):(?!:)",
+      "captures": {
+        "1": { "name": "variable.other.field.fakedatadsl" },
+        "2": { "name": "keyword.operator.optional.fakedatadsl" }
+      }
+    },
+    "type-reference": {
+      "name": "entity.name.type.reference.fakedatadsl",
+      "match": ":\\s*([A-Z][a-zA-Z0-9_]*)(?:\\?)?(?:\\s|$)",
+      "captures": {
+        "1": { "name": "entity.name.type.fakedatadsl" }
+      }
+    },
+    "builtin-types": {
+      "name": "support.type.builtin.fakedatadsl",
+      "match": "\\b(uuid|ulid|id_sequence|snowflake_id|numeric_string_id|name|full_name|first_name|last_name|email|phone|username|avatar|text|paragraph|sentence|word|message_text|social_handle|hashtag_text|number|integer|float|latitude|longitude|money|boolean|date|past_date|future_date|timestamp|now|unix_timestamp_ms|address|city|country|country_code|postal_code|state|url|domain|ip|ipv4|ipv6|mac_address|user_agent|currency|currency_code|iban|credit_card|object|empty_array|indices_pair)\\b"
+    },
+    "special-types": {
+      "patterns": [
+        {
+          "name": "support.function.special.fakedatadsl",
+          "match": "\\b(array|enum|const|copy|shared|map_by_field|one_of|Ref|custom|formula|template)\\b"
+        }
+      ]
+    },
+    "strings": {
+      "name": "string.quoted.double.fakedatadsl",
+      "begin": "\"",
+      "end": "\"",
+      "patterns": [
+        {
+          "name": "constant.character.escape.fakedatadsl",
+          "match": "\\\\."
+        }
+      ]
+    },
+    "numbers": {
+      "patterns": [
+        {
+          "name": "constant.numeric.range.fakedatadsl",
+          "match": "\\b(\\d+)\\s*\\.\\.\\s*(\\d+)\\b"
+        },
+        {
+          "name": "constant.numeric.percentage.fakedatadsl",
+          "match": "\\b(\\d+)%\\b"
+        },
+        {
+          "name": "constant.numeric.fakedatadsl",
+          "match": "\\b\\d+(\\.\\d+)?\\b"
+        }
+      ]
+    },
+    "operators": {
+      "patterns": [
+        {
+          "name": "keyword.operator.range.fakedatadsl",
+          "match": "\\.\\."
+        },
+        {
+          "name": "keyword.operator.nullable.fakedatadsl",
+          "match": "\\?(?=\\s|$)"
+        }
+      ]
+    },
+    "keywords": {
+      "patterns": [
+        {
+          "name": "keyword.control.conditional.fakedatadsl",
+          "match": "\\bif\\b"
+        },
+        {
+          "name": "constant.language.boolean.fakedatadsl",
+          "match": "\\b(true|false)\\b"
+        },
+        {
+          "name": "keyword.other.unit.fakedatadsl",
+          "match": "\\b(ms|s|m|h|d|y)\\b"
+        }
+      ]
+    }
+  }
+}
+