@malloydata/motly-ts-parser 0.2.0 → 0.2.1

package/build/interface/src/types.d.ts

@@ -0,0 +1,69 @@
+/** A MOTLY scalar: string, number, boolean, or Date. */
+export type MOTLYScalar = string | number | boolean | Date;
+/** A reference to another node in the MOTLY tree (e.g. `$^parent.name`). */
+export interface MOTLYRef {
+    linkTo: string;
+}
+/** An environment variable reference (e.g. `@env.API_KEY`). */
+export interface MOTLYEnvRef {
+    env: string;
+}
+/**
+ * A value node in the MOTLY tree.
+ *
+ * - `eq` — the node's assigned value: a scalar, a reference ({@link MOTLYRef}),
+ *   or an array of child nodes
+ * - `properties` — named child nodes (the node's "tags")
+ * - `deleted` — true if this node was explicitly deleted with `-name`
+ */
+export interface MOTLYValue {
+    eq?: MOTLYScalar | MOTLYRef | MOTLYEnvRef | MOTLYNode[];
+    properties?: Record<string, MOTLYNode>;
+    deleted?: boolean;
+}
+/**
+ * A node in the MOTLY tree. Every node is a {@link MOTLYValue}.
+ * References are represented as `eq: { linkTo: "..." }` inside a value node.
+ */
+export type MOTLYNode = MOTLYValue;
+/** A parse error with source location span. */
+export interface MOTLYError {
+    /** Machine-readable error code (e.g. `"tag-parse-syntax-error"`). */
+    code: string;
+    /** Human-readable error message. */
+    message: string;
+    /** Start of the offending region (0-based line, column, and byte offset). */
+    begin: {
+        line: number;
+        column: number;
+        offset: number;
+    };
+    /** End of the offending region (0-based, exclusive). */
+    end: {
+        line: number;
+        column: number;
+        offset: number;
+    };
+}
+/** An error from schema validation. */
+export interface MOTLYSchemaError {
+    /** Machine-readable error code (e.g. `"missing-required"`, `"wrong-type"`). */
+    code: string;
+    /** Human-readable error message. */
+    message: string;
+    /** Path to the offending node (e.g. `["metadata", "name"]`). */
+    path: string[];
+}
+/** Type guard: is this eq value a link reference? */
+export declare function isRef(eq: MOTLYValue["eq"]): eq is MOTLYRef;
+/** Type guard: is this eq value an env reference? */
+export declare function isEnvRef(eq: MOTLYValue["eq"]): eq is MOTLYEnvRef;
+/** An error from reference validation. */
+export interface MOTLYValidationError {
+    /** Machine-readable error code (e.g. `"unresolved-reference"`). */
+    code: string;
+    /** Human-readable error message. */
+    message: string;
+    /** Path to the offending reference (e.g. `["spec", "ref"]`). */
+    path: string[];
+}

package/build/interface/src/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRef = isRef;
+exports.isEnvRef = isEnvRef;
+/** Type guard: is this eq value a link reference? */
+function isRef(eq) {
+    return typeof eq === "object" && eq !== null && "linkTo" in eq && !Array.isArray(eq) && !(eq instanceof Date);
+}
+/** Type guard: is this eq value an env reference? */
+function isEnvRef(eq) {
+    return typeof eq === "object" && eq !== null && "env" in eq && !Array.isArray(eq) && !(eq instanceof Date);
+}

package/build/{clone.d.ts → parser/src/clone.d.ts}

@@ -1,3 +1,3 @@
-import { MOTLYValue } from "motly-ts-interface";
+import { MOTLYValue } from "../../interface/src/types";
 /** Deep clone a MOTLYValue. */
 export declare function cloneValue(value: MOTLYValue): MOTLYValue;

package/build/{clone.js → parser/src/clone.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cloneValue = cloneValue;
-const motly_ts_interface_1 = require("motly-ts-interface");
+const types_1 = require("../../interface/src/types");
 /** Deep clone a MOTLYValue. */
 function cloneValue(value) {
     const result = {};
@@ -14,10 +14,10 @@ function cloneValue(value) {
         else if (Array.isArray(value.eq)) {
             result.eq = value.eq.map(cloneValue);
         }
-        else if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+        else if ((0, types_1.isRef)(value.eq)) {
             result.eq = { linkTo: value.eq.linkTo };
         }
-        else if ((0, motly_ts_interface_1.isEnvRef)(value.eq)) {
+        else if ((0, types_1.isEnvRef)(value.eq)) {
             result.eq = { env: value.eq.env };
         }
         else {

package/build/{index.d.ts → parser/src/index.d.ts}

@@ -1,3 +1,3 @@
-export type { MOTLYScalar, MOTLYRef, MOTLYEnvRef, MOTLYValue, MOTLYNode, MOTLYError, MOTLYSchemaError, MOTLYValidationError, } from "motly-ts-interface";
-export { isRef, isEnvRef } from "motly-ts-interface";
+export type { MOTLYScalar, MOTLYRef, MOTLYEnvRef, MOTLYValue, MOTLYNode, MOTLYError, MOTLYSchemaError, MOTLYValidationError, } from "../../interface/src/types";
+export { isRef, isEnvRef } from "../../interface/src/types";
 export { MOTLYSession } from "./session";

package/build/{index.js → parser/src/index.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MOTLYSession = exports.isEnvRef = exports.isRef = void 0;
-var motly_ts_interface_1 = require("motly-ts-interface");
-Object.defineProperty(exports, "isRef", { enumerable: true, get: function () { return motly_ts_interface_1.isRef; } });
-Object.defineProperty(exports, "isEnvRef", { enumerable: true, get: function () { return motly_ts_interface_1.isEnvRef; } });
+var types_1 = require("../../interface/src/types");
+Object.defineProperty(exports, "isRef", { enumerable: true, get: function () { return types_1.isRef; } });
+Object.defineProperty(exports, "isEnvRef", { enumerable: true, get: function () { return types_1.isEnvRef; } });
 var session_1 = require("./session");
 Object.defineProperty(exports, "MOTLYSession", { enumerable: true, get: function () { return session_1.MOTLYSession; } });

package/build/{interpreter.d.ts → parser/src/interpreter.d.ts}

@@ -1,4 +1,4 @@
 import { Statement } from "./ast";
-import { MOTLYValue, MOTLYError } from "motly-ts-interface";
+import { MOTLYValue, MOTLYError } from "../../interface/src/types";
 /** Execute a list of parsed statements against an existing MOTLYValue. */
 export declare function execute(statements: Statement[], root: MOTLYValue): MOTLYError[];

package/build/{interpreter.js → parser/src/interpreter.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.execute = execute;
-const motly_ts_interface_1 = require("motly-ts-interface");
+const types_1 = require("../../interface/src/types");
 const clone_1 = require("./clone");
 /** Execute a list of parsed statements against an existing MOTLYValue. */
 function execute(statements, root) {
@@ -280,7 +280,7 @@ function cloneError(message) {
  * if N > D. Absolute references (ups=0) are left alone.
  */
 function sanitizeClonedRefs(node, depth, errors) {
-    if ((0, motly_ts_interface_1.isRef)(node.eq)) {
+    if ((0, types_1.isRef)(node.eq)) {
         const parsed = parseRefUps(node.eq.linkTo);
         if (parsed.ups > 0 && parsed.ups > depth) {
             const zero = { line: 0, column: 0, offset: 0 };

package/build/{session.d.ts → parser/src/session.d.ts}

@@ -1,4 +1,4 @@
-import { MOTLYValue, MOTLYError, MOTLYSchemaError, MOTLYValidationError } from "motly-ts-interface";
+import { MOTLYValue, MOTLYError, MOTLYSchemaError, MOTLYValidationError } from "../../interface/src/types";
 /**
  * A stateful MOTLY parsing session.
  *

package/build/{validate.d.ts → parser/src/validate.d.ts}

@@ -1,3 +1,3 @@
-import { MOTLYValue, MOTLYSchemaError, MOTLYValidationError } from "motly-ts-interface";
+import { MOTLYValue, MOTLYSchemaError, MOTLYValidationError } from "../../interface/src/types";
 export declare function validateReferences(root: MOTLYValue): MOTLYValidationError[];
 export declare function validateSchema(tag: MOTLYValue, schema: MOTLYValue): MOTLYSchemaError[];

package/build/{validate.js → parser/src/validate.js}

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateReferences = validateReferences;
 exports.validateSchema = validateSchema;
-const motly_ts_interface_1 = require("motly-ts-interface");
+const types_1 = require("../../interface/src/types");
 function getEqString(node) {
     return typeof node.eq === "string" ? node.eq : undefined;
 }
 function valueEqString(node) {
-    if ((0, motly_ts_interface_1.isRef)(node.eq) || (0, motly_ts_interface_1.isEnvRef)(node.eq))
+    if ((0, types_1.isRef)(node.eq) || (0, types_1.isEnvRef)(node.eq))
         return undefined;
     return getEqString(node);
 }
@@ -15,7 +15,7 @@ function extractSection(node, name) {
     if (!node.properties)
         return undefined;
     const section = node.properties[name];
-    if (section === undefined || (0, motly_ts_interface_1.isRef)(section.eq) || (0, motly_ts_interface_1.isEnvRef)(section.eq))
+    if (section === undefined || (0, types_1.isRef)(section.eq) || (0, types_1.isEnvRef)(section.eq))
         return undefined;
     return section.properties;
 }
@@ -38,7 +38,7 @@ function walkRefs(node, path, ancestors, root, errors) {
             path.push(key);
             // Check if child's eq is a reference (checked at property level
             // to maintain correct ancestor depth for reference resolution)
-            if ((0, motly_ts_interface_1.isRef)(child.eq)) {
+            if ((0, types_1.isRef)(child.eq)) {
                 const errMsg = checkLink(child.eq, ancestors, root);
                 if (errMsg !== null) {
                     errors.push({
@@ -62,7 +62,7 @@ function walkArrayRefs(arr, path, ancestors, parentNode, root, errors) {
         const idxKey = `[${i}]`;
         path.push(idxKey);
         // Check if element's eq is a reference
-        if ((0, motly_ts_interface_1.isRef)(elem.eq)) {
+        if ((0, types_1.isRef)(elem.eq)) {
             const errMsg = checkLink(elem.eq, ancestors, root);
             if (errMsg !== null) {
                 errors.push({
@@ -183,7 +183,7 @@ function getAdditionalPolicy(schema) {
     const additional = schema.properties["Additional"];
     if (additional === undefined)
         return { kind: "reject" };
-    if ((0, motly_ts_interface_1.isRef)(additional.eq))
+    if ((0, types_1.isRef)(additional.eq))
         return { kind: "reject" };
     const eqStr = getEqString(additional);
     if (eqStr !== undefined) {
@@ -262,12 +262,12 @@ function makeTypeSpecNode(typeName) {
     return { eq: typeName };
 }
 function validateValueType(value, typeSpec, types, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(typeSpec.eq))
+    if ((0, types_1.isRef)(typeSpec.eq))
         return;
     // Check for union type (oneOf)
     if (typeSpec.properties) {
         const oneOf = typeSpec.properties["oneOf"];
-        if (oneOf !== undefined && !(0, motly_ts_interface_1.isRef)(oneOf.eq)) {
+        if (oneOf !== undefined && !(0, types_1.isRef)(oneOf.eq)) {
             validateUnion(value, oneOf, types, path, errors);
             return;
         }
@@ -275,14 +275,14 @@ function validateValueType(value, typeSpec, types, path, errors) {
     // Check for enum (eq) or pattern (matches)
     if (typeSpec.properties) {
         const eqProp = typeSpec.properties["eq"];
-        if (eqProp !== undefined && !(0, motly_ts_interface_1.isRef)(eqProp.eq)) {
+        if (eqProp !== undefined && !(0, types_1.isRef)(eqProp.eq)) {
             if (Array.isArray(eqProp.eq)) {
                 validateEnum(value, eqProp.eq, path, errors);
                 return;
             }
         }
         const matchesProp = typeSpec.properties["matches"];
-        if (matchesProp !== undefined && !(0, motly_ts_interface_1.isRef)(matchesProp.eq)) {
+        if (matchesProp !== undefined && !(0, types_1.isRef)(matchesProp.eq)) {
             const baseType = getEqString(typeSpec);
             if (baseType !== undefined) {
                 validateBaseType(value, baseType, types, path, errors);
@@ -299,7 +299,7 @@ function validateValueType(value, typeSpec, types, path, errors) {
             ("Required" in typeSpec.properties ||
                 "Optional" in typeSpec.properties ||
                 "Additional" in typeSpec.properties)) {
-            if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+            if ((0, types_1.isRef)(value.eq)) {
                 errors.push({
                     message: "Expected a tag but found a link",
                     path: [...path],
@@ -368,7 +368,7 @@ function validateBaseType(value, typeName, types, path, errors) {
     }
 }
 function validateTypeString(value, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: 'Expected type "string" but found a link',
             path: [...path],
@@ -385,7 +385,7 @@ function validateTypeString(value, path, errors) {
     }
 }
 function validateTypeNumber(value, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: 'Expected type "number" but found a link',
             path: [...path],
@@ -402,7 +402,7 @@ function validateTypeNumber(value, path, errors) {
     }
 }
 function validateTypeBoolean(value, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: 'Expected type "boolean" but found a link',
             path: [...path],
@@ -419,7 +419,7 @@ function validateTypeBoolean(value, path, errors) {
     }
 }
 function validateTypeDate(value, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: 'Expected type "date" but found a link',
             path: [...path],
@@ -436,7 +436,7 @@ function validateTypeDate(value, path, errors) {
     }
 }
 function validateTypeTag(value, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: 'Expected type "tag" but found a link',
             path: [...path],
@@ -445,7 +445,7 @@ function validateTypeTag(value, path, errors) {
     }
 }
 function validateTypeFlag(value, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: 'Expected type "flag" but found a link',
             path: [...path],
@@ -454,7 +454,7 @@ function validateTypeFlag(value, path, errors) {
     }
 }
 function validateArrayType(value, innerType, types, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: `Expected type "${innerType}[]" but found a link`,
             path: [...path],
@@ -476,7 +476,7 @@ function validateArrayType(value, innerType, types, path, errors) {
     }
 }
 function validateEnum(value, allowed, path, errors) {
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: "Expected an enum value but found a link",
             path: [...path],
@@ -498,7 +498,7 @@ function validateEnum(value, allowed, path, errors) {
         return;
     }
     const matches = allowed.some((a) => {
-        if ((0, motly_ts_interface_1.isRef)(a.eq))
+        if ((0, types_1.isRef)(a.eq))
             return false;
         const aeq = a.eq;
         if (aeq instanceof Date && nodeEq instanceof Date) {
@@ -508,7 +508,7 @@ function validateEnum(value, allowed, path, errors) {
     });
     if (!matches) {
         const allowedStrs = allowed
-            .filter((a) => !(0, motly_ts_interface_1.isRef)(a.eq))
+            .filter((a) => !(0, types_1.isRef)(a.eq))
             .map((a) => {
             const aeq = a.eq;
             return JSON.stringify(String(aeq));
@@ -524,7 +524,7 @@ function validatePattern(value, matchesNode, path, errors) {
     const pattern = getEqString(matchesNode);
     if (pattern === undefined)
         return;
-    if ((0, motly_ts_interface_1.isRef)(value.eq)) {
+    if ((0, types_1.isRef)(value.eq)) {
         errors.push({
             message: "Expected a value matching a pattern but found a link",
             path: [...path],

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@malloydata/motly-ts-parser",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MOTLY text to wire format parser — pure TypeScript",
   "license": "MIT",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "main": "build/parser/src/index.js",
+  "types": "build/parser/src/index.d.ts",
   "files": [
     "build/"
   ],
@@ -25,7 +25,6 @@
   },
   "devDependencies": {
     "@types/node": "^25.2.2",
-    "motly-ts-interface": "file:../interface",
     "typescript": "^5.0.0"
   }
 }