mdast-control 0.1.0

package/dist/table.js

@@ -0,0 +1,131 @@
+import { parseMarkdown, stringifyAst } from './markdown.js';
+import { applyInsert, applyReplace, queryAst } from './query.js';
+import { tableNodeToModel } from './table-model.js';
+import { csvToTableAst, tableModelToDelimited, tsvToTableAst, } from './table-interchange.js';
+import { addTableColumnNode, deleteTableColumnNode, deleteTableRowNode, insertTableRowNode, sortTableNode, updateTableCellNode, } from './table-structural.js';
+export { flattenTableCellText, getTableCell, resolveSingleTableColumnIndex, resolveTableColumnIndexes, tableNodeToModel, } from './table-model.js';
+export { csvToTableAst, delimitedToTableModel, delimiterForFormat, parseDelimited, tableModelToAst, tableModelToDelimited, tsvToTableAst, } from './table-interchange.js';
+export { addTableColumnNode, deleteTableColumnNode, deleteTableRowNode, insertTableRowNode, sortTableNode, updateTableCellNode, } from './table-structural.js';
+export function extractTableModels(markdown, query) {
+    const matches = queryAst(parseMarkdown(markdown), query);
+    return matches.map((match, index) => {
+        if (match.node.type !== 'table') {
+            throw new Error(`Table extraction query must match only table nodes; match ${String(index)} has type "${match.node.type}"`);
+        }
+        return tableNodeToModel(match.node);
+    });
+}
+export function extractTableModel(markdown, query) {
+    const models = extractTableModels(markdown, query);
+    if (models.length !== 1) {
+        throw new Error(`Table extraction requires exactly one table match, received ${String(models.length)}`);
+    }
+    return models[0];
+}
+export function tableToCsv(markdown, query, options = {}) {
+    return tableModelToDelimited(extractTableModel(markdown, query), ',', options);
+}
+export function tableToTsv(markdown, query, options = {}) {
+    return tableModelToDelimited(extractTableModel(markdown, query), '\t', options);
+}
+export function tableToDelimited(markdown, query, format, options = {}) {
+    return format === 'csv'
+        ? tableToCsv(markdown, query, options)
+        : tableToTsv(markdown, query, options);
+}
+export function csvToMarkdownTable(input, options = {}) {
+    return stringifyTable(csvToTableAst(input, options));
+}
+export function tsvToMarkdownTable(input, options = {}) {
+    return stringifyTable(tsvToTableAst(input, options));
+}
+export function delimitedToMarkdownTable(input, format, options = {}) {
+    return format === 'csv'
+        ? csvToMarkdownTable(input, options)
+        : tsvToMarkdownTable(input, options);
+}
+export function replaceTableWithCsv(markdown, query, csv, options = {}) {
+    return replaceTableWithAst(markdown, query, csvToTableAst(csv, options));
+}
+export function replaceTableWithTsv(markdown, query, tsv, options = {}) {
+    return replaceTableWithAst(markdown, query, tsvToTableAst(tsv, options));
+}
+export function insertCsvAsTable(markdown, query, position, csv, options = {}) {
+    return insertTableAst(markdown, query, position, csvToTableAst(csv, options));
+}
+export function insertTsvAsTable(markdown, query, position, tsv, options = {}) {
+    return insertTableAst(markdown, query, position, tsvToTableAst(tsv, options));
+}
+export function replaceTableWithDelimited(markdown, query, format, input, options = {}) {
+    return format === 'csv'
+        ? replaceTableWithCsv(markdown, query, input, options)
+        : replaceTableWithTsv(markdown, query, input, options);
+}
+export function insertDelimitedAsTable(markdown, query, position, format, input, options = {}) {
+    return format === 'csv'
+        ? insertCsvAsTable(markdown, query, position, input, options)
+        : insertTsvAsTable(markdown, query, position, input, options);
+}
+export function updateTableCell(markdown, query, rowIndex, column, value) {
+    return mutateExactlyOneTable(markdown, query, (table) => updateTableCellNode(table, rowIndex, column, value));
+}
+export function insertTableRow(markdown, query, index, values) {
+    return mutateExactlyOneTable(markdown, query, (table) => {
+        insertTableRowNode(table, index, values);
+        return true;
+    });
+}
+export function deleteTableRow(markdown, query, rowIndex) {
+    return mutateExactlyOneTable(markdown, query, (table) => {
+        deleteTableRowNode(table, rowIndex);
+        return true;
+    });
+}
+export function addTableColumn(markdown, query, index, header, values = []) {
+    return mutateExactlyOneTable(markdown, query, (table) => {
+        addTableColumnNode(table, index, header, values);
+        return true;
+    });
+}
+export function deleteTableColumn(markdown, query, column) {
+    return mutateExactlyOneTable(markdown, query, (table) => {
+        deleteTableColumnNode(table, column);
+        return true;
+    });
+}
+export function sortTable(markdown, query, column, direction) {
+    return mutateExactlyOneTable(markdown, query, (table) => sortTableNode(table, column, direction));
+}
+function stringifyTable(table) {
+    return stringifyAst({ type: 'root', children: [table] });
+}
+function replaceTableWithAst(markdown, query, table) {
+    const tree = parseMarkdown(markdown);
+    const match = requireExactlyOneTableMatch(tree, query, 'Table replacement');
+    return applyReplace(tree, [match], [table]);
+}
+function mutateExactlyOneTable(markdown, query, mutate) {
+    const tree = parseMarkdown(markdown);
+    const match = requireExactlyOneTableMatch(tree, query, 'Table editing');
+    return { tree, changed: mutate(match.node) ? 1 : 0 };
+}
+function insertTableAst(markdown, query, position, table) {
+    const tree = parseMarkdown(markdown);
+    const match = requireExactlyOneMatch(tree, query, 'Table insertion');
+    return applyInsert(tree, [match], position, [table]);
+}
+function requireExactlyOneMatch(tree, query, operation) {
+    const matches = queryAst(tree, query);
+    if (matches.length !== 1) {
+        throw new Error(`${operation} requires exactly one target match, received ${String(matches.length)}`);
+    }
+    return matches[0];
+}
+function requireExactlyOneTableMatch(tree, query, operation) {
+    const match = requireExactlyOneMatch(tree, query, operation);
+    if (match.node.type !== 'table') {
+        throw new Error(`${operation} requires a table match, received "${match.node.type}"`);
+    }
+    return match;
+}
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../src/table.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,6 @@
+import type { MdastNode, QueryMatch } from './types.js';
+export type TransportQueryMatch = {
+    path: number[];
+    node: MdastNode;
+};
+export declare function toTransportMatches(matches: QueryMatch[]): TransportQueryMatch[];

package/dist/transport.js

@@ -0,0 +1,7 @@
+export function toTransportMatches(matches) {
+    return matches.map((match) => ({
+        path: match.path,
+        node: match.node,
+    }));
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export type MdastNode = {
+    type: string;
+    children?: MdastNode[];
+    position?: {
+        start?: {
+            line?: number;
+            column?: number;
+            offset?: number;
+        };
+        end?: {
+            line?: number;
+            column?: number;
+            offset?: number;
+        };
+    };
+    value?: string;
+    depth?: number;
+    ordered?: boolean;
+    spread?: boolean;
+    lang?: string | null;
+    meta?: string | null;
+    url?: string;
+    title?: string | null;
+    alt?: string | null;
+    checked?: boolean | null;
+    identifier?: string;
+    label?: string | null;
+    referenceType?: string;
+    [key: string]: unknown;
+};
+export type QueryOperator = '=' | '*=' | '^=' | '$=' | '!=' | '~=' | '>' | '>=' | '<' | '<=';
+export type QueryPredicate = {
+    field: string;
+    operator: QueryOperator;
+    value: string;
+};
+export type QueryStep = {
+    type: string;
+    predicates: QueryPredicate[];
+    combinator: 'descendant' | 'child';
+};
+export type QueryMatch = {
+    node: MdastNode;
+    parent: MdastNode | null;
+    index: number;
+    path: number[];
+};
+export type InsertPosition = 'before' | 'after' | 'prepend' | 'append';
+export type MoveTargetPolicy = 'exactly-one' | 'first' | 'last';
+export type InsertResult = {
+    tree: MdastNode;
+    inserted: number;
+};
+export type MutationResult = {
+    tree: MdastNode;
+    changed: number;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "mdast-control",
+  "version": "0.1.0",
+  "description": "Markdown AST transformation, querying, and LSP tooling",
+  "license": "MIT",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mako10k/mdast.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mako10k/mdast/issues"
+  },
+  "homepage": "https://github.com/mako10k/mdast#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mdastctl": "dist/cli.js",
+    "mdast-lsp": "dist/lsp/server.js"
+  },
+  "files": [
+    "dist/*.js",
+    "dist/*.js.map",
+    "dist/*.d.ts",
+    "dist/lsp/*.js",
+    "dist/lsp/*.js.map",
+    "dist/lsp/*.d.ts",
+    "scripts/verify-package.mjs"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test dist/test/**/*.test.js",
+    "verify:package": "node scripts/verify-package.mjs"
+  },
+  "keywords": [
+    "markdown",
+    "mdast",
+    "ast",
+    "lsp"
+  ],
+  "dependencies": {
+    "commander": "^14.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0",
+    "vscode-languageserver": "^9.0.1",
+    "vscode-languageserver-textdocument": "^1.0.12"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.3"
+  }
+}

package/scripts/verify-package.mjs

@@ -0,0 +1,252 @@
+import assert from 'node:assert/strict';
+import { execFileSync, spawn } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const packageRoot = fileURLToPath(new URL('..', import.meta.url));
+const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+const tempRoot = mkdtempSync(join(tmpdir(), 'mdast-control-package-'));
+
+try {
+  const archiveDirectory = join(tempRoot, 'archive');
+  const installDirectory = join(tempRoot, 'install');
+  mkdirSync(archiveDirectory);
+  mkdirSync(installDirectory);
+
+  const packResult = JSON.parse(execFileSync(
+    npmCommand,
+    ['pack', '--json', '--pack-destination', archiveDirectory],
+    commandOptions(packageRoot),
+  ))[0];
+  assert.ok(packResult && typeof packResult.filename === 'string', 'npm pack returned no artifact');
+
+  const packedPaths = new Set(packResult.files.map((file) => file.path));
+  const requiredPaths = [
+    'package.json',
+    'README.md',
+    'dist/index.js',
+    'dist/index.d.ts',
+    'dist/cli.js',
+    'dist/cli.d.ts',
+    'dist/lsp/server.js',
+    'dist/lsp/server.d.ts',
+    'scripts/verify-package.mjs',
+  ];
+  for (const requiredPath of requiredPaths) {
+    assert.ok(packedPaths.has(requiredPath), `package is missing ${requiredPath}`);
+  }
+  assert.equal(
+    packResult.files.some((file) => file.path.startsWith('dist/test/')),
+    false,
+    'package must not include compiled tests',
+  );
+
+  const archivePath = join(archiveDirectory, packResult.filename);
+  writeFileSync(join(installDirectory, 'package.json'), JSON.stringify({ private: true }));
+  execFileSync(
+    npmCommand,
+    ['install', '--ignore-scripts', '--no-audit', '--no-fund', archivePath],
+    commandOptions(installDirectory),
+  );
+
+  const installedRoot = join(installDirectory, 'node_modules', 'mdast-control');
+  const publicApi = await import(pathToFileURL(join(installedRoot, 'dist', 'index.js')).href);
+  assert.equal(typeof publicApi.parseMarkdown, 'function');
+  assert.equal(typeof publicApi.runPluginOperation, 'function');
+
+  const formatted = execFileSync(
+    process.execPath,
+    [
+      join(installedRoot, 'dist', 'cli.js'),
+      'plugin',
+      'run',
+      '--plugin',
+      'codeBlock',
+      '--name',
+      'formatContent',
+      '--select',
+      'code',
+      '--args',
+      '{"format":"json"}',
+    ],
+    {
+      ...commandOptions(installDirectory),
+      input: '```json\n{"ok":true}\n```\n',
+    },
+  );
+  assert.match(formatted, /\{\n  "ok": true\n\}/);
+
+  await verifyInstalledLsp(join(installedRoot, 'dist', 'lsp', 'server.js'), installDirectory);
+
+  process.stdout.write(`${JSON.stringify({
+    ok: true,
+    package: packResult.id,
+    filename: packResult.filename,
+    size: packResult.size,
+    unpackedSize: packResult.unpackedSize,
+    integrity: packResult.integrity,
+    entryCount: packResult.entryCount,
+    checks: [
+      'required package entries',
+      'compiled tests excluded',
+      'clean install',
+      'public API import',
+      'installed CLI codeBlock formatting',
+      'installed LSP stdio plugin round trip',
+    ],
+  }, null, 2)}\n`);
+} finally {
+  assert.ok(basename(tempRoot).startsWith('mdast-control-package-'));
+  rmSync(tempRoot, { recursive: true, force: true });
+}
+
+function commandOptions(cwd) {
+  return {
+    cwd,
+    encoding: 'utf8',
+    env: process.env,
+    maxBuffer: 10 * 1024 * 1024,
+    windowsHide: true,
+    shell: false,
+    timeout: 120000,
+  };
+}
+
+async function verifyInstalledLsp(serverPath, cwd) {
+  const child = spawn(process.execPath, [serverPath, '--stdio'], {
+    cwd,
+    env: process.env,
+    stdio: 'pipe',
+    windowsHide: true,
+    shell: false,
+  });
+  const client = createJsonRpcClient(child);
+
+  try {
+    const initialized = await client.request('initialize', {
+      processId: null,
+      rootUri: null,
+      capabilities: {},
+    });
+    assert.equal(initialized.capabilities.documentSymbolProvider, true);
+    client.notify('initialized', {});
+    client.notify('textDocument/didOpen', {
+      textDocument: {
+        uri: 'file:///clean-install.md',
+        languageId: 'markdown',
+        version: 1,
+        text: '```json\n{"ok":true}\n```\n',
+      },
+    });
+    const validation = await client.request('mdast/pluginRun', {
+      uri: 'file:///clean-install.md',
+      plugin: 'codeBlock',
+      operation: 'validateContent',
+      query: 'code',
+      args: { format: 'json' },
+    });
+    assert.equal(validation.kind, 'json');
+    assert.equal(validation.value.valid, true);
+    assert.equal(validation.value.checked, 1);
+    assert.equal(await client.request('shutdown', null), null);
+    client.notify('exit');
+    child.stdin.end();
+    const closed = await client.closed;
+    assert.equal(closed.code, 0, closed.stderr);
+  } finally {
+    if (child.exitCode === null) {
+      child.kill();
+    }
+  }
+}
+
+function createJsonRpcClient(child) {
+  let buffer = Buffer.alloc(0);
+  let nextId = 1;
+  let stderr = '';
+  const pending = new Map();
+
+  child.stderr.on('data', (chunk) => {
+    stderr += chunk.toString();
+  });
+  child.stdout.on('data', (chunk) => {
+    buffer = Buffer.concat([buffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);
+    consumeMessages();
+  });
+
+  const closed = new Promise((resolve) => {
+    child.once('close', (code) => {
+      for (const request of pending.values()) {
+        clearTimeout(request.timeout);
+        request.reject(new Error(`LSP exited before responding: ${stderr}`));
+      }
+      pending.clear();
+      resolve({ code, stderr });
+    });
+  });
+
+  function write(message) {
+    const body = JSON.stringify(message);
+    child.stdin.write(`Content-Length: ${String(Buffer.byteLength(body))}\r\n\r\n${body}`);
+  }
+
+  function request(method, params) {
+    const id = nextId;
+    nextId += 1;
+    const response = new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        pending.delete(id);
+        reject(new Error(`Timed out waiting for ${method}: ${stderr}`));
+      }, 10000);
+      pending.set(id, { resolve, reject, timeout });
+    });
+    write({ jsonrpc: '2.0', id, method, params });
+    return response;
+  }
+
+  function notify(method, params) {
+    write({ jsonrpc: '2.0', method, ...(params === undefined ? {} : { params }) });
+  }
+
+  function consumeMessages() {
+    while (true) {
+      const headerEnd = buffer.indexOf('\r\n\r\n');
+      if (headerEnd < 0) {
+        return;
+      }
+      const header = buffer.subarray(0, headerEnd).toString('ascii');
+      const lengthMatch = header.match(/^Content-Length:\s*(\d+)$/im);
+      assert.ok(lengthMatch, `LSP response has no Content-Length header: ${header}`);
+      const contentLength = Number(lengthMatch[1]);
+      const bodyStart = headerEnd + 4;
+      const bodyEnd = bodyStart + contentLength;
+      if (buffer.length < bodyEnd) {
+        return;
+      }
+      const message = JSON.parse(buffer.subarray(bodyStart, bodyEnd).toString('utf8'));
+      buffer = buffer.subarray(bodyEnd);
+      settleResponse(message);
+    }
+  }
+
+  function settleResponse(message) {
+    if (typeof message.id !== 'number') {
+      return;
+    }
+    const requestState = pending.get(message.id);
+    if (!requestState) {
+      return;
+    }
+    pending.delete(message.id);
+    clearTimeout(requestState.timeout);
+    if (message.error) {
+      requestState.reject(new Error(`LSP error ${String(message.error.code)}: ${message.error.message}`));
+      return;
+    }
+    requestState.resolve(message.result);
+  }
+
+  return { request, notify, closed };
+}