tree-sitter-fd 0.1.0

package/grammar.js

@@ -0,0 +1,145 @@
+/// <reference types="tree-sitter-cli/dsl" />
+// @ts-check
+
+/**
+ * Tree-sitter grammar for FD (Fast Draft) format.
+ *
+ * FD is a token-efficient format for describing 2D scene graphs
+ * with shapes, text, styles, animations, and constraints.
+ */
+module.exports = grammar({
+    name: "fd",
+
+    extras: ($) => [/\s/, $.comment],
+
+    rules: {
+        // ─── Document ────────────────────────────────────────────
+        document: ($) =>
+            repeat(
+                choice(
+                    $.style_block,
+                    $.node_declaration,
+                    $.constraint_line,
+                    $.annotation,
+                ),
+            ),
+
+        // ─── Comments ────────────────────────────────────────────
+        comment: (_$) => token(prec(-1, seq("#", /[^#\n][^\n]*/))),
+
+        // ─── Annotations ─────────────────────────────────────────
+        annotation: ($) =>
+            seq(
+                "##",
+                optional(
+                    choice($.annotation_typed, $.string, $.annotation_text),
+                ),
+            ),
+
+        annotation_typed: ($) =>
+            seq(
+                field("key", $.annotation_keyword),
+                ":",
+                field("value", choice($.string, $.annotation_text)),
+            ),
+
+        annotation_text: (_$) => /[^\n]+/,
+
+        annotation_keyword: (_$) =>
+            choice("accept", "status", "priority", "tag"),
+
+        // ─── Style Block ─────────────────────────────────────────
+        style_block: ($) =>
+            seq(
+                "style",
+                field("name", $.identifier),
+                "{",
+                repeat($.property),
+                "}",
+            ),
+
+        // ─── Node Declaration ────────────────────────────────────
+        node_declaration: ($) =>
+            seq(
+                field("kind", $.node_kind),
+                optional(field("id", $.node_id)),
+                optional(field("inline_text", $.string)),
+                "{",
+                repeat($.node_body_item),
+                "}",
+            ),
+
+        node_kind: (_$) => choice("group", "rect", "ellipse", "path", "text"),
+
+        node_body_item: ($) =>
+            choice(
+                $.property,
+                $.node_declaration,
+                $.anim_block,
+                $.annotation,
+            ),
+
+        // ─── Properties ──────────────────────────────────────────
+        property: ($) =>
+            prec.right(seq(
+                field("name", $.property_name),
+                ":",
+                repeat1($._value_item),
+            )),
+
+        property_name: (_$) =>
+            choice(
+                "w", "h", "width", "height",
+                "fill", "stroke", "corner", "opacity",
+                "font", "bg", "use", "layout",
+                "shadow", "scale", "rotate", "translate",
+                "center_in", "offset", "ease", "duration",
+            ),
+
+        _value_item: ($) =>
+            choice(
+                $.number,
+                $.hex_color,
+                $.string,
+                $.node_id,
+                $.key_value_pair,
+                $.identifier,
+            ),
+
+        key_value_pair: ($) =>
+            prec(1, seq($.identifier, "=", choice($.number, $.hex_color, $.string, $.identifier))),
+
+        // ─── Animation Block ─────────────────────────────────────
+        anim_block: ($) =>
+            seq(
+                "anim",
+                field("trigger", $.anim_trigger),
+                "{",
+                repeat($.property),
+                "}",
+            ),
+
+        anim_trigger: ($) => seq(":", $.identifier),
+
+        // ─── Constraint Line ─────────────────────────────────────
+        constraint_line: ($) =>
+            prec.right(seq(
+                field("target", $.node_id),
+                "->",
+                field("constraint_type", $.identifier),
+                ":",
+                repeat1($._value_item),
+            )),
+
+        // ─── Literals ────────────────────────────────────────────
+        node_id: ($) => seq("@", $.identifier),
+
+        identifier: (_$) => /[a-zA-Z_][a-zA-Z0-9_]*/,
+
+        number: (_$) => /-?\d+(\.\d+)?(ms)?/,
+
+        hex_color: (_$) => /#[0-9A-Fa-f]{3,8}/,
+
+        string: (_$) => seq('"', /[^"]*/, '"'),
+    },
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "tree-sitter-fd",
+  "version": "0.1.0",
+  "description": "Tree-sitter grammar for FD (Fast Draft) files",
+  "license": "MIT",
+  "author": "Khang Nghiêm",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/khangnghiem/fast-draft"
+  },
+  "main": "bindings/node",
+  "keywords": [
+    "tree-sitter",
+    "fd",
+    "fast-draft",
+    "parser"
+  ],
+  "files": [
+    "grammar.js",
+    "binding.gyp",
+    "prebuilds/**",
+    "bindings/node/*",
+    "queries/*",
+    "src/**"
+  ],
+  "dependencies": {
+    "nan": "^2.18.0"
+  },
+  "devDependencies": {
+    "tree-sitter-cli": "^0.24.0"
+  },
+  "scripts": {
+    "build": "tree-sitter generate && node-gyp build",
+    "test": "tree-sitter test",
+    "parse": "tree-sitter parse"
+  }
+}

package/queries/highlights.scm

@@ -0,0 +1,49 @@
+; FD (Fast Draft) — Tree-sitter highlight queries
+; For use with Zed, Neovim, Helix, Emacs, etc.
+
+; ─── Comments ──────────────────────────────────────────────
+(comment) @comment
+
+; ─── Keywords ──────────────────────────────────────────────
+(node_kind) @keyword
+"style" @keyword
+"anim" @keyword
+
+; ─── Node IDs ──────────────────────────────────────────────
+(node_id
+  (identifier) @variable)
+(node_id) @variable
+
+; ─── Properties ────────────────────────────────────────────
+(property_name) @property
+
+; ─── Annotations ───────────────────────────────────────────
+"##" @attribute
+(annotation_keyword) @attribute
+
+; ─── Animation trigger ─────────────────────────────────────
+(anim_trigger
+  (identifier) @label)
+
+; ─── Constraint arrow ──────────────────────────────────────
+"->" @operator
+
+; ─── Literals ──────────────────────────────────────────────
+(number) @number
+(hex_color) @constant.builtin
+(string) @string
+
+; ─── Key-value pairs ───────────────────────────────────────
+(key_value_pair
+  key: (identifier) @property)
+
+; ─── Identifiers (layout modes, easing, etc.) ─────────────
+(property_value
+  (identifier) @constant)
+
+; ─── Punctuation ───────────────────────────────────────────
+"{" @punctuation.bracket
+"}" @punctuation.bracket
+":" @punctuation.delimiter
+"," @punctuation.delimiter
+"=" @operator