@f12io/maple-language-core 0.0.2

package/README.md

@@ -0,0 +1,42 @@
+# @f12io/maple-language-core
+
+Editor-agnostic language tooling for [Maple CSS](https://github.com/f12io/maple):
+region discovery, class extraction, string grammar, and the class layout
+engine. This package is the single source of truth consumed by the
+[Maple VS Code extension](https://github.com/f12io/maple-vscode-extension)
+and [`@f12io/prettier-plugin-maple`](https://www.npmjs.com/package/@f12io/prettier-plugin-maple).
+
+## What it provides
+
+- **`LanguageServiceRegistry.getService(languageId)`** — a language service
+  for `html`, `javascript(react)`, `typescript(react)`, `vue`, `svelte`,
+  `php`, `razor`, `aspnetcorerazor`, and `twig`.
+- **`service.collectRegions(text)`** — every maple region in a document
+  (class attributes, `className={...}`, `clsx()`/`cva()` arguments,
+  `/* maple */` opt-in expressions, framework bindings), typed as raw class
+  text or code expressions.
+- **`service.extractClasses(text)`** — class instances with exact document
+  offsets, interpolation-aware per language (JS template literals, C#
+  interpolated strings, PHP blocks, Razor expressions).
+- **`formatClasses` / `computeFormattingEdits` / `formatText`** — the layout
+  engine: wraps class lists by property group, preserves ternary and
+  concatenation structure, and upgrades string delimiters only when the host
+  language allows multi-line strings.
+
+## Usage
+
+```ts
+import {
+  LanguageServiceRegistry,
+  formatText,
+} from '@f12io/maple-language-core';
+
+const service = LanguageServiceRegistry.getService('javascriptreact');
+const instances = service.extractClasses(source);
+
+const formatted = formatText(source, 'javascriptreact', 4);
+```
+
+## License
+
+Released under the [Root Source License (ROOT)](https://github.com/f12io/maple-vscode-extension/blob/main/LICENSE), an MIT-style permissive license with an additional distribution condition for systems that can recreate the source on demand. © [f12.io](https://f12.io)

package/dist/LanguageService.d.ts

@@ -0,0 +1,104 @@
+export interface ClassInstance {
+    value: string;
+    start: number;
+    end: number;
+    tagName?: string;
+}
+/** A [start, end) offset range whose contents are excluded via disable comments. */
+export interface DisabledBlock {
+    start: number;
+    end: number;
+}
+/** Keeps the first instance seen for each start offset. */
+export declare function dedupeInstancesByStart(instances: Array<ClassInstance>): Array<ClassInstance>;
+/** A string literal located by a language service's `matchStringLiteral`. */
+export interface StringLiteralMatch {
+    /** Index of the opening delimiter (including any prefix, e.g. `$@`) */
+    start: number;
+    contentStart: number;
+    contentEnd: number;
+    /** Index just after the closing delimiter */
+    endIndex: number;
+    /** The opening delimiter as written: `$@"`, `$"`, `"`, `'` or `` ` `` */
+    rawDelimiter: string;
+    /** Content contains interpolation holes this service can parse */
+    isInterpolated: boolean;
+}
+/**
+ * A document range that holds maple classes. This is the single source of
+ * truth for "where do maple strings live" — extraction, formatting, and every
+ * feature built on them consume the same regions.
+ */
+export interface MapleRegion {
+    start: number;
+    end: number;
+    /**
+     * `class-text`: the range is raw class text (a class attribute value).
+     * `expression`: the range is code whose string literals are maple
+     * (opt-in expressions, clsx/cva arguments, className={...}, :class="...").
+     */
+    kind: 'class-text' | 'expression';
+    /**
+     * Anchor offset of the construct that produced the region (attribute or
+     * call start). Used for tag-name lookup, disable-comment checks, and
+     * formatter indentation.
+     */
+    anchor: number;
+    /** Extract unquoted object keys as classes (clsx objects, :class objects) */
+    includeObjectKeys?: boolean;
+    /**
+     * False when the host syntax cannot hold multi-line string literals
+     * (e.g. Angular template expressions); the formatter then only applies
+     * single-line normalizations. Defaults to true.
+     */
+    allowMultilineLiterals?: boolean;
+}
+/** Callback invoked for each interpolated string found during extraction. */
+export type StringExtractionCallback = (value: string, offset: number, text: string, matchIndex: number, literal?: StringLiteralMatch) => void;
+export interface Token {
+    value: string;
+    start: number;
+    end: number;
+    hasInterpolation?: boolean;
+}
+export interface ILanguageService {
+    languageIds: Array<string>;
+    extractClasses(text: string): Array<ClassInstance>;
+    /**
+     * Reports every maple region in the document. Single implementation per
+     * language; extraction and formatting both consume it.
+     */
+    collectRegions(text: string): Array<MapleRegion>;
+    tokenizeClassesWithIndices(str: string): Array<Token>;
+    /**
+     * Resolves source-escaped class text to what the framework actually renders
+     * into the DOM (e.g. Razor renders `@@md:p-2` as `@md:p-2`). Used where the
+     * runtime CSS matters (hover), not for document ranges.
+     */
+    getRenderedClassText(word: string): string;
+    /**
+     * Returns the delimiters to use when a formatted string must span multiple
+     * lines, or undefined when the string cannot legally hold newlines in this
+     * language (the formatter then leaves it untouched). `rawQuote` is the
+     * opening delimiter as written ($@", $", ", ' or `).
+     */
+    getMultilineStringDelimiters(rawQuote: string, content: string): {
+        open: string;
+        close: string;
+    } | undefined;
+    /**
+     * Matches a string literal of this language starting at `index`, or
+     * undefined when no (terminated) literal starts there. This is the single
+     * place a language's string grammar lives — generic helpers delegate here
+     * instead of hardcoding delimiter knowledge.
+     */
+    matchStringLiteral(text: string, index: number): StringLiteralMatch | undefined;
+    /**
+     * Formats a bare class-bearing expression (e.g. a ternary with string
+     * arms), preserving its structure — the same treatment interpolations get
+     * inside class attributes. Returns undefined when the expression has no
+     * structure this language knows how to format.
+     */
+    formatExpression(expr: string, baseIndent: string, maxClassesPerLine: number, formatClassesFn: (value: string, indent: string, maxClasses: number) => string): string | undefined;
+    formatInterpolation(cls: string, baseIndent: string, maxClassesPerLine: number, formatClassesFn: (value: string, indent: string, maxClasses: number) => string): string;
+}

package/dist/LanguageService.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dedupeInstancesByStart = dedupeInstancesByStart;
+/** Keeps the first instance seen for each start offset. */
+function dedupeInstancesByStart(instances) {
+    const uniqueInstances = [];
+    const seenStarts = new Set();
+    for (const instance of instances) {
+        if (!seenStarts.has(instance.start)) {
+            seenStarts.add(instance.start);
+            uniqueInstances.push(instance);
+        }
+    }
+    return uniqueInstances;
+}
+//# sourceMappingURL=LanguageService.js.map

package/dist/LanguageService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LanguageService.js","sourceRoot":"","sources":["../src/LanguageService.ts"],"names":[],"mappings":";;AAcA,wDAcC;AAfD,2DAA2D;AAC3D,SAAgB,sBAAsB,CACpC,SAA+B;IAE/B,MAAM,eAAe,GAAyB,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC/B,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/extractor.helper.d.ts

@@ -0,0 +1,66 @@
+import { ClassInstance, ILanguageService, StringExtractionCallback, StringLiteralMatch } from './LanguageService';
+export declare function isQuote(char: string): boolean;
+/**
+ * Upper bound on how far a single scan may advance before giving up.
+ * Guards every hand-rolled scanner against runaway scans on malformed input
+ * (e.g. an unterminated attribute in a huge minified file).
+ */
+export declare const MAX_SCAN_LENGTH = 5000;
+/**
+ * Skips a quoted string literal. `index` must hold the opening quote (`'` or
+ * `"`); backslash escapes are honored, so an escaped quote does not close the
+ * string. Returns the index just after the closing quote, or the scan bound
+ * when the string is unterminated.
+ */
+export declare function skipStringLiteral(text: string, index: number): number;
+export declare function findClosingQuote(text: string, startIndex: number, quote: string): number;
+export declare function getTagNameBackwards(text: string, index: number): string | undefined;
+export declare function isCommentedOut(text: string, index: number): boolean;
+export declare function isLineDisabled(text: string, index: number): boolean;
+export declare function getDisabledBlocks(text: string): Array<{
+    start: number;
+    end: number;
+}>;
+export declare function shouldSkipMatch(text: string, index: number, disabledBlocks?: Array<{
+    start: number;
+    end: number;
+}>): boolean;
+export declare function pushInstance(instances: Array<ClassInstance>, value: string, start: number, text: string, matchIndex: number, disabledBlocks?: Array<{
+    start: number;
+    end: number;
+}>): void;
+export declare function extractUnquotedObjectKeys(expr: string, exprStart: number, text: string, matchIndex: number, instances: Array<ClassInstance>, disabledBlocks?: Array<{
+    start: number;
+    end: number;
+}>): void;
+export interface OptInRegion {
+    /** Index of the opt-in comment match */
+    matchIndex: number;
+    /** Start of the opted-in expression (first non-whitespace after comment) */
+    regionStart: number;
+    /** End of the opted-in expression (exclusive of the terminator) */
+    regionEnd: number;
+    /** Every string literal found in the region, in document order */
+    literals: Array<StringLiteralMatch>;
+}
+/**
+ * Locates all string literals opted in by a maple comment. The comment marks
+ * the whole following expression — like a class attribute, every string
+ * literal in it is maple (ternary arms, concatenation parts, ...). String
+ * boundaries are delegated to the language service, so each language's
+ * string grammar lives in exactly one place.
+ *
+ * The region ends at a `;` or `,` at bracket depth 0, at a closing bracket
+ * that was never opened inside the region, or at a plain assignment `=`
+ * (guarding against swallowing the next statement in semicolon-less code;
+ * comparison/arrow operators like `==`, `=>`, `<=` do not terminate).
+ */
+export declare function findOptInRegions(service: ILanguageService, text: string): Array<OptInRegion>;
+export declare function extractStringLiterals(service: ILanguageService, expr: string, exprStart: number, text: string, matchIndex: number, instances: Array<ClassInstance>, disabledBlocks?: Array<{
+    start: number;
+    end: number;
+}>, extractCallback?: StringExtractionCallback): void;
+export declare function getExactWordRangeAtPosition(document: any, position: any): {
+    wordRange: any | undefined;
+    currentWord: string;
+};

package/dist/extractor.helper.js

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SCAN_LENGTH = void 0;
+exports.isQuote = isQuote;
+exports.skipStringLiteral = skipStringLiteral;
+exports.findClosingQuote = findClosingQuote;
+exports.getTagNameBackwards = getTagNameBackwards;
+exports.isCommentedOut = isCommentedOut;
+exports.isLineDisabled = isLineDisabled;
+exports.getDisabledBlocks = getDisabledBlocks;
+exports.shouldSkipMatch = shouldSkipMatch;
+exports.pushInstance = pushInstance;
+exports.extractUnquotedObjectKeys = extractUnquotedObjectKeys;
+exports.findOptInRegions = findOptInRegions;
+exports.extractStringLiterals = extractStringLiterals;
+exports.getExactWordRangeAtPosition = getExactWordRangeAtPosition;
+const regex_1 = require("./regex");
+function isQuote(char) {
+    return char === '"' || char === "'" || char === '`';
+}
+/**
+ * Upper bound on how far a single scan may advance before giving up.
+ * Guards every hand-rolled scanner against runaway scans on malformed input
+ * (e.g. an unterminated attribute in a huge minified file).
+ */
+exports.MAX_SCAN_LENGTH = 5000;
+/**
+ * Skips a quoted string literal. `index` must hold the opening quote (`'` or
+ * `"`); backslash escapes are honored, so an escaped quote does not close the
+ * string. Returns the index just after the closing quote, or the scan bound
+ * when the string is unterminated.
+ */
+function skipStringLiteral(text, index) {
+    const quote = text[index];
+    const limit = Math.min(text.length, index + exports.MAX_SCAN_LENGTH);
+    let i = index + 1;
+    while (i < limit) {
+        if (text[i] === '\\') {
+            i += 2;
+            continue;
+        }
+        if (text[i] === quote) {
+            return i + 1;
+        }
+        i++;
+    }
+    return limit;
+}
+function findClosingQuote(text, startIndex, quote) {
+    let parenDepth = 0;
+    let braceDepth = 0;
+    let i = startIndex;
+    while (i < text.length) {
+        const char = text[i];
+        const prevChar = i > 0 ? text[i - 1] : '';
+        if (prevChar === '\\') {
+            i++;
+            continue;
+        }
+        if (parenDepth > 0 && (char === '"' || char === "'")) {
+            // Inside a Razor @(...) expression a quote starts a C# string literal,
+            // which may legally contain parens, braces, or the attribute's own
+            // quote char. Skip it entirely.
+            i = skipStringLiteral(text, i);
+            continue;
+        }
+        if (char === '(' && prevChar === '@') {
+            parenDepth++;
+        }
+        else if (char === '(' && parenDepth > 0) {
+            parenDepth++;
+        }
+        else if (char === ')') {
+            if (parenDepth > 0)
+                parenDepth--;
+        }
+        else if (char === '{') {
+            braceDepth++;
+        }
+        else if (char === '}') {
+            if (braceDepth > 0)
+                braceDepth--;
+        }
+        else if (char === quote) {
+            if (parenDepth === 0 && braceDepth === 0) {
+                return i;
+            }
+        }
+        if (i - startIndex > exports.MAX_SCAN_LENGTH) {
+            return -1; // safety timeout
+        }
+        i++;
+    }
+    return -1;
+}
+function getTagNameBackwards(text, index) {
+    const prefix = text.substring(0, index);
+    const lastOpen = prefix.lastIndexOf('<');
+    const lastClose = prefix.lastIndexOf('>');
+    if (lastOpen !== -1 && lastOpen > lastClose) {
+        const match = text.substring(lastOpen + 1).match(regex_1.START_TAG_NAME_REGEX);
+        if (match) {
+            return match[1].toLowerCase();
+        }
+    }
+    return undefined;
+}
+function isCommentedOut(text, index) {
+    const lastNewline = text.lastIndexOf('\n', index);
+    const lineToMatch = text.substring(lastNewline + 1, index);
+    if (lineToMatch.includes('//'))
+        return true;
+    if (lineToMatch.includes('<!--'))
+        return true;
+    if (regex_1.START_COMMENT_STAR_REGEX.test(lineToMatch))
+        return true;
+    const lastSlashStar = lineToMatch.lastIndexOf('/*');
+    if (lastSlashStar !== -1) {
+        const lastStarSlash = lineToMatch.lastIndexOf('*/');
+        if (lastStarSlash < lastSlashStar) {
+            return true;
+        }
+    }
+    return false;
+}
+function isLineDisabled(text, index) {
+    const lastNewline = text.lastIndexOf('\n', index);
+    let nextNewline = text.indexOf('\n', index);
+    if (nextNewline === -1)
+        nextNewline = text.length;
+    const fullLine = text.substring(lastNewline + 1, nextNewline);
+    if (fullLine.includes('maple-disable-line'))
+        return true;
+    if (lastNewline !== -1) {
+        const prevNewline = text.lastIndexOf('\n', lastNewline - 1);
+        const prevLine = text.substring(prevNewline + 1, lastNewline);
+        if (prevLine.includes('maple-disable-next-line'))
+            return true;
+    }
+    return false;
+}
+function getDisabledBlocks(text) {
+    const blocks = [];
+    const disableMatches = [...text.matchAll(regex_1.DISABLE_REGEX)];
+    const enableMatches = [...text.matchAll(regex_1.ENABLE_REGEX)];
+    let currentEnd = 0;
+    for (const disableMatch of disableMatches) {
+        const start = disableMatch.index;
+        if (start < currentEnd)
+            continue;
+        const enableMatch = enableMatches.find((m) => m.index > start);
+        const end = enableMatch
+            ? enableMatch.index + enableMatch[0].length
+            : text.length;
+        blocks.push({ start, end });
+        currentEnd = end;
+    }
+    return blocks;
+}
+function shouldSkipMatch(text, index, disabledBlocks = []) {
+    if (isCommentedOut(text, index) || isLineDisabled(text, index))
+        return true;
+    for (const block of disabledBlocks) {
+        if (index >= block.start && index <= block.end)
+            return true;
+    }
+    return false;
+}
+function pushInstance(instances, value, start, text, matchIndex, disabledBlocks = []) {
+    if (shouldSkipMatch(text, start, disabledBlocks))
+        return;
+    instances.push({
+        value,
+        start,
+        end: start + value.length,
+        tagName: getTagNameBackwards(text, matchIndex),
+    });
+}
+function extractUnquotedObjectKeys(expr, exprStart, text, matchIndex, instances, disabledBlocks = []) {
+    for (const keyMatch of expr.matchAll(regex_1.OBJECT_KEY_REGEX)) {
+        const value = keyMatch[1];
+        const keyIdx = keyMatch[0].indexOf(value);
+        const start = exprStart + keyMatch.index + keyIdx;
+        pushInstance(instances, value, start, text, matchIndex, disabledBlocks);
+    }
+}
+/**
+ * Locates all string literals opted in by a maple comment. The comment marks
+ * the whole following expression — like a class attribute, every string
+ * literal in it is maple (ternary arms, concatenation parts, ...). String
+ * boundaries are delegated to the language service, so each language's
+ * string grammar lives in exactly one place.
+ *
+ * The region ends at a `;` or `,` at bracket depth 0, at a closing bracket
+ * that was never opened inside the region, or at a plain assignment `=`
+ * (guarding against swallowing the next statement in semicolon-less code;
+ * comparison/arrow operators like `==`, `=>`, `<=` do not terminate).
+ */
+function findOptInRegions(service, text) {
+    const results = [];
+    let currentEnd = 0;
+    for (const match of text.matchAll(regex_1.OPT_IN_COMMENT_REGEX)) {
+        if (match.index < currentEnd)
+            continue;
+        let i = match.index + match[0].length;
+        while (i < text.length && text[i].trim() === '')
+            i++;
+        // Objects (/* maple */ { ... }) are handled by the object opt-in path
+        if (text[i] === '{')
+            continue;
+        const regionStart = i;
+        const regionLimit = Math.min(text.length, i + exports.MAX_SCAN_LENGTH);
+        const literals = [];
+        let depth = 0;
+        while (i < regionLimit) {
+            const literal = service.matchStringLiteral(text, i);
+            if (literal) {
+                literals.push(literal);
+                i = literal.endIndex;
+                continue;
+            }
+            const ch = text[i];
+            if (ch === '(' || ch === '[' || ch === '{') {
+                depth++;
+            }
+            else if (ch === ')' || ch === ']' || ch === '}') {
+                if (depth === 0)
+                    break; // closes a bracket opened before the region
+                depth--;
+            }
+            else if (depth === 0 && (ch === ';' || ch === ',')) {
+                break;
+            }
+            else if (depth === 0 &&
+                ch === '=' &&
+                text[i + 1] !== '=' &&
+                text[i + 1] !== '>' &&
+                !'=<>!+-*/%&|^'.includes(text[i - 1] ?? '')) {
+                break; // plain assignment: the next statement has begun
+            }
+            i++;
+        }
+        if (literals.length > 0) {
+            results.push({
+                matchIndex: match.index,
+                regionStart,
+                regionEnd: i,
+                literals,
+            });
+        }
+        currentEnd = i;
+    }
+    return results;
+}
+function extractStringLiterals(service, expr, exprStart, text, matchIndex, instances, disabledBlocks = [], extractCallback) {
+    let j = 0;
+    while (j < expr.length) {
+        const literal = service.matchStringLiteral(expr, j);
+        if (!literal) {
+            j++;
+            continue;
+        }
+        const value = expr.substring(literal.contentStart, literal.contentEnd);
+        const start = exprStart + literal.contentStart;
+        if (literal.isInterpolated) {
+            extractCallback?.(value, start, text, matchIndex, literal);
+        }
+        else {
+            pushInstance(instances, value, start, text, matchIndex, disabledBlocks);
+        }
+        j = literal.endIndex;
+    }
+}
+function getExactWordRangeAtPosition(document, position) {
+    const wordRange = document.getWordRangeAtPosition(position, regex_1.MAPLE_CLASS_REGEX_NON_GLOBAL);
+    const currentWord = wordRange ? document.getText(wordRange) : '';
+    if (!wordRange) {
+        return { wordRange: undefined, currentWord: '' };
+    }
+    const cursorOffsetInWord = position.character - wordRange.start.character;
+    const tokens = currentWord.split(regex_1.TOKEN_SPLIT_REGEX);
+    let currentOffset = 0;
+    let finalRange = wordRange;
+    let finalWord = '';
+    for (const token of tokens) {
+        const start = currentOffset;
+        const end = currentOffset + token.length;
+        if (cursorOffsetInWord > start && cursorOffsetInWord <= end) {
+            if (!isQuote(token) && token.trim() !== '') {
+                finalWord = token;
+                finalRange = wordRange.with(wordRange.start.translate(0, start), wordRange.start.translate(0, end));
+            }
+            else {
+                finalRange = undefined;
+                finalWord = '';
+            }
+            break;
+        }
+        else if (cursorOffsetInWord === 0 && start === 0) {
+            if (!isQuote(token) && token.trim() !== '') {
+                finalWord = token;
+                finalRange = wordRange.with(wordRange.start.translate(0, start), wordRange.start.translate(0, end));
+                break;
+            }
+        }
+        currentOffset = end;
+    }
+    if (finalWord && finalRange) {
+        // Strip trailing HTML characters if it still bled (e.g. `bgc-red>`)
+        const cleanWord = finalWord.replace(/[><]+$/, '').replace(/<![\-]*$/, '');
+        if (cleanWord !== finalWord) {
+            const diff = finalWord.length - cleanWord.length;
+            finalRange = finalRange.with(undefined, finalRange.end.translate(0, -diff));
+            finalWord = cleanWord;
+        }
+    }
+    return { wordRange: finalRange, currentWord: finalWord };
+}
+//# sourceMappingURL=extractor.helper.js.map

package/dist/extractor.helper.js.map

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

package/dist/formatter.d.ts

@@ -0,0 +1,26 @@
+import { ILanguageService } from './LanguageService';
+/** A plain text replacement, editor-agnostic. Offsets refer to the input text. */
+export interface TextReplacement {
+    start: number;
+    end: number;
+    newText: string;
+}
+/**
+ * Formats a maple class string: wraps onto multiple lines when it exceeds
+ * `maxClassesPerLine`, grouping classes by property type, and recursing into
+ * interpolation expressions via the language service.
+ */
+export declare function formatClasses(classStr: string, baseIndent: string, maxClassesPerLine: number, service: ILanguageService): string;
+/**
+ * Computes formatting replacements for every maple region in the document —
+ * class attributes, opt-in expressions, and framework-specific regions — as
+ * plain offsets, usable from any host (VS Code, Prettier, CLI).
+ */
+export declare function computeFormattingEdits(text: string, service: ILanguageService, maxClassesPerLine: number): Array<TextReplacement>;
+/** Applies non-overlapping replacements to a string. */
+export declare function applyTextEdits(text: string, edits: Array<TextReplacement>): string;
+/**
+ * Formats every maple region in a document and returns the new text.
+ * Convenience entry point for non-editor hosts (Prettier plugin, CLI).
+ */
+export declare function formatText(text: string, languageId: string, maxClassesPerLine: number): string;