mdast-control 0.1.0

package/dist/lsp/server.js

@@ -0,0 +1,110 @@
+import { createConnection, DiagnosticSeverity, ProposedFeatures, SymbolKind, TextDocuments, TextDocumentSyncKind, } from 'vscode-languageserver/node.js';
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import { parseMarkdown, validateQuery, } from '../markdown.js';
+import { registerMdastRequestHandlers, } from './requests.js';
+const connection = createConnection(ProposedFeatures.all);
+const documents = new TextDocuments(TextDocument);
+connection.onInitialize(() => ({
+    capabilities: {
+        textDocumentSync: TextDocumentSyncKind.Incremental,
+        documentSymbolProvider: true,
+    },
+}));
+documents.onDidOpen(({ document }) => {
+    validateDocument(document);
+});
+documents.onDidChangeContent(({ document }) => {
+    validateDocument(document);
+});
+connection.onDocumentSymbol(({ textDocument }) => {
+    const document = documents.get(textDocument.uri);
+    if (!document) {
+        return [];
+    }
+    const tree = parseMarkdown(document.getText());
+    const symbols = [];
+    buildSymbols(tree, [], symbols);
+    return symbols;
+});
+registerMdastRequestHandlers(connection, (uri) => documents.get(uri)?.getText());
+documents.listen(connection);
+connection.listen();
+function validateDocument(document) {
+    const diagnostics = [];
+    const text = document.getText();
+    const fencePattern = /^```mdast-query\r?\n([\s\S]*?)\r?\n```$/gm;
+    for (const match of text.matchAll(fencePattern)) {
+        if (match.index === undefined) {
+            continue;
+        }
+        const query = match[1];
+        const lineBreakLength = match[0].includes('\r\n') ? 2 : 1;
+        const queryStart = match.index + '```mdast-query'.length + lineBreakLength;
+        const errors = validateQuery(query);
+        for (const error of errors) {
+            diagnostics.push({
+                severity: DiagnosticSeverity.Error,
+                range: {
+                    start: document.positionAt(queryStart),
+                    end: document.positionAt(queryStart + query.length),
+                },
+                message: error,
+                source: 'mdast-query',
+            });
+        }
+    }
+    connection.sendDiagnostics({ uri: document.uri, diagnostics });
+}
+function buildSymbols(node, path, target) {
+    for (const [index, child] of (node.children ?? []).entries()) {
+        const currentPath = [...path, index];
+        const name = symbolName(child, currentPath);
+        const range = nodeRange(child);
+        const symbol = {
+            name,
+            kind: symbolKind(child),
+            range,
+            selectionRange: range,
+            children: [],
+        };
+        buildSymbols(child, currentPath, symbol.children);
+        target.push(symbol);
+    }
+}
+function symbolName(node, path) {
+    if (node.type === 'heading') {
+        const text = flattenText(node).trim();
+        return text ? `H${String(node.depth ?? '?')}: ${text}` : `heading ${path.join('.')}`;
+    }
+    if (node.type === 'paragraph') {
+        const text = flattenText(node).trim();
+        return text ? `paragraph: ${text.slice(0, 30)}` : 'paragraph';
+    }
+    return node.type;
+}
+function symbolKind(node) {
+    if (node.type === 'heading') {
+        return SymbolKind.Namespace;
+    }
+    if (node.children?.length) {
+        return SymbolKind.Object;
+    }
+    return SymbolKind.String;
+}
+function flattenText(node) {
+    if (typeof node.value === 'string') {
+        return node.value;
+    }
+    return (node.children ?? []).map(flattenText).join(' ');
+}
+function nodeRange(node) {
+    const startLine = Math.max(Number(node.position?.start?.line ?? 1) - 1, 0);
+    const startCharacter = Math.max(Number(node.position?.start?.column ?? 1) - 1, 0);
+    const endLine = Math.max(Number(node.position?.end?.line ?? startLine + 1) - 1, startLine);
+    const endCharacter = Math.max(Number(node.position?.end?.column ?? startCharacter + 1) - 1, startCharacter + 1);
+    return {
+        start: { line: startLine, character: startCharacter },
+        end: { line: endLine, character: endCharacter },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/lsp/server.js.map

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

package/dist/lsp-methods.d.ts

@@ -0,0 +1,25 @@
+export declare const MDAST_REQUEST_METHODS: {
+    readonly capabilities: "mdast/capabilities";
+    readonly pluginList: "mdast/pluginList";
+    readonly pluginShow: "mdast/pluginShow";
+    readonly elementCapabilities: "mdast/elementCapabilities";
+    readonly pluginOperation: "mdast/pluginOperation";
+    readonly pluginRun: "mdast/pluginRun";
+    readonly query: "mdast/query";
+    readonly insert: "mdast/insert";
+    readonly delete: "mdast/delete";
+    readonly replace: "mdast/replace";
+    readonly wrap: "mdast/wrap";
+    readonly unwrap: "mdast/unwrap";
+    readonly move: "mdast/move";
+    readonly copy: "mdast/copy";
+    readonly tableQuery: "mdast/tableQuery";
+    readonly tableExport: "mdast/tableExport";
+    readonly tableImport: "mdast/tableImport";
+    readonly tableUpdateCell: "mdast/tableUpdateCell";
+    readonly tableInsertRow: "mdast/tableInsertRow";
+    readonly tableDeleteRow: "mdast/tableDeleteRow";
+    readonly tableAddColumn: "mdast/tableAddColumn";
+    readonly tableDeleteColumn: "mdast/tableDeleteColumn";
+    readonly tableSort: "mdast/tableSort";
+};

package/dist/lsp-methods.js

@@ -0,0 +1,26 @@
+export const MDAST_REQUEST_METHODS = {
+    capabilities: 'mdast/capabilities',
+    pluginList: 'mdast/pluginList',
+    pluginShow: 'mdast/pluginShow',
+    elementCapabilities: 'mdast/elementCapabilities',
+    pluginOperation: 'mdast/pluginOperation',
+    pluginRun: 'mdast/pluginRun',
+    query: 'mdast/query',
+    insert: 'mdast/insert',
+    delete: 'mdast/delete',
+    replace: 'mdast/replace',
+    wrap: 'mdast/wrap',
+    unwrap: 'mdast/unwrap',
+    move: 'mdast/move',
+    copy: 'mdast/copy',
+    tableQuery: 'mdast/tableQuery',
+    tableExport: 'mdast/tableExport',
+    tableImport: 'mdast/tableImport',
+    tableUpdateCell: 'mdast/tableUpdateCell',
+    tableInsertRow: 'mdast/tableInsertRow',
+    tableDeleteRow: 'mdast/tableDeleteRow',
+    tableAddColumn: 'mdast/tableAddColumn',
+    tableDeleteColumn: 'mdast/tableDeleteColumn',
+    tableSort: 'mdast/tableSort',
+};
+//# sourceMappingURL=lsp-methods.js.map

package/dist/lsp-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-methods.js","sourceRoot":"","sources":["../src/lsp-methods.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,kBAAkB;IAC9B,mBAAmB,EAAE,2BAA2B;IAChD,eAAe,EAAE,uBAAuB;IACxC,SAAS,EAAE,iBAAiB;IAC5B,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc;IACtB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,kBAAkB;IAC9B,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,mBAAmB;IAChC,eAAe,EAAE,uBAAuB;IACxC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,sBAAsB;IACtC,iBAAiB,EAAE,yBAAyB;IAC5C,SAAS,EAAE,iBAAiB;CACpB,CAAC"}

package/dist/markdown.d.ts

@@ -0,0 +1,17 @@
+import type { InsertPosition, InsertResult, MdastNode, MoveTargetPolicy, MutationResult } from './types.js';
+export declare function parseMarkdown(markdown: string): MdastNode;
+export declare function stringifyAst(tree: MdastNode): string;
+export declare function astToJson(tree: MdastNode, pretty?: boolean): string;
+export declare function jsonToAst(input: string): MdastNode;
+export declare function convertMarkdownToAstJson(markdown: string, pretty?: boolean): string;
+export declare function restoreMarkdownFromAstJson(input: string): string;
+export declare function insertMarkdown(markdown: string, query: string, position: InsertPosition, snippetMarkdown: string): InsertResult;
+export declare function deleteMarkdown(markdown: string, query: string): MutationResult;
+export declare function replaceMarkdown(markdown: string, query: string, snippetMarkdown: string): MutationResult;
+export declare function wrapMarkdown(markdown: string, query: string, wrapperMarkdown: string): MutationResult;
+export declare function unwrapMarkdown(markdown: string, query: string): MutationResult;
+export declare function moveMarkdown(markdown: string, sourceQuery: string, targetQuery: string, position: InsertPosition, targetPolicy?: MoveTargetPolicy): MutationResult;
+export declare function copyMarkdown(markdown: string, sourceQuery: string, targetQuery: string, position: InsertPosition, targetPolicy?: MoveTargetPolicy): MutationResult;
+export declare function validateQuery(input: string): string[];
+export declare function isInsertPosition(input: string): input is InsertPosition;
+export declare function isMoveTargetPolicy(input: string): input is MoveTargetPolicy;

package/dist/markdown.js

@@ -0,0 +1,140 @@
+import { unified } from 'unified';
+import remarkGfm from 'remark-gfm';
+import remarkParse from 'remark-parse';
+import remarkStringify from 'remark-stringify';
+import { applyDelete, applyInsert, applyReplace, applyUnwrap, applyWrap, parseQuery, queryAst } from './query.js';
+const parser = unified().use(remarkParse).use(remarkGfm);
+const compiler = unified().use(remarkStringify, {
+    bullet: '-',
+    fences: true,
+    listItemIndent: 'one',
+}).use(remarkGfm);
+export function parseMarkdown(markdown) {
+    return parser.parse(markdown);
+}
+export function stringifyAst(tree) {
+    return String(compiler.stringify(tree));
+}
+export function astToJson(tree, pretty = true) {
+    return JSON.stringify(tree, null, pretty ? 2 : 0);
+}
+export function jsonToAst(input) {
+    const parsed = JSON.parse(input);
+    assertMdastNode(parsed, '$');
+    return parsed;
+}
+export function convertMarkdownToAstJson(markdown, pretty = true) {
+    return astToJson(parseMarkdown(markdown), pretty);
+}
+export function restoreMarkdownFromAstJson(input) {
+    return stringifyAst(jsonToAst(input));
+}
+export function insertMarkdown(markdown, query, position, snippetMarkdown) {
+    const tree = parseMarkdown(markdown);
+    const snippetTree = parseMarkdown(snippetMarkdown);
+    const matches = queryAst(tree, query);
+    return applyInsert(tree, matches, position, snippetTree.children ?? []);
+}
+export function deleteMarkdown(markdown, query) {
+    const tree = parseMarkdown(markdown);
+    const matches = queryAst(tree, query);
+    return applyDelete(tree, matches);
+}
+export function replaceMarkdown(markdown, query, snippetMarkdown) {
+    const tree = parseMarkdown(markdown);
+    const snippetTree = parseMarkdown(snippetMarkdown);
+    const matches = queryAst(tree, query);
+    return applyReplace(tree, matches, snippetTree.children ?? []);
+}
+export function wrapMarkdown(markdown, query, wrapperMarkdown) {
+    const tree = parseMarkdown(markdown);
+    const wrapperTree = parseMarkdown(wrapperMarkdown);
+    const matches = queryAst(tree, query);
+    return applyWrap(tree, matches, wrapperTree.children ?? []);
+}
+export function unwrapMarkdown(markdown, query) {
+    const tree = parseMarkdown(markdown);
+    const matches = queryAst(tree, query);
+    return applyUnwrap(tree, matches);
+}
+export function moveMarkdown(markdown, sourceQuery, targetQuery, position, targetPolicy = 'exactly-one') {
+    const tree = parseMarkdown(markdown);
+    const sourceMatches = normalizeNonOverlappingMatches(queryAst(tree, sourceQuery));
+    const movedNodes = sourceMatches.map((match) => structuredClone(match.node));
+    applyDelete(tree, sourceMatches);
+    const target = selectTargetMatch(queryAst(tree, targetQuery), targetPolicy, 'Move');
+    const result = applyInsert(tree, [target], position, movedNodes);
+    return { tree: result.tree, changed: movedNodes.length };
+}
+export function copyMarkdown(markdown, sourceQuery, targetQuery, position, targetPolicy = 'exactly-one') {
+    const tree = parseMarkdown(markdown);
+    const sourceMatches = normalizeNonOverlappingMatches(queryAst(tree, sourceQuery));
+    if (sourceMatches.some((match) => match.path.length === 0)) {
+        throw new Error('Cannot copy root node');
+    }
+    const copiedNodes = sourceMatches.map((match) => structuredClone(match.node));
+    const target = selectTargetMatch(queryAst(tree, targetQuery), targetPolicy, 'Copy');
+    const result = applyInsert(tree, [target], position, copiedNodes);
+    return { tree: result.tree, changed: copiedNodes.length };
+}
+export function validateQuery(input) {
+    try {
+        parseQuery(input);
+        return [];
+    }
+    catch (error) {
+        return [error instanceof Error ? error.message : 'Unknown query error'];
+    }
+}
+export function isInsertPosition(input) {
+    return input === 'before' || input === 'after' || input === 'prepend' || input === 'append';
+}
+export function isMoveTargetPolicy(input) {
+    return input === 'exactly-one' || input === 'first' || input === 'last';
+}
+function selectTargetMatch(matches, policy, operation) {
+    if (!isMoveTargetPolicy(policy)) {
+        throw new Error(`Unsupported move target policy "${String(policy)}"`);
+    }
+    if (policy === 'exactly-one') {
+        if (matches.length !== 1) {
+            throw new Error(`${operation} requires exactly one target match, received ${String(matches.length)}`);
+        }
+        return matches[0];
+    }
+    if (matches.length === 0) {
+        throw new Error(`${operation} target policy "${policy}" requires at least one target match`);
+    }
+    return policy === 'first' ? matches[0] : matches[matches.length - 1];
+}
+function normalizeNonOverlappingMatches(matches) {
+    return matches.filter((candidate) => {
+        return !matches.some((other) => {
+            if (other === candidate || other.path.length >= candidate.path.length) {
+                return false;
+            }
+            return other.path.every((value, index) => candidate.path[index] === value);
+        });
+    });
+}
+function assertMdastNode(value, path) {
+    if (!isRecord(value)) {
+        throw new Error(`Invalid mdast node at ${path}: expected an object`);
+    }
+    if (typeof value.type !== 'string' || value.type.length === 0) {
+        throw new Error(`Invalid mdast node at ${path}: "type" must be a non-empty string`);
+    }
+    if (!Object.hasOwn(value, 'children')) {
+        return;
+    }
+    if (!Array.isArray(value.children)) {
+        throw new Error(`Invalid mdast node at ${path}: "children" must be an array when present`);
+    }
+    for (const [index, child] of value.children.entries()) {
+        assertMdastNode(child, `${path}.children[${String(index)}]`);
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,144 @@
+import type { MdastNode, QueryMatch } from './types.js';
+export type CapabilityAvailability = 'available' | 'planned';
+export type OperationParamType = 'string' | 'number' | 'boolean' | 'enum' | 'json';
+export type OperationParamDescriptor = {
+    name: string;
+    type: OperationParamType;
+    required: boolean;
+    description: string;
+    enumValues?: string[];
+    defaultValue?: unknown;
+};
+export type OperationResultDescriptor = {
+    type: 'markdown' | 'json' | 'text' | 'mutation';
+    shapeDescription: string;
+};
+export type OperationDescriptor = {
+    name: string;
+    title: string;
+    description: string;
+    targetKinds: string[];
+    targetCardinality: 'exactly-one' | 'zero-or-one' | 'one-or-more' | 'zero-or-more';
+    category: 'query' | 'edit' | 'convert' | 'analyze';
+    params: OperationParamDescriptor[];
+    result: OperationResultDescriptor;
+    availability: CapabilityAvailability;
+    examples?: string[];
+    stability: 'experimental' | 'stable';
+};
+export type QueryExtensionDescriptor = {
+    kind: 'pseudo-field' | 'selector-sugar';
+    name: string;
+    targetKinds: string[];
+    valueType: 'string' | 'number' | 'boolean';
+    operators: string[];
+    description: string;
+    availability: CapabilityAvailability;
+};
+export type ConverterDescriptor = {
+    name: string;
+    sourceFormat: string;
+    targetFormat: string;
+    description: string;
+    params: OperationParamDescriptor[];
+    availability: CapabilityAvailability;
+};
+export type AstElementPlugin = {
+    id: string;
+    version: string;
+    elementKinds: string[];
+    title: string;
+    description: string;
+    availability: CapabilityAvailability;
+    queryExtensions?: QueryExtensionDescriptor[];
+    operations: OperationDescriptor[];
+    converters?: ConverterDescriptor[];
+    handlers?: Record<string, PluginOperationHandler>;
+};
+export type PluginOperationArgs = Record<string, unknown>;
+export type PluginOperationContext = {
+    markdown: string;
+    query: string;
+    args: PluginOperationArgs;
+    descriptor: OperationDescriptor;
+    tree: MdastNode;
+    matches: QueryMatch[];
+};
+export type PluginRunResult = {
+    kind: 'mutation';
+    changed: number;
+    markdown: string;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'json';
+    value: unknown;
+};
+export type PluginOperationHandler = (context: PluginOperationContext) => PluginRunResult;
+export type PluginRunRequest = {
+    plugin: string;
+    operation: string;
+    markdown: string;
+    query: string;
+    args?: PluginOperationArgs;
+};
+export type PluginOperationErrorCode = 'unknown-plugin' | 'unknown-operation' | 'operation-unavailable' | 'invalid-query' | 'invalid-params' | 'unsupported-target' | 'target-cardinality' | 'semantic-error';
+export type PluginOperationErrorShape = {
+    code: PluginOperationErrorCode;
+    plugin: string;
+    operation: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
+export declare class PluginOperationError extends Error {
+    readonly code: PluginOperationErrorCode;
+    readonly plugin: string;
+    readonly operation: string;
+    readonly details?: Record<string, unknown>;
+    constructor(shape: PluginOperationErrorShape);
+    toJSON(): PluginOperationErrorShape;
+}
+export type CoreCapabilities = {
+    queryOperators: string[];
+    genericOperations: string[];
+    customRequests: string[];
+};
+export type PluginCapabilities = Omit<AstElementPlugin, 'elementKinds' | 'handlers'> & {
+    elementKinds: string[];
+};
+export type CapabilitiesSnapshot = {
+    core: CoreCapabilities;
+    plugins: PluginCapabilities[];
+};
+export type ElementCapabilities = {
+    elementKind: string;
+    plugins: PluginCapabilities[];
+};
+export declare class PluginRegistry {
+    private readonly core;
+    private readonly plugins;
+    private readonly byId;
+    private readonly byElementKind;
+    constructor(core?: CoreCapabilities, plugins?: AstElementPlugin[]);
+    registerPlugin(plugin: AstElementPlugin): void;
+    registerPlugins(plugins: AstElementPlugin[]): void;
+    getPlugin(id: string): PluginCapabilities | undefined;
+    listPlugins(): PluginCapabilities[];
+    listPluginsForElementKind(kind: string): PluginCapabilities[];
+    getCapabilities(): CapabilitiesSnapshot;
+    getPluginCapabilities(pluginId: string): PluginCapabilities | undefined;
+    getElementCapabilities(elementKind: string): ElementCapabilities;
+    getOperationDescriptor(pluginId: string, operationName: string): OperationDescriptor | undefined;
+    listQueryExtensions(): QueryExtensionDescriptor[];
+    runOperation(request: PluginRunRequest): PluginRunResult;
+}
+export declare const defaultPluginRegistry: PluginRegistry;
+export declare function getCapabilities(): CapabilitiesSnapshot;
+export declare function getPluginCapabilities(pluginId: string): PluginCapabilities | undefined;
+export declare function getElementCapabilities(elementKind: string): ElementCapabilities;
+export declare function getOperationDescriptor(pluginId: string, operationName: string): OperationDescriptor | undefined;
+export declare function listPlugins(): PluginCapabilities[];
+export declare function listPluginsForElementKind(kind: string): PluginCapabilities[];
+export declare function listQueryExtensions(): QueryExtensionDescriptor[];
+export declare function runPluginOperation(request: PluginRunRequest): PluginRunResult;