@codegraft/core 0.1.0-beta.0

package/dist/rich-node.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+import type { NodeTypeAll, FieldName } from './generated/node-types.js';
+/** A real tree-sitter grammar. There is no id for SFC file formats — those are
+ *  handled by a {@link ZoneSplitter}, which maps each section to one of these. */
+export type GrammarId = 'javascript' | 'typescript' | 'tsx' | 'html' | 'css' | 'yaml';
+/** Row/column position, mirroring tree-sitter's `Point`. */
+export type Point = {
+    row: number;
+    column: number;
+};
+/**
+ * The open extension point for multi-zone file formats (Vue SFC, Astro, …). The
+ * only value today is `vueSplitter`, exported from `@codegraft/vue`; core stays
+ * ignorant of any concrete format.
+ *
+ * `init()` lets a splitter load whatever grammar it parses the shell with (Vue
+ * loads `tree-sitter-vue`), so `split()` can stay synchronous. The pipeline calls
+ * `init()` once, before the first `split()`.
+ *
+ * `split()` returns raw zone descriptors only — it does not parse zone *contents*;
+ * that is the pipeline's job (`splitAndParse`).
+ */
+export interface ZoneSplitter {
+    /** Identifier and the file extension it handles: `'vue'` → `.vue`. */
+    readonly id: string;
+    /** Which grammars this format can produce. */
+    readonly grammars: GrammarId[];
+    /** Idempotent; loads the splitter's own parsing grammar. */
+    init(): Promise<void>;
+    split(source: string): Array<{
+        language: GrammarId;
+        source: string;
+        startOffset: number;
+    }>;
+}
+/**
+ * Lazy wrapper over the backing tree-sitter node. `children`/`allChildren` are cached;
+ * comment arrays are filled by the attachment pass. Offsets come in two frames:
+ * `startIndex`/`endIndex` are zone-relative, `documentStartIndex`/`documentEndIndex`
+ * absolute — so edits, always in document space, never need remapping.
+ */
+export interface RichNode {
+    readonly type: NodeTypeAll;
+    readonly isNamed: boolean;
+    readonly text: string;
+    /** Byte offset in the *zone* source. */
+    readonly startIndex: number;
+    readonly endIndex: number;
+    readonly startPosition: Point;
+    readonly endPosition: Point;
+    readonly parent: RichNode | null;
+    /** Named structural children: no punctuation, no comments. The surface pattern
+     *  matching walks, so comments never perturb a match. */
+    readonly children: RichNode[];
+    /** Full CST: every child, including punctuation and comment nodes. */
+    readonly allChildren: RichNode[];
+    child(field: FieldName): RichNode | null;
+    childrenForField(field: FieldName): RichNode[];
+    readonly leadingComments: RichNode[];
+    readonly trailingComments: RichNode[];
+    readonly innerComments: RichNode[];
+    readonly language: GrammarId;
+    /** Absolute offset in the original document: `startIndex + zone.startOffset`. */
+    readonly documentStartIndex: number;
+    readonly documentEndIndex: number;
+}
+/**
+ * One parsed region of a document. A single-grammar file produces exactly one
+ * synthetic zone with `startOffset: 0`; an SFC produces one per section. Either way
+ * the rest of the pipeline sees only `Zone[]`.
+ */
+export interface Zone {
+    language: GrammarId;
+    /** Exact slice: `outerSource.slice(startOffset, startOffset + source.length)`. */
+    source: string;
+    startOffset: number;
+    tree: RichNode;
+}
+/** A source map, structurally compatible with magic-string's (kept here so this module
+ *  stays import-free). */
+export interface SourceMap {
+    version: number;
+    file?: string;
+    sources: string[];
+    sourcesContent?: (string | null)[];
+    names: string[];
+    mappings: string;
+    toString(): string;
+    toUrl(): string;
+}
+/**
+ * Applies a codemod to a source string. Synchronous once built. `Ctx` is the run-context
+ * type the codemod is authored against (`defineCodemod<Ctx>`); it defaults to an open record
+ * and is constrained to a record so it can flow into the body and `transform(src, ctx)`.
+ */
+export interface Transformer<Ctx extends Record<string, unknown> = Record<string, unknown>> {
+    transform(source: string, context: Ctx): string;
+    /** Like {@link transform} but also returns a source map (`options.source` names the
+     *  input in the map). Used by build-pipeline integrations such as `@codegraft/unplugin`. */
+    transformWithMap(source: string, context: Ctx, options?: {
+        source?: string;
+    }): {
+        code: string;
+        map: SourceMap;
+    };
+}
+/** A {@link Transformer} that has not yet loaded its WASM grammars. */
+export interface LazyTransformer<Ctx extends Record<string, unknown> = Record<string, unknown>> {
+    readonly target: GrammarId | ZoneSplitter;
+    /** Idempotent; WASM is loaded at most once per process. */
+    init(): Promise<Transformer<Ctx>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

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/dist/zone-splitter.d.ts

@@ -0,0 +1,12 @@
+import type { GrammarId, Zone, ZoneSplitter } from './types.js';
+/**
+ * Turn any target into parsed `Zone[]` — the single pipeline the rest of the
+ * transform shares. A `GrammarId` becomes one synthetic zone covering the whole
+ * source (`startOffset: 0`); a `ZoneSplitter` is asked to `split()` the source into
+ * its sections. Either way each raw zone is parsed with its grammar and wrapped.
+ *
+ * Synchronous: grammar loading (and a `ZoneSplitter`'s own `init()`) happen earlier,
+ * in the transformer's `init()`, so by the time we get here every grammar is ready.
+ */
+export declare function splitAndParse(source: string, target: GrammarId | ZoneSplitter): Zone[];
+//# sourceMappingURL=zone-splitter.d.ts.map

package/dist/zone-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-splitter.d.ts","sourceRoot":"","sources":["../src/zone-splitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI/D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,EAAE,CAYtF"}

package/dist/zone-splitter.js

@@ -0,0 +1,23 @@
+import { Parser } from './parser.js';
+import { wrapNode } from './rich-node.js';
+/**
+ * Turn any target into parsed `Zone[]` — the single pipeline the rest of the
+ * transform shares. A `GrammarId` becomes one synthetic zone covering the whole
+ * source (`startOffset: 0`); a `ZoneSplitter` is asked to `split()` the source into
+ * its sections. Either way each raw zone is parsed with its grammar and wrapped.
+ *
+ * Synchronous: grammar loading (and a `ZoneSplitter`'s own `init()`) happen earlier,
+ * in the transformer's `init()`, so by the time we get here every grammar is ready.
+ */
+export function splitAndParse(source, target) {
+    const rawZones = typeof target === 'string'
+        ? [{ language: target, source, startOffset: 0 }]
+        : target.split(source);
+    return rawZones.map((zone) => ({
+        language: zone.language,
+        source: zone.source,
+        startOffset: zone.startOffset,
+        tree: wrapNode(Parser.parse(zone.source, zone.language).rootNode, zone.language, zone.startOffset),
+    }));
+}
+//# sourceMappingURL=zone-splitter.js.map

package/dist/zone-splitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-splitter.js","sourceRoot":"","sources":["../src/zone-splitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAgC;IAC5E,MAAM,QAAQ,GACZ,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;QAChD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAE1B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;KACnG,CAAC,CAAC,CAAA;AACL,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@codegraft/core",
+  "version": "0.1.0-beta.0",
+  "description": "Tree-sitter runtime for Codegraft: parser, RichNode, comment attachment, zone splitting, the Collection, scope resolver, and edit application.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/magne4000/codegraft.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/magne4000/codegraft#readme",
+  "bugs": "https://github.com/magne4000/codegraft/issues",
+  "files": [
+    "dist",
+    "wasm"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./internal": {
+      "import": "./dist/internal.js",
+      "types": "./dist/internal.d.ts"
+    }
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "dependencies": {
+    "magic-string": "^0.30.0",
+    "web-tree-sitter": "^0.26.9"
+  },
+  "peerDependencies": {
+    "tree-sitter-css": "^0.25.0",
+    "tree-sitter-html": "^0.23.0",
+    "tree-sitter-javascript": "^0.25.0"
+  },
+  "peerDependenciesMeta": {
+    "tree-sitter-css": {
+      "optional": true
+    },
+    "tree-sitter-html": {
+      "optional": true
+    },
+    "tree-sitter-javascript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tree-sitter-css": "^0.25.0",
+    "tree-sitter-html": "^0.23.0",
+    "tree-sitter-javascript": "^0.25.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "regen-ts-wasm": "bash scripts/regen-ts-wasm.sh",
+    "regen-node-types": "node scripts/regen-node-types.mjs"
+  }
+}