@glyphjs/parser 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Glyph JS Contributors
+
+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,45 @@
+# @glyphjs/parser
+
+Markdown parser with a remark plugin for `ui:` fenced code blocks.
+
+## Install
+
+```bash
+pnpm add @glyphjs/parser
+```
+
+## Usage
+
+```ts
+import { parseGlyphMarkdown } from '@glyphjs/parser';
+
+const markdown = `
+# Hello
+
+\`\`\`ui:graph
+nodes:
+  - id: a
+    label: Node A
+edges:
+  - from: a
+    to: b
+\`\`\`
+`;
+
+const ast = parseGlyphMarkdown(markdown);
+```
+
+### Using the remark plugin directly
+
+```ts
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import { remarkGlyph } from '@glyphjs/parser';
+
+const processor = unified().use(remarkParse).use(remarkGlyph);
+const tree = processor.parse(markdown);
+```
+
+## Docs
+
+https://github.com/VledicFranco/glyphjs

package/dist/index.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+var yaml = require('yaml');
+var unified = require('unified');
+var remarkParse = require('remark-parse');
+var remarkFrontmatter = require('remark-frontmatter');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var remarkParse__default = /*#__PURE__*/_interopDefault(remarkParse);
+var remarkFrontmatter__default = /*#__PURE__*/_interopDefault(remarkFrontmatter);
+
+// src/plugin.ts
+var DEFAULT_POSITION = {
+  start: { line: 0, column: 0 },
+  end: { line: 0, column: 0 }
+};
+var remarkGlyph = function() {
+  return (tree) => {
+    transformTree(tree);
+  };
+};
+function isRawRef(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj["target"] === "string";
+}
+function transformTree(node) {
+  if (!("children" in node) || !Array.isArray(node.children)) return;
+  for (let i = 0; i < node.children.length; i++) {
+    const child = node.children[i];
+    if (!child) continue;
+    if (child.type === "code") {
+      const codeNode = child;
+      if (codeNode.lang && codeNode.lang.startsWith("ui:")) {
+        const glyphBlock = codeNodeToGlyphUIBlock(codeNode);
+        node.children[i] = glyphBlock;
+        continue;
+      }
+    }
+    if ("children" in child && Array.isArray(child.children)) {
+      transformTree(child);
+    }
+  }
+}
+function codeNodeToGlyphUIBlock(node) {
+  const lang = node.lang ?? "";
+  const componentType = lang.slice(3);
+  const rawYaml = node.value;
+  let parsedData = null;
+  let yamlError;
+  let glyphId;
+  let refs;
+  try {
+    const parsed = yaml.parse(rawYaml);
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+      const data = parsed;
+      if ("glyph-id" in data && typeof data["glyph-id"] === "string") {
+        glyphId = data["glyph-id"];
+        delete data["glyph-id"];
+      }
+      if ("refs" in data && Array.isArray(data["refs"])) {
+        const rawRefs = data["refs"];
+        const validRefs = rawRefs.filter(isRawRef);
+        if (validRefs.length > 0) {
+          refs = validRefs;
+        }
+        delete data["refs"];
+      }
+      parsedData = data;
+    } else {
+      parsedData = null;
+      yamlError = "YAML payload must be an object (mapping), got " + typeof parsed;
+    }
+  } catch (err) {
+    parsedData = null;
+    yamlError = err instanceof Error ? err.message : String(err);
+  }
+  const position = node.position ?? DEFAULT_POSITION;
+  const block = {
+    type: "glyphUIBlock",
+    componentType,
+    rawYaml,
+    parsedData,
+    position
+  };
+  if (yamlError !== void 0) {
+    block.yamlError = yamlError;
+  }
+  if (glyphId !== void 0) {
+    block.glyphId = glyphId;
+  }
+  if (refs !== void 0) {
+    block.refs = refs;
+  }
+  return block;
+}
+function parseGlyphMarkdown(markdown) {
+  const processor = unified.unified().use(remarkParse__default.default).use(remarkFrontmatter__default.default, ["yaml"]).use(remarkGlyph);
+  const tree = processor.parse(markdown);
+  const result = processor.runSync(tree);
+  return result;
+}
+
+exports.parseGlyphMarkdown = parseGlyphMarkdown;
+exports.remarkGlyph = remarkGlyph;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts","../src/parse.ts"],"names":["parseYaml","unified","remarkParse","remarkFrontmatter"],"mappings":";;;;;;;;;;;;;AAMA,IAAM,gBAAA,GAAmC;AAAA,EACvC,KAAA,EAAO,EAAE,IAAA,EAAM,CAAA,EAAG,QAAQ,CAAA,EAAE;AAAA,EAC5B,GAAA,EAAK,EAAE,IAAA,EAAM,CAAA,EAAG,QAAQ,CAAA;AAC1B,CAAA;AAYO,IAAM,cAAqC,WAAY;AAC5D,EAAA,OAAO,CAAC,IAAA,KAAoB;AAC1B,IAAA,aAAA,CAAc,IAAI,CAAA;AAAA,EACpB,CAAA;AACF;AAKA,SAAS,SAAS,KAAA,EAAiC;AACjD,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,MAAM,OAAO,KAAA;AACxD,EAAA,MAAM,GAAA,GAAM,KAAA;AACZ,EAAA,OAAO,OAAO,GAAA,CAAI,QAAQ,CAAA,KAAM,QAAA;AAClC;AAMA,SAAS,cAAc,IAAA,EAAgC;AACrD,EAAA,IAAI,EAAE,cAAc,IAAA,CAAA,IAAS,CAAC,MAAM,OAAA,CAAQ,IAAA,CAAK,QAAQ,CAAA,EAAG;AAE5D,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAA,CAAS,QAAQ,CAAA,EAAA,EAAK;AAC7C,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,QAAA,CAAS,CAAC,CAAA;AAC7B,IAAA,IAAI,CAAC,KAAA,EAAO;AAEZ,IAAA,IAAI,KAAA,CAAM,SAAS,MAAA,EAAQ;AACzB,MAAA,MAAM,QAAA,GAAW,KAAA;AACjB,MAAA,IAAI,SAAS,IAAA,IAAQ,QAAA,CAAS,IAAA,CAAK,UAAA,CAAW,KAAK,CAAA,EAAG;AACpD,QAAA,MAAM,UAAA,GAAa,uBAAuB,QAAQ,CAAA;AAElD,QAAC,IAAA,CAAK,QAAA,CAAuB,CAAC,CAAA,GAAI,UAAA;AAClC,QAAA;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,cAAc,KAAA,IAAS,KAAA,CAAM,OAAA,CAAS,KAAA,CAAiB,QAAQ,CAAA,EAAG;AACpE,MAAA,aAAA,CAAc,KAAe,CAAA;AAAA,IAC/B;AAAA,EACF;AACF;AAMA,SAAS,uBAAuB,IAAA,EAA0B;AACxD,EAAA,MAAM,IAAA,GAAO,KAAK,IAAA,IAAQ,EAAA;AAC1B,EAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA;AAClC,EAAA,MAAM,UAAU,IAAA,CAAK,KAAA;AAErB,EAAA,IAAI,UAAA,GAA6C,IAAA;AACjD,EAAA,IAAI,SAAA;AACJ,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI,IAAA;AAEJ,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAkBA,WAAU,OAAO,CAAA;AAEzC,IAAA,IAAI,MAAA,KAAW,QAAQ,OAAO,MAAA,KAAW,YAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG;AAC3E,MAAA,MAAM,IAAA,GAAO,MAAA;AAGb,MAAA,IAAI,cAAc,IAAA,IAAQ,OAAO,IAAA,CAAK,UAAU,MAAM,QAAA,EAAU;AAC9D,QAAA,OAAA,GAAU,KAAK,UAAU,CAAA;AACzB,QAAA,OAAO,KAAK,UAAU,CAAA;AAAA,MACxB;AAGA,MAAA,IAAI,UAAU,IAAA,IAAQ,KAAA,CAAM,QAAQ,IAAA,CAAK,MAAM,CAAC,CAAA,EAAG;AACjD,QAAA,MAAM,OAAA,GAAU,KAAK,MAAM,CAAA;AAC3B,QAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,MAAA,CAAO,QAAQ,CAAA;AACzC,QAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACxB,UAAA,IAAA,GAAO,SAAA;AAAA,QACT;AACA,QAAA,OAAO,KAAK,MAAM,CAAA;AAAA,MACpB;AAEA,MAAA,UAAA,GAAa,IAAA;AAAA,IACf,CAAA,MAAO;AAEL,MAAA,UAAA,GAAa,IAAA;AACb,MAAA,SAAA,GAAY,mDAAmD,OAAO,MAAA;AAAA,IACxE;AAAA,EACF,SAAS,GAAA,EAAc;AACrB,IAAA,UAAA,GAAa,IAAA;AACb,IAAA,SAAA,GAAY,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAAA,EAC7D;AAEA,EAAA,MAAM,QAAA,GAA2B,KAAK,QAAA,IAAY,gBAAA;AAElD,EAAA,MAAM,KAAA,GAAsB;AAAA,IAC1B,IAAA,EAAM,cAAA;AAAA,IACN,aAAA;AAAA,IACA,OAAA;AAAA,IACA,UAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,IAAA,KAAA,CAAM,SAAA,GAAY,SAAA;AAAA,EACpB;AACA,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,KAAA,CAAM,OAAA,GAAU,OAAA;AAAA,EAClB;AACA,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,KAAA,CAAM,IAAA,GAAO,IAAA;AAAA,EACf;AAEA,EAAA,OAAO,KAAA;AACT;ACtHO,SAAS,mBAAmB,QAAA,EAA6B;AAC9D,EAAA,MAAM,SAAA,GAAYC,eAAA,EAAQ,CACvB,GAAA,CAAIC,4BAAW,CAAA,CACf,GAAA,CAAIC,kCAAA,EAAmB,CAAC,MAAM,CAAC,CAAA,CAC/B,IAAI,WAAW,CAAA;AAElB,EAAA,MAAM,IAAA,GAAO,SAAA,CAAU,KAAA,CAAM,QAAQ,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,SAAA,CAAU,OAAA,CAAQ,IAAI,CAAA;AACrC,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["import type { Root as MdastRoot, Code, Parent } from 'mdast';\nimport type { Plugin } from 'unified';\nimport type { GlyphUIBlock, RawRef, SourcePosition } from '@glyphjs/types';\nimport { parse as parseYaml } from 'yaml';\n\n/** Default position used when a code node has no position info. */\nconst DEFAULT_POSITION: SourcePosition = {\n  start: { line: 0, column: 0 },\n  end: { line: 0, column: 0 },\n};\n\n/**\n * Remark plugin that transforms `ui:` fenced code blocks into GlyphUIBlock AST nodes.\n *\n * How it works:\n * 1. Walk the MDAST tree looking for `code` nodes whose `lang` starts with \"ui:\"\n * 2. Parse the YAML payload from the code block's value\n * 3. Extract `glyph-id` and `refs` from the parsed data\n * 4. Replace the code node with a GlyphUIBlock node\n * 5. Standard Markdown nodes pass through unchanged\n */\nexport const remarkGlyph: Plugin<[], MdastRoot> = function () {\n  return (tree: MdastRoot) => {\n    transformTree(tree);\n  };\n};\n\n/**\n * Check whether a value is a valid RawRef object.\n */\nfunction isRawRef(value: unknown): value is RawRef {\n  if (typeof value !== 'object' || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return typeof obj['target'] === 'string';\n}\n\n/**\n * Recursively walk the MDAST tree and replace `ui:` code blocks\n * with GlyphUIBlock nodes in-place.\n */\nfunction transformTree(node: MdastRoot | Parent): void {\n  if (!('children' in node) || !Array.isArray(node.children)) return;\n\n  for (let i = 0; i < node.children.length; i++) {\n    const child = node.children[i];\n    if (!child) continue;\n\n    if (child.type === 'code') {\n      const codeNode = child as Code;\n      if (codeNode.lang && codeNode.lang.startsWith('ui:')) {\n        const glyphBlock = codeNodeToGlyphUIBlock(codeNode);\n        // Replace the code node with the GlyphUIBlock node in the children array\n        (node.children as unknown[])[i] = glyphBlock;\n        continue;\n      }\n    }\n\n    // Recurse into nodes that have children (e.g., blockquotes, lists, list items)\n    if ('children' in child && Array.isArray((child as Parent).children)) {\n      transformTree(child as Parent);\n    }\n  }\n}\n\n/**\n * Convert a `code` MDAST node with a `ui:` lang into a GlyphUIBlock AST node.\n * Precondition: `node.lang` is defined and starts with \"ui:\".\n */\nfunction codeNodeToGlyphUIBlock(node: Code): GlyphUIBlock {\n  const lang = node.lang ?? '';\n  const componentType = lang.slice(3); // Remove \"ui:\" prefix\n  const rawYaml = node.value;\n\n  let parsedData: Record<string, unknown> | null = null;\n  let yamlError: string | undefined;\n  let glyphId: string | undefined;\n  let refs: RawRef[] | undefined;\n\n  try {\n    const parsed: unknown = parseYaml(rawYaml);\n\n    if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      const data = parsed as Record<string, unknown>;\n\n      // Extract glyph-id if present\n      if ('glyph-id' in data && typeof data['glyph-id'] === 'string') {\n        glyphId = data['glyph-id'];\n        delete data['glyph-id'];\n      }\n\n      // Extract refs if present and is an array\n      if ('refs' in data && Array.isArray(data['refs'])) {\n        const rawRefs = data['refs'] as unknown[];\n        const validRefs = rawRefs.filter(isRawRef);\n        if (validRefs.length > 0) {\n          refs = validRefs;\n        }\n        delete data['refs'];\n      }\n\n      parsedData = data;\n    } else {\n      // YAML parsed to a non-object (e.g., scalar or array at root)\n      parsedData = null;\n      yamlError = 'YAML payload must be an object (mapping), got ' + typeof parsed;\n    }\n  } catch (err: unknown) {\n    parsedData = null;\n    yamlError = err instanceof Error ? err.message : String(err);\n  }\n\n  const position: SourcePosition = node.position ?? DEFAULT_POSITION;\n\n  const block: GlyphUIBlock = {\n    type: 'glyphUIBlock',\n    componentType,\n    rawYaml,\n    parsedData,\n    position,\n  };\n\n  if (yamlError !== undefined) {\n    block.yamlError = yamlError;\n  }\n  if (glyphId !== undefined) {\n    block.glyphId = glyphId;\n  }\n  if (refs !== undefined) {\n    block.refs = refs;\n  }\n\n  return block;\n}\n","import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkFrontmatter from 'remark-frontmatter';\nimport type { GlyphRoot } from '@glyphjs/types';\nimport { remarkGlyph } from './plugin.js';\n\n/**\n * Parse a Glyph Markdown string into a GlyphRoot AST.\n *\n * Sets up a unified pipeline with:\n * 1. remark-parse — standard Markdown parsing\n * 2. remark-frontmatter — YAML frontmatter support\n * 3. remarkGlyph — transforms ui: fenced blocks into GlyphUIBlock nodes\n */\nexport function parseGlyphMarkdown(markdown: string): GlyphRoot {\n  const processor = unified()\n    .use(remarkParse)\n    .use(remarkFrontmatter, ['yaml'])\n    .use(remarkGlyph);\n\n  const tree = processor.parse(markdown);\n  const result = processor.runSync(tree);\n  return result as unknown as GlyphRoot;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+import { Root } from 'mdast';
+import { Plugin } from 'unified';
+import { GlyphRoot } from '@glyphjs/types';
+
+/**
+ * Remark plugin that transforms `ui:` fenced code blocks into GlyphUIBlock AST nodes.
+ *
+ * How it works:
+ * 1. Walk the MDAST tree looking for `code` nodes whose `lang` starts with "ui:"
+ * 2. Parse the YAML payload from the code block's value
+ * 3. Extract `glyph-id` and `refs` from the parsed data
+ * 4. Replace the code node with a GlyphUIBlock node
+ * 5. Standard Markdown nodes pass through unchanged
+ */
+declare const remarkGlyph: Plugin<[], Root>;
+
+/**
+ * Parse a Glyph Markdown string into a GlyphRoot AST.
+ *
+ * Sets up a unified pipeline with:
+ * 1. remark-parse — standard Markdown parsing
+ * 2. remark-frontmatter — YAML frontmatter support
+ * 3. remarkGlyph — transforms ui: fenced blocks into GlyphUIBlock nodes
+ */
+declare function parseGlyphMarkdown(markdown: string): GlyphRoot;
+
+export { parseGlyphMarkdown, remarkGlyph };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { Root } from 'mdast';
+import { Plugin } from 'unified';
+import { GlyphRoot } from '@glyphjs/types';
+
+/**
+ * Remark plugin that transforms `ui:` fenced code blocks into GlyphUIBlock AST nodes.
+ *
+ * How it works:
+ * 1. Walk the MDAST tree looking for `code` nodes whose `lang` starts with "ui:"
+ * 2. Parse the YAML payload from the code block's value
+ * 3. Extract `glyph-id` and `refs` from the parsed data
+ * 4. Replace the code node with a GlyphUIBlock node
+ * 5. Standard Markdown nodes pass through unchanged
+ */
+declare const remarkGlyph: Plugin<[], Root>;
+
+/**
+ * Parse a Glyph Markdown string into a GlyphRoot AST.
+ *
+ * Sets up a unified pipeline with:
+ * 1. remark-parse — standard Markdown parsing
+ * 2. remark-frontmatter — YAML frontmatter support
+ * 3. remarkGlyph — transforms ui: fenced blocks into GlyphUIBlock nodes
+ */
+declare function parseGlyphMarkdown(markdown: string): GlyphRoot;
+
+export { parseGlyphMarkdown, remarkGlyph };

package/dist/index.js

@@ -0,0 +1,100 @@
+import { parse } from 'yaml';
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkFrontmatter from 'remark-frontmatter';
+
+// src/plugin.ts
+var DEFAULT_POSITION = {
+  start: { line: 0, column: 0 },
+  end: { line: 0, column: 0 }
+};
+var remarkGlyph = function() {
+  return (tree) => {
+    transformTree(tree);
+  };
+};
+function isRawRef(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj["target"] === "string";
+}
+function transformTree(node) {
+  if (!("children" in node) || !Array.isArray(node.children)) return;
+  for (let i = 0; i < node.children.length; i++) {
+    const child = node.children[i];
+    if (!child) continue;
+    if (child.type === "code") {
+      const codeNode = child;
+      if (codeNode.lang && codeNode.lang.startsWith("ui:")) {
+        const glyphBlock = codeNodeToGlyphUIBlock(codeNode);
+        node.children[i] = glyphBlock;
+        continue;
+      }
+    }
+    if ("children" in child && Array.isArray(child.children)) {
+      transformTree(child);
+    }
+  }
+}
+function codeNodeToGlyphUIBlock(node) {
+  const lang = node.lang ?? "";
+  const componentType = lang.slice(3);
+  const rawYaml = node.value;
+  let parsedData = null;
+  let yamlError;
+  let glyphId;
+  let refs;
+  try {
+    const parsed = parse(rawYaml);
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+      const data = parsed;
+      if ("glyph-id" in data && typeof data["glyph-id"] === "string") {
+        glyphId = data["glyph-id"];
+        delete data["glyph-id"];
+      }
+      if ("refs" in data && Array.isArray(data["refs"])) {
+        const rawRefs = data["refs"];
+        const validRefs = rawRefs.filter(isRawRef);
+        if (validRefs.length > 0) {
+          refs = validRefs;
+        }
+        delete data["refs"];
+      }
+      parsedData = data;
+    } else {
+      parsedData = null;
+      yamlError = "YAML payload must be an object (mapping), got " + typeof parsed;
+    }
+  } catch (err) {
+    parsedData = null;
+    yamlError = err instanceof Error ? err.message : String(err);
+  }
+  const position = node.position ?? DEFAULT_POSITION;
+  const block = {
+    type: "glyphUIBlock",
+    componentType,
+    rawYaml,
+    parsedData,
+    position
+  };
+  if (yamlError !== void 0) {
+    block.yamlError = yamlError;
+  }
+  if (glyphId !== void 0) {
+    block.glyphId = glyphId;
+  }
+  if (refs !== void 0) {
+    block.refs = refs;
+  }
+  return block;
+}
+function parseGlyphMarkdown(markdown) {
+  const processor = unified().use(remarkParse).use(remarkFrontmatter, ["yaml"]).use(remarkGlyph);
+  const tree = processor.parse(markdown);
+  const result = processor.runSync(tree);
+  return result;
+}
+
+export { parseGlyphMarkdown, remarkGlyph };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts","../src/parse.ts"],"names":["parseYaml"],"mappings":"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","file":"index.js","sourcesContent":["import type { Root as MdastRoot, Code, Parent } from 'mdast';\nimport type { Plugin } from 'unified';\nimport type { GlyphUIBlock, RawRef, SourcePosition } from '@glyphjs/types';\nimport { parse as parseYaml } from 'yaml';\n\n/** Default position used when a code node has no position info. */\nconst DEFAULT_POSITION: SourcePosition = {\n  start: { line: 0, column: 0 },\n  end: { line: 0, column: 0 },\n};\n\n/**\n * Remark plugin that transforms `ui:` fenced code blocks into GlyphUIBlock AST nodes.\n *\n * How it works:\n * 1. Walk the MDAST tree looking for `code` nodes whose `lang` starts with \"ui:\"\n * 2. Parse the YAML payload from the code block's value\n * 3. Extract `glyph-id` and `refs` from the parsed data\n * 4. Replace the code node with a GlyphUIBlock node\n * 5. Standard Markdown nodes pass through unchanged\n */\nexport const remarkGlyph: Plugin<[], MdastRoot> = function () {\n  return (tree: MdastRoot) => {\n    transformTree(tree);\n  };\n};\n\n/**\n * Check whether a value is a valid RawRef object.\n */\nfunction isRawRef(value: unknown): value is RawRef {\n  if (typeof value !== 'object' || value === null) return false;\n  const obj = value as Record<string, unknown>;\n  return typeof obj['target'] === 'string';\n}\n\n/**\n * Recursively walk the MDAST tree and replace `ui:` code blocks\n * with GlyphUIBlock nodes in-place.\n */\nfunction transformTree(node: MdastRoot | Parent): void {\n  if (!('children' in node) || !Array.isArray(node.children)) return;\n\n  for (let i = 0; i < node.children.length; i++) {\n    const child = node.children[i];\n    if (!child) continue;\n\n    if (child.type === 'code') {\n      const codeNode = child as Code;\n      if (codeNode.lang && codeNode.lang.startsWith('ui:')) {\n        const glyphBlock = codeNodeToGlyphUIBlock(codeNode);\n        // Replace the code node with the GlyphUIBlock node in the children array\n        (node.children as unknown[])[i] = glyphBlock;\n        continue;\n      }\n    }\n\n    // Recurse into nodes that have children (e.g., blockquotes, lists, list items)\n    if ('children' in child && Array.isArray((child as Parent).children)) {\n      transformTree(child as Parent);\n    }\n  }\n}\n\n/**\n * Convert a `code` MDAST node with a `ui:` lang into a GlyphUIBlock AST node.\n * Precondition: `node.lang` is defined and starts with \"ui:\".\n */\nfunction codeNodeToGlyphUIBlock(node: Code): GlyphUIBlock {\n  const lang = node.lang ?? '';\n  const componentType = lang.slice(3); // Remove \"ui:\" prefix\n  const rawYaml = node.value;\n\n  let parsedData: Record<string, unknown> | null = null;\n  let yamlError: string | undefined;\n  let glyphId: string | undefined;\n  let refs: RawRef[] | undefined;\n\n  try {\n    const parsed: unknown = parseYaml(rawYaml);\n\n    if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {\n      const data = parsed as Record<string, unknown>;\n\n      // Extract glyph-id if present\n      if ('glyph-id' in data && typeof data['glyph-id'] === 'string') {\n        glyphId = data['glyph-id'];\n        delete data['glyph-id'];\n      }\n\n      // Extract refs if present and is an array\n      if ('refs' in data && Array.isArray(data['refs'])) {\n        const rawRefs = data['refs'] as unknown[];\n        const validRefs = rawRefs.filter(isRawRef);\n        if (validRefs.length > 0) {\n          refs = validRefs;\n        }\n        delete data['refs'];\n      }\n\n      parsedData = data;\n    } else {\n      // YAML parsed to a non-object (e.g., scalar or array at root)\n      parsedData = null;\n      yamlError = 'YAML payload must be an object (mapping), got ' + typeof parsed;\n    }\n  } catch (err: unknown) {\n    parsedData = null;\n    yamlError = err instanceof Error ? err.message : String(err);\n  }\n\n  const position: SourcePosition = node.position ?? DEFAULT_POSITION;\n\n  const block: GlyphUIBlock = {\n    type: 'glyphUIBlock',\n    componentType,\n    rawYaml,\n    parsedData,\n    position,\n  };\n\n  if (yamlError !== undefined) {\n    block.yamlError = yamlError;\n  }\n  if (glyphId !== undefined) {\n    block.glyphId = glyphId;\n  }\n  if (refs !== undefined) {\n    block.refs = refs;\n  }\n\n  return block;\n}\n","import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkFrontmatter from 'remark-frontmatter';\nimport type { GlyphRoot } from '@glyphjs/types';\nimport { remarkGlyph } from './plugin.js';\n\n/**\n * Parse a Glyph Markdown string into a GlyphRoot AST.\n *\n * Sets up a unified pipeline with:\n * 1. remark-parse — standard Markdown parsing\n * 2. remark-frontmatter — YAML frontmatter support\n * 3. remarkGlyph — transforms ui: fenced blocks into GlyphUIBlock nodes\n */\nexport function parseGlyphMarkdown(markdown: string): GlyphRoot {\n  const processor = unified()\n    .use(remarkParse)\n    .use(remarkFrontmatter, ['yaml'])\n    .use(remarkGlyph);\n\n  const tree = processor.parse(markdown);\n  const result = processor.runSync(tree);\n  return result as unknown as GlyphRoot;\n}\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@glyphjs/parser",
+  "version": "0.1.0",
+  "description": "Markdown parser with remark plugin for ui: fenced blocks",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "unified": "^11.0.5",
+    "remark-parse": "^11.0.0",
+    "remark-frontmatter": "^5.0.0",
+    "yaml": "^2.7.0",
+    "@glyphjs/types": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "@types/unist": "^3.0.3"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "author": "Vledic Franco",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VledicFranco/glyphjs.git",
+    "directory": "packages/parser"
+  },
+  "homepage": "https://github.com/VledicFranco/glyphjs#readme",
+  "bugs": "https://github.com/VledicFranco/glyphjs/issues",
+  "keywords": [
+    "glyph",
+    "glyphjs",
+    "markdown",
+    "react",
+    "ui-components",
+    "interactive-documents",
+    "remark",
+    "parser",
+    "unified",
+    "ast"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist .turbo"
+  }
+}