@reteps/tree-sitter-htmlmustache 0.8.0 → 0.9.0

package/browser/out/core/htmlBalanceChecker.d.ts

@@ -0,0 +1,23 @@
+export interface BalanceNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    endPosition: {
+        row: number;
+        column: number;
+    };
+    startIndex: number;
+    endIndex: number;
+    children: BalanceNode[];
+}
+export interface BalanceError {
+    node: BalanceNode;
+    message: string;
+}
+export { getSectionName } from './nodeHelpers.js';
+export declare function checkUnclosedTags(rootNode: BalanceNode): BalanceError[];
+export declare function checkHtmlBalance(rootNode: BalanceNode): BalanceError[];
+//# sourceMappingURL=htmlBalanceChecker.d.ts.map

package/browser/out/core/htmlBalanceChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlBalanceChecker.d.ts","sourceRoot":"","sources":["../../../src/core/htmlBalanceChecker.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAsBD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA+QlD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CA2BvE;AAID,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CAoCtE"}

package/browser/out/core/mustacheChecks.d.ts

@@ -0,0 +1,24 @@
+import type { BalanceNode, BalanceError } from './htmlBalanceChecker.js';
+export interface TextReplacement {
+    startIndex: number;
+    endIndex: number;
+    newText: string;
+}
+export interface FixableError extends BalanceError {
+    severity?: 'error' | 'warning';
+    fix?: TextReplacement[];
+    fixDescription?: string;
+}
+export declare function checkNestedSameNameSections(rootNode: BalanceNode): FixableError[];
+export declare function checkUnquotedMustacheAttributes(rootNode: BalanceNode): FixableError[];
+export declare function checkConsecutiveSameNameSections(rootNode: BalanceNode, sourceText: string): FixableError[];
+export declare function checkSelfClosingNonVoidTags(rootNode: BalanceNode): FixableError[];
+export declare function checkUnescapedEntities(rootNode: BalanceNode): FixableError[];
+export declare function checkHtmlComments(rootNode: BalanceNode): FixableError[];
+export declare function checkUnrecognizedHtmlTags(rootNode: BalanceNode, customTagNames?: string[]): FixableError[];
+export declare function checkDuplicateAttributes(rootNode: BalanceNode): FixableError[];
+export declare function checkElementContentTooLong(rootNode: BalanceNode, elements: ReadonlyArray<{
+    tag: string;
+    maxBytes: number;
+}>): FixableError[];
+//# sourceMappingURL=mustacheChecks.d.ts.map

package/browser/out/core/mustacheChecks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mustacheChecks.d.ts","sourceRoot":"","sources":["../../../src/core/mustacheChecks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIzE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CAgCjF;AAGD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CA4BrF;AAGD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CA6D1G;AAUD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CA6BjF;AAiED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CAsD5E;AAGD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CAiCvE;AAgCD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAsC1G;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,EAAE,CAkD9E;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GACzD,YAAY,EAAE,CAsChB"}

package/browser/out/core/nodeHelpers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared node helper functions and type constants for working with
+ * tree-sitter syntax nodes across the LSP and CLI.
+ *
+ * Uses a minimal interface compatible with both web-tree-sitter's SyntaxNode
+ * and the BalanceNode interface from htmlBalanceChecker.
+ */
+/** Minimal node interface compatible with both SyntaxNode and BalanceNode. */
+export interface MinimalNode {
+    type: string;
+    text: string;
+    children: MinimalNode[];
+}
+export declare const MUSTACHE_SECTION_TYPES: Set<string>;
+export declare const INTERPOLATION_TYPES: Set<string>;
+export declare const RAW_CONTENT_ELEMENT_TYPES: Set<string>;
+export declare const HTML_ELEMENT_TYPES: Set<string>;
+export declare function isMustacheSection(node: MinimalNode): boolean;
+export declare function isRawContentElement(node: MinimalNode): boolean;
+export declare function isHtmlElementType(node: MinimalNode): boolean;
+/**
+ * Get the tag name from an HTML element node.
+ * Works with any node that has children with type 'html_start_tag' or
+ * 'html_self_closing_tag' containing an 'html_tag_name' child.
+ */
+export declare function getTagName(node: MinimalNode): string | null;
+/**
+ * Get the section name from a mustache section node.
+ * Looks for mustache_tag_name inside mustache_section_begin or
+ * mustache_inverted_section_begin.
+ */
+export declare function getSectionName(node: MinimalNode): string | null;
+/**
+ * Get the tag name from an erroneous end tag node.
+ */
+export declare function getErroneousEndTagName(node: MinimalNode): string | null;
+/**
+ * Get the dotted path text from a mustache_interpolation or mustache_triple
+ * node — e.g. `{{data.foo}}` → `"data.foo"`. Returns `"."` for the
+ * context-marker interpolation `{{.}}`. Returns null if the node has no
+ * recognisable expression child.
+ */
+export declare function getInterpolationPath(node: MinimalNode): string | null;
+/**
+ * Get the content text of a mustache_comment node (`{{!foo}}` → `"foo"`).
+ * Returns null if no content child is present.
+ */
+export declare function getCommentContent(node: MinimalNode): string | null;
+/**
+ * Get the partial name of a mustache_partial node (`{{>header}}` → `"header"`).
+ * Returns null if no content child is present.
+ */
+export declare function getPartialName(node: MinimalNode): string | null;
+//# sourceMappingURL=nodeHelpers.d.ts.map

package/browser/out/core/nodeHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeHelpers.d.ts","sourceRoot":"","sources":["../../../src/core/nodeHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAID,eAAO,MAAM,sBAAsB,aAGjC,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAG9B,CAAC;AAEH,eAAO,MAAM,yBAAyB,aAIpC,CAAC;AAEH,eAAO,MAAM,kBAAkB,aAK7B,CAAC;AAIH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE5D;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAO/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAG/D"}

package/browser/out/core/ruleMetadata.d.ts

@@ -0,0 +1,12 @@
+import type { RuleSeverity } from './configSchema.js';
+export interface RuleDefinition {
+    name: string;
+    defaultSeverity: RuleSeverity;
+    description: string;
+}
+export declare const RULES: RuleDefinition[];
+/** Set of all known rule names (for config validation). */
+export declare const KNOWN_RULE_NAMES: Set<string>;
+/** Default severity for each rule (for runtime resolution). */
+export declare const RULE_DEFAULTS: Record<string, RuleSeverity>;
+//# sourceMappingURL=ruleMetadata.d.ts.map

package/browser/out/core/ruleMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruleMetadata.d.ts","sourceRoot":"","sources":["../../../src/core/ruleMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,YAAY,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,KAAK,EAAE,cAAc,EA8CjC,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,aAA0C,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAEtD,CAAC"}

package/browser/out/core/selectorMatcher.d.ts

@@ -0,0 +1,74 @@
+/**
+ * CSS-like selector parser and tree matcher for custom lint rules.
+ *
+ * Mustache constructs are written literally in selectors — `{{foo}}`,
+ * `{{{foo}}}`, `{{#foo}}`, `{{^foo}}`, `{{!foo}}`, `{{>foo}}`. A preprocessor
+ * substitutes each form into an internal `:m-*` pseudo-class marker, then the
+ * rewritten string is handed to parsel-js. This keeps users in Mustache
+ * vocabulary without reinventing a selector parser.
+ *
+ * Supported user-facing syntax:
+ *   - Tag names (`div`), universal (`*`), classes (`.foo`), ids (`#foo`)
+ *   - Attributes: `[attr]`, `[attr=v]`, `[attr^=v]`, `[attr*=v]`, `[attr$=v]`, `[attr~=v]`
+ *   - Descendant (space) and child (`>`) combinators
+ *   - Mustache variables: `{{path}}` and `{{{path}}}` (raw)
+ *   - Mustache sections: `{{#name}}` and `{{^name}}` (inverted)
+ *   - Mustache comments: `{{!content}}`
+ *   - Mustache partials: `{{>name}}`
+ *   - Glob wildcard `*` inside the argument: `{{options.*}}`, `{{*.deprecated}}`, `{{*}}`
+ *   - `:has(selector)` — element has a matching descendant
+ *   - `:not(...)` over any attribute/class/id/:has form
+ *   - `:root` — the tree-sitter fragment root (the whole document). Unlike
+ *     browser CSS where `:root` matches `<html>`, this matches the parse-tree
+ *     root so it works on partials/fragments too. Useful as a document-scoped
+ *     anchor, e.g. `:root:has(pl-question-panel):not(:has(pl-answer-panel))`
+ *     matches the root iff a `pl-question-panel` is present anywhere but no
+ *     `pl-answer-panel` is. Cannot combine with tag/class/id/attribute in the
+ *     same compound (only with `:has` / `:not(:has(...))`). Inside `:has(...)`,
+ *     `:root` refers to the element being checked, not the document.
+ *   - Comma-separated alternatives
+ *
+ * Unsupported (parseSelector returns null, rule is skipped):
+ *   - Sibling combinators (`+`, `~`)
+ *   - `[attr|=v]`, case-insensitive `i` flag
+ *   - Mixed HTML + Mustache kinds in one compound (e.g. `img{{foo}}`)
+ *   - `{{/end}}` (end tags aren't standalone nodes)
+ *   - `{{=<% %>=}}` (delimiter changes aren't grammar-tracked)
+ *   - Mustache literals inside `:not(...)` (only attribute/class/id/:has)
+ */
+import type { BalanceNode } from './htmlBalanceChecker.js';
+export type AttributeOperator = '=' | '^=' | '*=' | '$=' | '~=';
+export type SegmentKind = 'html' | 'section' | 'inverted' | 'variable' | 'raw' | 'comment' | 'partial';
+export interface AttributeConstraint {
+    name: string;
+    op: AttributeOperator;
+    value?: string;
+    negated: boolean;
+}
+export interface DescendantCheck {
+    selector: ParsedSelector;
+    negated: boolean;
+}
+export interface Segment {
+    kind: SegmentKind;
+    rootOnly: boolean;
+    name: string | null;
+    pathRegex?: RegExp;
+    attributes: AttributeConstraint[];
+    descendantChecks: DescendantCheck[];
+    combinator: 'descendant' | 'child';
+}
+/** A parsed selector is a list of alternatives (from comma-separated parts). */
+export type ParsedSelector = Segment[][];
+/**
+ * Rewrite Mustache-literal tokens (`{{...}}` forms) in the selector string into
+ * internal `:m-*` pseudo-class markers so parsel-js can handle them. Returns
+ * null if the string contains an unsupported or malformed Mustache token.
+ *
+ * Skips content inside `"..."` and `'...'` so that literal `{{...}}` embedded
+ * in CSS attribute-value strings is preserved unchanged.
+ */
+export declare function preprocessMustacheLiterals(raw: string): string | null;
+export declare function parseSelector(raw: string): ParsedSelector | null;
+export declare function matchSelector(rootNode: BalanceNode, selector: ParsedSelector): BalanceNode[];
+//# sourceMappingURL=selectorMatcher.d.ts.map

package/browser/out/core/selectorMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectorMatcher.d.ts","sourceRoot":"","sources":["../../../src/core/selectorMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAY3D,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,SAAS,GACT,UAAU,GACV,UAAU,GACV,KAAK,GACL,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,iBAAiB,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC;CACpC;AAED,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,OAAO,EAAE,EAAE,CAAC;AAQzC;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuFrE;AAID,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAuBhE;AA0eD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,WAAW,EAAE,CAY5F"}