@coherent.js/language-server 1.0.0-beta.1

package/dist/analysis/nesting-validator.js

@@ -0,0 +1,68 @@
+/**
+ * HTML Nesting Validator
+ *
+ * Validates parent/child relationships of Coherent.js elements
+ * against HTML5 content model rules.
+ */
+import { validateNesting as checkNesting } from '../data/nesting-rules.js';
+/**
+ * Validate nesting of an element within its parent.
+ *
+ * @param element - The Coherent element to validate
+ * @returns Array of nesting validation errors
+ */
+export function validateElementNesting(element) {
+    const errors = [];
+    // Check this element against its parent
+    const parentTag = element.parent?.tagName || null;
+    const nestingErrors = checkNesting(element.tagName, parentTag);
+    for (const error of nestingErrors) {
+        errors.push({
+            message: error.message,
+            range: element.tagNameRange,
+            code: error.code,
+            severity: error.severity,
+            childTag: element.tagName,
+            parentTag: parentTag || 'root',
+            data: {
+                childTag: element.tagName,
+                parentTag: parentTag || 'root',
+            },
+        });
+    }
+    return errors;
+}
+/**
+ * Validate nesting for multiple elements.
+ *
+ * @param elements - Array of Coherent elements to validate
+ * @returns Array of all nesting validation errors
+ */
+export function validateAllNesting(elements) {
+    const errors = [];
+    for (const element of elements) {
+        errors.push(...validateElementNesting(element));
+    }
+    return errors;
+}
+/**
+ * Get suggestions for fixing nesting errors.
+ *
+ * @param error - The nesting validation error
+ * @returns Suggested fix description or null
+ */
+export function getNestingFixSuggestion(error) {
+    switch (error.code) {
+        case 'invalid-parent':
+            return `Move <${error.childTag}> to be a child of the correct parent element`;
+        case 'invalid-nesting':
+            return `Remove <${error.childTag}> from <${error.parentTag}> or restructure the component`;
+        case 'block-in-inline':
+            return `Consider using a block-level container instead of <${error.parentTag}>`;
+        case 'invalid-child':
+            return `<${error.parentTag}> should not contain <${error.childTag}>`;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=nesting-validator.js.map

package/dist/analysis/nesting-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nesting-validator.js","sourceRoot":"","sources":["../../src/analysis/nesting-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,eAAe,IAAI,YAAY,EAAmB,MAAM,0BAA0B,CAAC;AA4B5F;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA4B;IACjE,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,wCAAwC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;IAClD,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,OAAO,CAAC,YAAY;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAsC;YAClD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,OAAO,CAAC,OAAO;YACzB,SAAS,EAAE,SAAS,IAAI,MAAM;YAC9B,IAAI,EAAE;gBACJ,QAAQ,EAAE,OAAO,CAAC,OAAO;gBACzB,SAAS,EAAE,SAAS,IAAI,MAAM;aAC/B;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA+B;IAChE,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA6B;IACnE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,gBAAgB;YACnB,OAAO,SAAS,KAAK,CAAC,QAAQ,+CAA+C,CAAC;QAEhF,KAAK,iBAAiB;YACpB,OAAO,WAAW,KAAK,CAAC,QAAQ,WAAW,KAAK,CAAC,SAAS,gCAAgC,CAAC;QAE7F,KAAK,iBAAiB;YACpB,OAAO,sDAAsD,KAAK,CAAC,SAAS,GAAG,CAAC;QAElF,KAAK,eAAe;YAClB,OAAO,IAAI,KAAK,CAAC,SAAS,yBAAyB,KAAK,CAAC,QAAQ,GAAG,CAAC;QAEvE;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/data/element-attributes.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Element attribute data for the Coherent.js Language Server
+ *
+ * This module provides runtime access to HTML element attribute information,
+ * imported from the generated JSON file created by extract-attributes.ts.
+ *
+ * The data is extracted at build time from packages/core/types/elements.d.ts
+ * to maintain a single source of truth for element definitions.
+ */
+export interface AttributeInfo {
+    name: string;
+    type: string;
+    optional: boolean;
+    description?: string;
+}
+export interface ElementInfo {
+    tagName: string;
+    attributes: AttributeInfo[];
+    isVoidElement: boolean;
+}
+export interface ExtractedData {
+    elements: Record<string, ElementInfo>;
+    voidElements: string[];
+    globalAttributes: AttributeInfo[];
+    eventHandlers: AttributeInfo[];
+    generatedAt: string;
+}
+/**
+ * Set of all valid HTML element tag names.
+ */
+export declare const HTML_ELEMENTS: Set<string>;
+/**
+ * Set of void elements that cannot have children.
+ */
+export declare const VOID_ELEMENTS: Set<string>;
+/**
+ * Get all valid attributes for a given HTML element.
+ *
+ * Returns element-specific attributes combined with global attributes,
+ * event handlers, and Coherent.js properties.
+ *
+ * @param tagName - The HTML element tag name (e.g., 'div', 'input')
+ * @returns Array of attribute information
+ */
+export declare function getAttributesForElement(tagName: string): AttributeInfo[];
+/**
+ * Check if an element is a void element (cannot have children).
+ *
+ * @param tagName - The HTML element tag name
+ * @returns true if the element is a void element
+ */
+export declare function isVoidElement(tagName: string): boolean;
+/**
+ * Check if an attribute is valid for a given element.
+ *
+ * @param tagName - The HTML element tag name
+ * @param attributeName - The attribute name to check
+ * @returns true if the attribute is valid for the element
+ */
+export declare function isValidAttribute(tagName: string, attributeName: string): boolean;
+/**
+ * Get suggestions for a potentially misspelled attribute name.
+ *
+ * Uses Levenshtein distance to find similar attribute names.
+ *
+ * @param tagName - The HTML element tag name
+ * @param attributeName - The potentially misspelled attribute name
+ * @param maxDistance - Maximum edit distance for suggestions (default: 3)
+ * @returns Array of suggested attribute names, sorted by distance
+ */
+export declare function getSuggestions(tagName: string, attributeName: string, maxDistance?: number): string[];
+/**
+ * Get the type description for an attribute.
+ *
+ * @param tagName - The HTML element tag name
+ * @param attributeName - The attribute name
+ * @returns Type string or undefined if attribute not found
+ */
+export declare function getAttributeType(tagName: string, attributeName: string): string | undefined;
+/**
+ * Get the description for an attribute.
+ *
+ * @param tagName - The HTML element tag name
+ * @param attributeName - The attribute name
+ * @returns Description string or undefined if not available
+ */
+export declare function getAttributeDescription(tagName: string, attributeName: string): string | undefined;
+/**
+ * Get element-specific description for hover documentation.
+ */
+export declare function getElementDescription(tagName: string): string;
+//# sourceMappingURL=element-attributes.d.ts.map

package/dist/data/element-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-attributes.d.ts","sourceRoot":"","sources":["../../src/data/element-attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAkCD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,GAAG,CAAC,MAAM,CAqBpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,GAAG,CAAC,MAAM,CAA8B,CAAC;AAYrE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAkDxE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAahF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,EAAE,CA4BhG;AAoCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI3F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwB7D"}