pdl-editor 0.30.0

package/README.md

@@ -0,0 +1,30 @@
+# pdl-editor
+
+Reusable Monaco and React editor integration for PDL `0.30.x` browser hosts.
+
+The package owns editor wiring only: language registration, TextMate grammar
+setup, the default light theme, marker conversion, Monaco providers, structural
+editor-service runtime types, and a thin `<PdlEditor />` component. Hosts keep
+runtime loading, execution buttons, output panels, routing, and application
+state.
+
+PDL binding and column highlighting is delivered through the shared
+editor-service semantic-token ABI exposed by `pdl-wasm` and consumed here by the
+Monaco provider. Browser hosts should update these packages instead of adding
+PDL-specific parser or token classification logic.
+
+Published packages expose `dist/index.mjs`, `dist/index.cjs`, and
+`dist/index.d.ts`, while static TextMate and language-configuration assets stay
+available through package subpath exports. Use source mode during local
+cross-repo development:
+
+```ts
+import { PdlEditor } from "pdl-editor";
+import { loadPdlRuntime } from "pdl-wasm";
+
+const runtime = await loadPdlRuntime({ wasmUrl: "/wasm/pdl.wasm" });
+```
+
+Use packed mode before publishing by running `npm pack --dry-run` in
+`packages/wasm` and `editors/monaco`, then inspecting the file lists for
+`dist/`, declarations, README, package metadata, and editor assets.

package/assets/language-configuration.json

@@ -0,0 +1,48 @@
+{
+  "comments": {
+    "lineComment": "//",
+    "blockComment": [
+      "/*",
+      "*/"
+    ]
+  },
+  "brackets": [
+    [
+      "(",
+      ")"
+    ]
+  ],
+  "autoClosingPairs": [
+    {
+      "open": "\"",
+      "close": "\""
+    },
+    {
+      "open": "`",
+      "close": "`"
+    },
+    {
+      "open": "(",
+      "close": ")"
+    }
+  ],
+  "surroundingPairs": [
+    {
+      "open": "\"",
+      "close": "\""
+    },
+    {
+      "open": "`",
+      "close": "`"
+    },
+    {
+      "open": "(",
+      "close": ")"
+    }
+  ],
+  "wordPattern": "(-?\\d*\\.\\d\\w*)|([^`~!@#$%^&*()+={}\\[\\]\\\\|;:'\",.<>/?\\s]+)",
+  "indentationRules": {
+    "increaseIndentPattern": "^\\s*let\\s+[A-Za-z_][A-Za-z0-9_]*\\s*=\\s*$",
+    "decreaseIndentPattern": "^\\s*$"
+  }
+}

package/assets/pdl.tmLanguage.json

@@ -0,0 +1,191 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "name": "PDL",
+  "scopeName": "source.pdl",
+  "patterns": [
+    {
+      "include": "#comments"
+    },
+    {
+      "include": "#strings"
+    },
+    {
+      "include": "#backtickColumns"
+    },
+    {
+      "include": "#numbers"
+    },
+    {
+      "include": "#contextReferences"
+    },
+    {
+      "include": "#operators"
+    },
+    {
+      "include": "#declarations"
+    },
+    {
+      "include": "#keywords"
+    },
+    {
+      "include": "#functions"
+    }
+  ],
+  "repository": {
+    "comments": {
+      "patterns": [
+        {
+          "name": "comment.line.double-slash.pdl",
+          "match": "//.*$"
+        },
+        {
+          "name": "comment.block.pdl",
+          "begin": "/\\*",
+          "end": "\\*/"
+        }
+      ]
+    },
+    "strings": {
+      "patterns": [
+        {
+          "name": "string.quoted.double.pdl",
+          "begin": "\"",
+          "end": "\"",
+          "patterns": [
+            {
+              "name": "constant.character.escape.pdl",
+              "match": "\\\\(?:[\"\\\\nrt]|u\\{[0-9A-Fa-f]+\\})"
+            }
+          ]
+        }
+      ]
+    },
+    "backtickColumns": {
+      "patterns": [
+        {
+          "name": "variable.other.column.pdl",
+          "begin": "`",
+          "end": "`",
+          "patterns": [
+            {
+              "name": "constant.character.escape.pdl",
+              "match": "\\\\(?:[`\\\\])"
+            }
+          ]
+        }
+      ]
+    },
+    "numbers": {
+      "patterns": [
+        {
+          "name": "constant.numeric.pdl",
+          "match": "\\b[0-9]+(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?\\b"
+        }
+      ]
+    },
+    "operators": {
+      "patterns": [
+        {
+          "name": "keyword.operator.pdl",
+          "match": "\\|"
+        },
+        {
+          "name": "keyword.operator.comparison.pdl",
+          "match": "==|!=|<=|>=|<|>"
+        },
+        {
+          "name": "keyword.operator.arithmetic.pdl",
+          "match": "[+\\-*/%]"
+        },
+        {
+          "name": "keyword.operator.context.pdl",
+          "match": "[$@]"
+        }
+      ]
+    },
+    "contextReferences": {
+      "patterns": [
+        {
+          "name": "variable.parameter.context.pdl",
+          "match": "[$@][A-Za-z_][A-Za-z0-9_]*\\b"
+        }
+      ]
+    },
+    "declarations": {
+      "patterns": [
+        {
+          "name": "meta.context.declaration.pdl",
+          "match": "\\b(param|state)\\s+([A-Za-z_][A-Za-z0-9_]*)\\b",
+          "captures": {
+            "1": {
+              "name": "keyword.declaration.pdl"
+            },
+            "2": {
+              "name": "variable.parameter.declaration.pdl"
+            }
+          }
+        },
+        {
+          "name": "meta.binding.declaration.pdl",
+          "match": "\\b(let)\\s+([A-Za-z_][A-Za-z0-9_]*)\\b",
+          "captures": {
+            "1": {
+              "name": "keyword.declaration.pdl"
+            },
+            "2": {
+              "name": "variable.other.declaration.pdl"
+            }
+          }
+        },
+        {
+          "name": "meta.output.declaration.pdl",
+          "match": "\\b(output)\\s+([A-Za-z_][A-Za-z0-9_]*)\\b",
+          "captures": {
+            "1": {
+              "name": "keyword.declaration.pdl"
+            },
+            "2": {
+              "name": "entity.name.function.output.pdl"
+            }
+          }
+        },
+        {
+          "name": "variable.parameter.pdl",
+          "match": "\\b[A-Za-z_][A-Za-z0-9_]*\\b(?=\\s*=(?!=))"
+        }
+      ]
+    },
+    "keywords": {
+      "patterns": [
+        {
+          "name": "keyword.control.pdl",
+          "match": "\\b(?:let|output|param|state|load|filter|select|drop|rename|mutate|group_by|agg|sort|limit|join|union|distinct|pivot_longer|complete|save|on|kind|by_name|names_to|values_to|fill|format|over|partition_by|order_by|rows|between|unbounded_preceding|current_row|unbounded_following|preceding|following|stdin|stdout|and|or|not|asc|desc|inner|left|right|full|semi|anti|nulls_first|nulls_last)\\b"
+        },
+        {
+          "name": "constant.language.pdl",
+          "match": "\\b(?:true|false|null)\\b"
+        }
+      ]
+    },
+    "functions": {
+      "patterns": [
+        {
+          "name": "support.function.window.pdl",
+          "match": "\\b(?:count|count_distinct|sum|mean|min|max)\\b(?=\\s*\\([^)]*\\)\\s*over\\b)"
+        },
+        {
+          "name": "support.function.aggregate.pdl",
+          "match": "\\b(?:count|count_distinct|sum|mean|min|max)\\b(?=\\s*\\()"
+        },
+        {
+          "name": "support.function.scalar.pdl",
+          "match": "\\b(?:is_null|not_null|coalesce|concat|lower|upper|trim|to_number|abs|round|if_else|col)\\b(?=\\s*\\()"
+        },
+        {
+          "name": "support.function.window.pdl",
+          "match": "\\b(?:row_number|rank|dense_rank|percent_rank|cume_dist|lag|lead|first_value|last_value)\\b(?=\\s*\\()"
+        }
+      ]
+    }
+  }
+}