@askviraj/linter 1.1.4 → 1.1.6

package/node_modules/@rviscomi/capo.js/dist/types/adapters/adapter.d.ts

@@ -90,6 +90,12 @@ export declare class AdapterInterface {
      * @returns {SourceLocation | null}
      */
     getLocation(node: any): SourceLocation | null;
+    /**
+     * Get character position for a node (optional, for validation)
+     * @param {any} node - Element node
+     * @returns {number | null}
+     */
+    getCharacterPosition(node: any): number | null;
     /**
      * Stringify element for logging/debugging
      * @param {any} node - Element node

package/node_modules/@rviscomi/capo.js/dist/types/adapters/browser.d.ts

@@ -5,7 +5,7 @@
  * This adapter is used in browser environments where capo.js operates
  * on actual DOM elements.
  */
-import { AdapterInterface } from './adapter.js';
+import { AdapterInterface } from "./adapter.js";
 /**
  * Browser DOM adapter
  *
@@ -97,6 +97,13 @@ export declare class BrowserAdapter extends AdapterInterface {
      * @returns {null}
      */
     getLocation(node: any): null;
+    /**
+     * Get character position for a node (optional, for validation)
+     * @override
+     * @param {any} node - Element node
+     * @returns {number | null}
+     */
+    getCharacterPosition(node: any): number | null;
     /**
      * Stringify element for logging/debugging
      * @override

package/node_modules/@rviscomi/capo.js/dist/types/adapters/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Central export point for all HTML adapters.
  */
-export { AdapterInterface, validateAdapter } from './adapter.js';
-export { BrowserAdapter } from './browser.js';
+export { AdapterInterface, validateAdapter } from "./adapter.js";
+export { BrowserAdapter } from "./browser.js";

package/node_modules/@rviscomi/capo.js/dist/types/analyzer.d.ts

@@ -91,6 +91,10 @@ export type AnalyzeHeadOptions = {
      * - Whether to include element-level custom validations
      */
     includeCustomValidations?: boolean;
+    /**
+     * - Page origin for validation context (e.g., origin trial validation)
+     */
+    pageOrigin?: string | null;
 };
 /**
  * @typedef {import('./adapters/adapter.js').AdapterInterface} AdapterInterface
@@ -138,6 +142,7 @@ export type AnalyzeHeadOptions = {
  * @typedef {Object} AnalyzeHeadOptions
  * @property {boolean} [includeValidation=true] - Whether to include document-level validation warnings
  * @property {boolean} [includeCustomValidations=true] - Whether to include element-level custom validations
+ * @property {string|null} [pageOrigin=null] - Page origin for validation context (e.g., origin trial validation)
  */
 /**
  * Analyze the head element and return element weights, validation warnings, and custom validations.

package/node_modules/@rviscomi/capo.js/dist/types/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @module capo
  */
-export { analyzeHead, analyzeHeadWithOrdering, checkOrdering, getWeightCategory } from './analyzer.js';
+export { analyzeHead, analyzeHeadWithOrdering, checkOrdering, getWeightCategory } from "./analyzer.js";
 export type AnalysisResult = import('./analyzer.js').AnalysisResult;
 export type WeightInfo = import('./analyzer.js').WeightInfo;
 export type ValidationWarning = import('./analyzer.js').ValidationWarning;
@@ -23,7 +23,7 @@ export type AnalyzeHeadOptions = import('./analyzer.js').AnalyzeHeadOptions;
  * @typedef {import('./analyzer.js').AnalysisResultWithOrdering} AnalysisResultWithOrdering
  * @typedef {import('./analyzer.js').AnalyzeHeadOptions} AnalyzeHeadOptions
  */
-export { ElementWeights, getWeight, getHeadWeights, isMeta, isTitle, isPreconnect, isAsyncScript, isImportStyles, isSyncScript, isSyncStyles, isPreload, isDeferScript, isPrefetchPrerender, isOriginTrial, isMetaCSP } from './lib/rules.js';
-export { VALID_HEAD_ELEMENTS, isValidElement, hasValidationWarning, getValidationWarnings, getCustomValidations } from './lib/validation.js';
-export { BrowserAdapter } from './adapters/browser.js';
-export { AdapterInterface, validateAdapter } from './adapters/adapter.js';
+export { ElementWeights, getWeight, getHeadWeights, isMeta, isTitle, isPreconnect, isHighPriorityPreload, isAsyncScript, isImportStyles, isSyncScript, isSyncStyles, isPreload, isDeferScript, isPrefetchPrerender, isOriginTrial, isMetaCSP, } from "./lib/rules.js";
+export { VALID_HEAD_ELEMENTS, isValidElement, hasValidationWarning, getValidationWarnings, getCustomValidations, } from "./lib/validation.js";
+export { BrowserAdapter } from "./adapters/browser.js";
+export { AdapterInterface, validateAdapter } from "./adapters/adapter.js";

package/node_modules/@rviscomi/capo.js/dist/types/lib/options.d.ts

@@ -38,7 +38,7 @@ export declare class Options {
     /**
      * @param {OptionsInit} [options={}]
      */
-    constructor({ preferredAssessmentMode, validation, palette, loggingPrefix }?: OptionsInit);
+    constructor({ preferredAssessmentMode, validation, palette, loggingPrefix, }?: OptionsInit);
     /**
      * @returns {{ STATIC: 'static', DYNAMIC: 'dynamic' }}
      */

package/node_modules/@rviscomi/capo.js/dist/types/lib/rules.d.ts

@@ -21,7 +21,14 @@ export declare function isMeta(element: any, adapter: AdapterInterface): boolean
  */
 export declare function isTitle(element: any, adapter: AdapterInterface): boolean;
 /**
- * Check if element is a preconnect link
+ * Check if element is a high-priority preload link
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isHighPriorityPreload(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Check if element is a preconnect or high-priority preload link
  * @param {any} element
  * @param {AdapterInterface} adapter
  * @returns {boolean}
@@ -70,7 +77,7 @@ export declare function isPreload(element: any, adapter: AdapterInterface): bool
  */
 export declare function isDeferScript(element: any, adapter: AdapterInterface): boolean;
 /**
- * Check if element is prefetch/dns-prefetch/prerender link
+ * Check if element is prefetch/dns-prefetch/prerender link or speculationrules script
  * @param {any} element
  * @param {AdapterInterface} adapter
  * @returns {boolean}

package/node_modules/@rviscomi/capo.js/dist/types/lib/validation.d.ts

@@ -41,9 +41,10 @@ export declare function isValidElement(element: any, adapter: AdapterInterface):
  * Check if an element has any validation warning
  * @param {any} element
  * @param {AdapterInterface} adapter
+ * @param {string|null} [pageOrigin=null]
  * @returns {boolean}
  */
-export declare function hasValidationWarning(element: any, adapter: AdapterInterface): boolean;
+export declare function hasValidationWarning(element: any, adapter: AdapterInterface, pageOrigin?: string | null): boolean;
 /**
  * Get document-level validation warnings for a <head> element
  * @param {any} head
@@ -56,6 +57,7 @@ export declare function getValidationWarnings(head: any, adapter: AdapterInterfa
  * @param {any} element
  * @param {AdapterInterface} adapter
  * @param {any} [parentElement=null]
+ * @param {string|null} [pageOrigin=null]
  * @returns {CustomValidationResult}
  */
-export declare function getCustomValidations(element: any, adapter: AdapterInterface, parentElement?: any): CustomValidationResult;
+export declare function getCustomValidations(element: any, adapter: AdapterInterface, parentElement?: any, pageOrigin?: string | null): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/charset.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('./index.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('./index.js').CustomValidationResult;
+export declare const CONTENT_TYPE_SELECTOR = "meta[http-equiv=\"content-type\" i], meta[charset]";
+/**
+ * Check if element is a Content-Type or charset meta tag
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isContentType(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Check if element is an invalid Content-Type or charset meta tag
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isInvalidContentType(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Validate Content-Type / charset element
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateContentType(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/content-type.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isContentType(element: any, adapter: AdapterInterface): boolean;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateContentType(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/csp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateCSP(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/default-style.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isDefaultStyle(element: any, adapter: AdapterInterface): boolean;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateDefaultStyle(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/head-elements.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ *
+ * @typedef {Object} ValidationWarningResult
+ * @property {string} ruleId
+ * @property {string} warning
+ * @property {any} [element]
+ * @property {any[]} [elements]
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type ValidationWarningResult = {
+    ruleId: string;
+    warning: string;
+    element?: any;
+    elements?: any[];
+};
+export declare const VALID_HEAD_ELEMENTS: Set<string>;
+/**
+ * Check if element is a valid HTML <head> element
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isValidElement(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Check if element has any invalid child elements
+ * @param {any} element - Element to check
+ * @param {AdapterInterface} adapter - Adapter instance
+ * @returns {boolean}
+ */
+export declare function hasInvalidChildren(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Check if this is a duplicate title element (2nd+ occurrence)
+ * @param {any} element - Element to check
+ * @param {AdapterInterface} adapter - Adapter instance
+ * @returns {boolean}
+ */
+export declare function isDuplicateTitle(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Check if this is a duplicate base element
+ * @param {any} element - Element to check
+ * @param {AdapterInterface} adapter - Adapter instance
+ * @returns {boolean}
+ */
+export declare function isDuplicateBase(element: any, adapter: AdapterInterface): boolean;
+/**
+ * Get document-level validation warnings for a <head> element
+ * @param {any} head
+ * @param {AdapterInterface} adapter
+ * @returns {ValidationWarningResult[]}
+ */
+export declare function getValidationWarnings(head: any, adapter: AdapterInterface): ValidationWarningResult[];

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/http-equiv.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isHttpEquiv(element: any, adapter: AdapterInterface): boolean;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateHttpEquiv(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/origin-trial.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * Decode origin trial token payload
+ * @param {string|null} token
+ * @returns {any}
+ */
+export declare function decodeOriginTrialToken(token: string | null): any;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @param {string|null} [pageOrigin=null]
+ * @returns {CustomValidationResult}
+ */
+export declare function validateOriginTrial(element: any, adapter: AdapterInterface, pageOrigin?: string | null): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/preload.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * Find an element with matching source using adapter
+ * @param {any} parent - Parent element to search within
+ * @param {string} sourceUrl - URL to match
+ * @param {any} excludeElement - Element to exclude from search
+ * @param {AdapterInterface} adapter - Adapter instance
+ * @returns {any|null} - Matching element or null
+ */
+export declare function findElementWithSource(parent: any, sourceUrl: string, excludeElement: any, adapter: AdapterInterface): any | null;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @param {any} [parentElement=null]
+ * @returns {boolean}
+ */
+export declare function isUnnecessaryPreload(element: any, adapter: AdapterInterface, parentElement?: any): boolean;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isInvalidFontPreload(element: any, adapter: AdapterInterface): boolean;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @param {any} [parentElement=null]
+ * @returns {CustomValidationResult}
+ */
+export declare function validateUnnecessaryPreload(element: any, adapter: AdapterInterface, parentElement?: any): CustomValidationResult;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateInvalidFontPreload(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/lib/validations/viewport.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @typedef {import('../../adapters/adapter.js').AdapterInterface} AdapterInterface
+ * @typedef {import('../validation.js').CustomValidationResult} CustomValidationResult
+ */
+export type AdapterInterface = import('../../adapters/adapter.js').AdapterInterface;
+export type CustomValidationResult = import('../validation.js').CustomValidationResult;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {boolean}
+ */
+export declare function isMetaViewport(element: any, adapter: AdapterInterface): boolean;
+/**
+ * @param {any} element
+ * @param {AdapterInterface} adapter
+ * @returns {CustomValidationResult}
+ */
+export declare function validateMetaViewport(element: any, adapter: AdapterInterface): CustomValidationResult;

package/node_modules/@rviscomi/capo.js/dist/types/worker/worker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Cloudflare worker script for Capo.js:
+ *
+ * - Proxies requests ONLY from allowed origins using CORS.
+ * - Accepts a POST request to `/auth` with `{ code, redirect_uri }` to exchange GitHub OAuth codes for access tokens.
+ * - Accepts a `url` GET parameter to proxy HTML text responses from target sites.
+ */
+declare const _default: {
+    /**
+     * @param {Request} request
+     * @param {any} env
+     * @returns {Promise<Response>}
+     */
+    fetch(request: Request, env: any): Promise<Response>;
+};
+export default _default;

package/node_modules/@rviscomi/capo.js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rviscomi/capo.js",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -84,13 +84,6 @@
       "source": "src/extension/options.js",
       "distDir": "dist/chrome/options",
       "sourceMap": false
-    },
-    "web": {
-      "source": "src/web/capo.js",
-      "distDir": "docs/src/lib",
-      "outputFormat": "esmodule",
-      "isLibrary": true,
-      "sourceMap": false
     }
   },
   "scripts": {
@@ -102,12 +95,14 @@
     "build": "npm run build:cjs && npm run build:types && parcel build && node scripts/build-extension.js",
     "package:source": "zip -r -q dist/source.zip . -x \"node_modules/*\" \"dist/*\" \".git/*\" \".parcel-cache/*\" \"docs/node_modules/*\" \"docs/.astro/*\" \"docs/dist/*\" \".github/*\" \"*/.DS_Store\" \".DS_Store\"",
     "build:cjs": "esbuild src/index.js src/analyzer.js src/adapters/adapter.js src/adapters/index.js src/adapters/browser.js src/lib/rules.js src/lib/validation.js src/lib/io.js src/lib/options.js src/lib/colors.js src/adapters/test-suite.js --bundle --platform=node --format=cjs --outdir=dist --out-extension:.js=.cjs",
-    "test": "node --test tests/**/*.test.js",
-    "test:watch": "node --test --watch tests/**/*.test.js",
-    "test:coverage": "node --test --experimental-test-coverage tests/**/*.test.js",
+    "test": "node --test tests/*.test.js tests/**/*.test.js",
+    "test:watch": "node --test --watch tests/*.test.js tests/**/*.test.js",
+    "test:coverage": "node --test --experimental-test-coverage tests/*.test.js tests/**/*.test.js",
     "test:rules": "node --test tests/lib/rules.test.js",
     "test:validation": "node --test tests/lib/validation.test.js",
-    "test:integration": "node --test tests/integration/*.test.js"
+    "test:integration": "node --test tests/integration/*.test.js",
+    "format:check": "prettier --check .",
+    "format": "prettier --write ."
   },
   "devDependencies": {
     "@parcel/cache": "^2.16.4",
@@ -118,6 +113,7 @@
     "esbuild": "^0.28.1",
     "jsdom": "^29.1.1",
     "parcel": "^2.16.4",
+    "prettier": "^3.5.3",
     "typescript": "^7.0.2"
   }
 }

package/node_modules/@rviscomi/capo.js/src/adapters/adapter.js

@@ -1,6 +1,6 @@
 /**
  * @file Base adapter interface for HTML tree operations
- * 
+ *
  * This file defines the contract that all adapters must implement.
  * Adapters abstract away environment-specific operations (browser DOM vs AST nodes)
  * to make capo.js core logic reusable across different contexts.
@@ -17,31 +17,31 @@
 
 /** @type {readonly string[]} */
 const REQUIRED_METHODS = [
-  'isElement',
-  'getTagName',
-  'getAttribute',
-  'hasAttribute',
-  'getAttributeNames',
-  'getTextContent',
-  'getChildren',
-  'getParent',
-  'getSiblings',
-  'stringify',
+  "isElement",
+  "getTagName",
+  "getAttribute",
+  "hasAttribute",
+  "getAttributeNames",
+  "getTextContent",
+  "getChildren",
+  "getParent",
+  "getSiblings",
+  "stringify",
 ];
 
 /**
  * Base adapter interface
- * 
+ *
  * Actual adapters should implement all these methods.
  * This serves as both documentation and a reference implementation.
- * 
+ *
  * @example
  * import { BrowserAdapter } from './browser.js';
  * import { ParserAdapter } from './parser.js';
- * 
+ *
  * // For browser DOM:
  * const adapter = new BrowserAdapter();
- * 
+ *
  * // For ESLint HTML parser AST:
  * const adapter = new ParserAdapter();
  */
@@ -52,7 +52,7 @@ export class AdapterInterface {
    * @returns {boolean}
    */
   isElement(node) {
-    throw new Error('isElement() not implemented');
+    throw new Error("isElement() not implemented");
   }
 
   /**
@@ -61,7 +61,7 @@ export class AdapterInterface {
    * @returns {string} - Tag name like 'meta', 'link', 'script'
    */
   getTagName(node) {
-    throw new Error('getTagName() not implemented');
+    throw new Error("getTagName() not implemented");
   }
 
   /**
@@ -71,7 +71,7 @@ export class AdapterInterface {
    * @returns {string | null} - Attribute value or null if not found
    */
   getAttribute(node, attrName) {
-    throw new Error('getAttribute() not implemented');
+    throw new Error("getAttribute() not implemented");
   }
 
   /**
@@ -81,7 +81,7 @@ export class AdapterInterface {
    * @returns {boolean} - True if attribute exists
    */
   hasAttribute(node, attrName) {
-    throw new Error('hasAttribute() not implemented');
+    throw new Error("hasAttribute() not implemented");
   }
 
   /**
@@ -90,7 +90,7 @@ export class AdapterInterface {
    * @returns {string[]} - Array of attribute names
    */
   getAttributeNames(node) {
-    throw new Error('getAttributeNames() not implemented');
+    throw new Error("getAttributeNames() not implemented");
   }
 
   /**
@@ -99,7 +99,7 @@ export class AdapterInterface {
    * @returns {string} - Text content
    */
   getTextContent(node) {
-    throw new Error('getTextContent() not implemented');
+    throw new Error("getTextContent() not implemented");
   }
 
   /**
@@ -108,7 +108,7 @@ export class AdapterInterface {
    * @returns {any[]} - Array of child element nodes (excluding text/comment nodes)
    */
   getChildren(node) {
-    throw new Error('getChildren() not implemented');
+    throw new Error("getChildren() not implemented");
   }
 
   /**
@@ -117,7 +117,7 @@ export class AdapterInterface {
    * @returns {any | null} - Parent element node, or null if no parent
    */
   getParent(node) {
-    throw new Error('getParent() not implemented');
+    throw new Error("getParent() not implemented");
   }
 
   /**
@@ -126,7 +126,7 @@ export class AdapterInterface {
    * @returns {any[]} - Array of sibling element nodes (excluding the node itself)
    */
   getSiblings(node) {
-    throw new Error('getSiblings() not implemented');
+    throw new Error("getSiblings() not implemented");
   }
 
   /**
@@ -138,13 +138,22 @@ export class AdapterInterface {
     return null;
   }
 
+  /**
+   * Get character position for a node (optional, for validation)
+   * @param {any} node - Element node
+   * @returns {number | null}
+   */
+  getCharacterPosition(node) {
+    return null;
+  }
+
   /**
    * Stringify element for logging/debugging
    * @param {any} node - Element node
    * @returns {string} - String representation like "<meta charset='utf-8'>"
    */
   stringify(node) {
-    throw new Error('stringify() not implemented');
+    throw new Error("stringify() not implemented");
   }
 }
 
@@ -154,11 +163,11 @@ export class AdapterInterface {
  * @throws {Error} If adapter is missing required methods
  */
 export function validateAdapter(adapter) {
-  if (!adapter || typeof adapter !== 'object') {
-    throw new Error('Adapter must be an object');
+  if (!adapter || typeof adapter !== "object") {
+    throw new Error("Adapter must be an object");
   }
   for (const method of REQUIRED_METHODS) {
-    if (typeof /** @type {Record<string, any>} */ (adapter)[method] !== 'function') {
+    if (typeof (/** @type {Record<string, any>} */ (adapter)[method]) !== "function") {
       throw new Error(`Adapter missing required method: ${method}()`);
     }
   }