@shapeshift-labs/frontier-lang-parser 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShapeShift Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @shapeshift-labs/frontier-lang-parser
+
+Parser for the first Frontier Lang `.frontier` syntax slice.
+
+## Install
+
+```sh
+npm install @shapeshift-labs/frontier-lang-parser
+```
+
+The parser projects text into `@shapeshift-labs/frontier-lang-kernel` documents. The syntax is intentionally small and experimental.
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { FrontierLangDocument } from '@shapeshift-labs/frontier-lang-kernel';
+export interface ParseFrontierOptions { readonly id?: string; readonly name?: string; }
+export declare function parseFrontierSource(source: string, options?: ParseFrontierOptions): FrontierLangDocument;
+export declare function parseFrontierFile(name: string, source: string): FrontierLangDocument;

package/dist/index.js

@@ -0,0 +1,64 @@
+import { actionNode, createDocument, effectNode, entityNode, stateNode } from '@shapeshift-labs/frontier-lang-kernel';
+
+export function parseFrontierSource(source, options = {}) {
+  const nodes = [];
+  const documentId = options.id ?? readId(source) ?? 'mod_frontier';
+  const documentName = options.name ?? readName(source) ?? 'FrontierModule';
+  for (const block of readBlocks(source)) {
+    if (block.kind === 'entity') nodes.push(parseEntity(block));
+    if (block.kind === 'state') nodes.push(parseState(block));
+    if (block.kind === 'action') nodes.push(parseAction(block));
+    if (block.kind === 'effect') nodes.push(parseEffect(block));
+  }
+  return createDocument({ id: documentId, name: documentName, nodes });
+}
+
+export function parseFrontierFile(name, source) {
+  return parseFrontierSource(source, { name: name.replace(/\.frontier$/, '') });
+}
+
+function readName(source) { return /module\s+([A-Za-z_$][\w$]*)/.exec(source)?.[1]; }
+function readId(source) { return /module\s+[A-Za-z_$][\w$]*\s+@id\(\s*["']([^"']+)["']\s*\)/.exec(source)?.[1]; }
+function readBlocks(source) {
+  const blocks = [];
+  const header = /\b(entity|state|action|effect)\s+([^{}]+)\{/g;
+  let match;
+  while ((match = header.exec(source))) {
+    let depth = 1; let index = header.lastIndex;
+    while (index < source.length && depth > 0) { const ch = source[index++]; if (ch === '{') depth++; if (ch === '}') depth--; }
+    blocks.push({ kind: match[1], header: match[2].trim(), body: source.slice(header.lastIndex, index - 1) });
+    header.lastIndex = index;
+  }
+  return blocks;
+}
+function idFrom(header, fallback) { return /@id\(\s*["']([^"']+)["']\s*\)/.exec(header)?.[1] ?? fallback; }
+function nameFrom(header) { return /^([A-Za-z_$][\w$]*)/.exec(header)?.[1] ?? 'Unnamed'; }
+function parseEntity(block) {
+  const name = nameFrom(block.header);
+  const fields = [];
+  const fieldRe = /^\s*([A-Za-z_$][\w$]*)(?:\s+@id\(\s*["']([^"']+)["']\s*\))?\s*:\s*([^@{\n]+)([^\n{]*)(?:\{([^}]*)\})?/gm;
+  let m;
+  while ((m = fieldRe.exec(block.body))) {
+    const mergeText = (m[4] ?? '') + ' ' + (m[5] ?? '');
+    fields.push({ id: m[2] ?? `field_${name}_${m[1]}`, name: m[1], type: m[3].trim(), key: /@key/.test(m[4] ?? ''), merge: parseMerge(mergeText) });
+  }
+  return entityNode({ id: idFrom(block.header, `ent_${name}`), name, fields });
+}
+function parseState(block) {
+  const name = nameFrom(block.header);
+  const collections = [];
+  const re = /^\s*([A-Za-z_$][\w$]*)(?:\s+@id\(\s*["']([^"']+)["']\s*\))?\s*:\s*([^@{\n]+)(?:\{([^}]*)\})?/gm;
+  let m;
+  while ((m = re.exec(block.body))) collections.push({ id: m[2] ?? `collection_${name}_${m[1]}`, name: m[1], type: m[3].trim(), merge: parseMerge(m[4] ?? '') });
+  return stateNode({ id: idFrom(block.header, `state_${name}`), name, collections });
+}
+function parseAction(block) {
+  const name = nameFrom(block.header);
+  return actionNode({ id: idFrom(block.header, `action_${name}`), name, input: /input\s*:\s*([^\n]+)/.exec(block.body)?.[1]?.trim(), returns: /returns\s+([^\n]+)/.exec(block.body)?.[1]?.trim(), reads: readList('reads', block.body), writes: readList('writes', block.body), uses: readList('uses', block.body) });
+}
+function parseEffect(block) {
+  const name = nameFrom(block.header);
+  return effectNode({ id: idFrom(block.header, `effect_${name}`), name, capability: /capability\s+([^\n]+)/.exec(block.body)?.[1]?.trim() ?? name, resources: readList('resources', block.body) });
+}
+function readList(label, body) { const line = new RegExp('^\\s*' + label + '\\s+([^\\n]+)', 'm').exec(body)?.[1]; return line ? line.split(',').map((item) => item.trim()).filter(Boolean) : undefined; }
+function parseMerge(text) { const kind = /merge\s+([A-Za-z][\w-]*)/.exec(text)?.[1]; if (!kind) return undefined; const law = /law\s+([A-Za-z][\w-]*)/.exec(text)?.[1]; return { kind, law }; }

package/examples/todo.frontier

@@ -0,0 +1,5 @@
+module TodoApp @id("mod_todo") {
+entity Todo @id("ent_todo") {
+  title @id("field_title"): Text { merge conflict }
+}
+}

package/examples/todo.mjs

@@ -0,0 +1,3 @@
+import { readFileSync } from 'node:fs';
+import { parseFrontierFile } from '../dist/index.js';
+console.log(parseFrontierFile('todo.frontier', readFileSync(new URL('./todo.frontier', import.meta.url), 'utf8')));

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@shapeshift-labs/frontier-lang-parser",
+  "version": "0.1.0",
+  "description": "Parser for the first Frontier Lang .frontier syntax slice.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "npm run build && node test/smoke.mjs",
+    "prepare": "npm run build",
+    "prepack": "npm test"
+  },
+  "keywords": [
+    "frontier",
+    "semantic-merge",
+    "patch",
+    "replay",
+    "compiler"
+  ],
+  "author": "ShapeShift Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-parser.git"
+  },
+  "bugs": {
+    "url": "https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-parser/issues"
+  },
+  "homepage": "https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-parser#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@shapeshift-labs/frontier-lang-kernel": "^0.1.0"
+  }
+}