@herb-tools/linter 0.7.4 → 0.8.0

package/dist/src/herb-disable-comment-utils.js

@@ -0,0 +1,129 @@
+/**
+ * Utilities for parsing herb:disable comments
+ */
+/**
+ * Prefix for herb:disable comments
+ */
+const HERB_DISABLE_PREFIX = "herb:disable";
+/**
+ * Parse a herb:disable comment from ERB comment content.
+ * Use this when you have the content inside <%# ... %> (e.g., from ERBContentNode.content.value)
+ *
+ * @param content - The content string (without <%# %> delimiters)
+ * @returns Parsed comment data or null if not a valid herb:disable comment
+ *
+ * @example
+ * ```ts
+ * const result = parseHerbDisableContent("herb:disable rule1, rule2")
+ * // { match: "herb:disable rule1, rule2", ruleNames: ["rule1", "rule2"], rulesString: "rule1, rule2" }
+ * ```
+ */
+export function parseHerbDisableContent(content) {
+    const trimmed = content.trim();
+    if (!trimmed.startsWith(HERB_DISABLE_PREFIX))
+        return null;
+    const afterPrefix = trimmed.substring(HERB_DISABLE_PREFIX.length).trimStart();
+    if (afterPrefix.length === 0)
+        return null;
+    const rulesString = afterPrefix.trimEnd();
+    const ruleNames = rulesString.split(',').map(name => name.trim());
+    if (ruleNames.some(name => name.length === 0))
+        return null;
+    if (ruleNames.length === 0)
+        return null;
+    const herbDisablePrefix = content.indexOf(HERB_DISABLE_PREFIX);
+    const searchStart = herbDisablePrefix + HERB_DISABLE_PREFIX.length;
+    const rulesStringOffset = content.indexOf(rulesString, searchStart);
+    const ruleNameDetails = [];
+    let currentOffset = 0;
+    for (const ruleName of ruleNames) {
+        const ruleOffset = rulesString.indexOf(ruleName, currentOffset);
+        ruleNameDetails.push({
+            name: ruleName,
+            offset: rulesStringOffset + ruleOffset,
+            length: ruleName.length
+        });
+        currentOffset = ruleOffset + ruleName.length;
+    }
+    return {
+        match: trimmed,
+        ruleNames,
+        ruleNameDetails,
+        rulesString
+    };
+}
+/**
+ * Parse a herb:disable comment from a full source line.
+ * Use this when you have a complete line that may contain <%# herb:disable ... %>
+ *
+ * @param line - The source line that may contain a herb:disable comment
+ * @returns Parsed comment data or null if not a valid herb:disable comment
+ *
+ * @example
+ * ```ts
+ * const result = parseHerbDisableLine("<div>test</div> <%# herb:disable rule1, rule2 %>")
+ * // { match: "<%# herb:disable rule1, rule2 %>", ruleNames: ["rule1", "rule2"], rulesString: "rule1, rule2" }
+ * ```
+ */
+export function parseHerbDisableLine(line) {
+    const startTag = "<%#";
+    const endTag = "%>";
+    const startIndex = line.indexOf(startTag);
+    if (startIndex === -1)
+        return null;
+    const endIndex = line.indexOf(endTag, startIndex);
+    if (endIndex === -1)
+        return null;
+    const content = line.substring(startIndex + startTag.length, endIndex).trim();
+    if (!content.startsWith(HERB_DISABLE_PREFIX))
+        return null;
+    const afterPrefix = content.substring(HERB_DISABLE_PREFIX.length).trimStart();
+    if (afterPrefix.length === 0)
+        return null;
+    const rulesString = afterPrefix.trimEnd();
+    const ruleNames = rulesString.split(',').map(name => name.trim());
+    if (ruleNames.some(name => name.length === 0))
+        return null;
+    if (ruleNames.length === 0)
+        return null;
+    const herbDisablePrefix = line.indexOf(HERB_DISABLE_PREFIX);
+    const searchStart = herbDisablePrefix + HERB_DISABLE_PREFIX.length;
+    const rulesStringOffset = line.indexOf(rulesString, searchStart);
+    const ruleNameDetails = [];
+    let currentOffset = 0;
+    for (const ruleName of ruleNames) {
+        const ruleOffset = rulesString.indexOf(ruleName, currentOffset);
+        ruleNameDetails.push({
+            name: ruleName,
+            offset: rulesStringOffset + ruleOffset,
+            length: ruleName.length
+        });
+        currentOffset = ruleOffset + ruleName.length;
+    }
+    const fullMatch = line.substring(startIndex, endIndex + endTag.length);
+    return {
+        match: fullMatch,
+        ruleNames,
+        ruleNameDetails,
+        rulesString
+    };
+}
+/**
+ * Check if an ERB comment content contains a herb:disable directive.
+ *
+ * @param content - The content string (without <%# %> delimiters)
+ * @returns true if the content contains a herb:disable directive
+ */
+export function isHerbDisableContent(content) {
+    return parseHerbDisableContent(content) !== null;
+}
+/**
+ * Check if a source line contains a herb:disable comment.
+ *
+ * @param line - The source line
+ * @returns true if the line contains a herb:disable comment
+ */
+export function isHerbDisableLine(line) {
+    return parseHerbDisableLine(line) !== null;
+}
+//# sourceMappingURL=herb-disable-comment-utils.js.map

package/dist/src/herb-disable-comment-utils.js.map

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

package/dist/src/index.js

@@ -1,4 +1,5 @@
 export * from "./linter.js";
 export * from "./rules/index.js";
 export * from "./types.js";
+export { rules } from "./rules.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/linter.js

@@ -1,24 +1,104 @@
-import { defaultRules } from "./default-rules.js";
+import { Location } from "@herb-tools/core";
+import { IdentityPrinter } from "@herb-tools/printer";
+import { minimatch } from "minimatch";
+import { rules } from "./rules.js";
+import { findNodeByLocation } from "./rules/rule-utils.js";
+import { parseHerbDisableLine } from "./herb-disable-comment-utils.js";
+import { ParserNoErrorsRule } from "./rules/parser-no-errors.js";
+import { DEFAULT_RULE_CONFIG } from "./types.js";
 export class Linter {
     rules;
+    allAvailableRules;
     herb;
     offenses;
+    config;
+    /**
+     * Creates a new Linter instance with automatic rule filtering based on config.
+     *
+     * @param herb - The Herb backend instance for parsing and lexing
+     * @param config - Optional full Config instance for rule filtering, severity overrides, and path-based filtering
+     * @param customRules - Optional array of custom rules to include alongside built-in rules
+     * @returns A configured Linter instance
+     */
+    static from(herb, config, customRules) {
+        const allRules = customRules ? [...rules, ...customRules] : rules;
+        const filteredRules = config?.linter?.rules
+            ? Linter.filterRulesByConfig(allRules, config.linter.rules)
+            : undefined;
+        return new Linter(herb, filteredRules, config, allRules);
+    }
     /**
      * Creates a new Linter instance.
+     *
+     * For most use cases, prefer `Linter.from()` which handles config-based filtering.
+     * Use this constructor directly when you need explicit control over rules.
+     *
      * @param herb - The Herb backend instance for parsing and lexing
      * @param rules - Array of rule classes (Parser/AST or Lexer) to use. If not provided, uses default rules.
+     * @param config - Optional full Config instance for severity overrides and path-based rule filtering
+     * @param allAvailableRules - Optional array of ALL available rules (including disabled) for herb:disable validation
      */
-    constructor(herb, rules) {
+    constructor(herb, rules, config, allAvailableRules) {
         this.herb = herb;
+        this.config = config;
         this.rules = rules !== undefined ? rules : this.getDefaultRules();
+        this.allAvailableRules = allAvailableRules !== undefined ? allAvailableRules : this.rules;
         this.offenses = [];
     }
+    /**
+     * Filters rules based on default config and optional user config overrides.
+     *
+     * Priority:
+     * 1. User config override (if rule config exists in userRulesConfig)
+     * 2. Default config from rule's defaultConfig getter
+     *
+     * @param allRules - All available rule classes to filter from
+     * @param userRulesConfig - Optional user configuration for rules
+     * @returns Filtered array of rule classes that should be enabled
+     */
+    static filterRulesByConfig(allRules, userRulesConfig) {
+        return allRules.filter(ruleClass => {
+            const instance = new ruleClass();
+            const ruleName = instance.name;
+            const defaultEnabled = instance.defaultConfig?.enabled ?? DEFAULT_RULE_CONFIG.enabled;
+            const userRuleConfig = userRulesConfig?.[ruleName];
+            if (userRuleConfig !== undefined) {
+                return userRuleConfig.enabled !== false;
+            }
+            return defaultEnabled;
+        });
+    }
     /**
      * Returns the default set of rule classes used by the linter.
-     * @returns Array of rule classes
+     * These are the rules enabled when no custom rules are provided.
+     * Filters all available rules to only include those enabled by default.
+     * @returns Array of default rule classes
      */
     getDefaultRules() {
-        return defaultRules;
+        return Linter.filterRulesByConfig(rules);
+    }
+    /**
+     * Returns all available rule classes that can be referenced in herb:disable comments.
+     * This includes all rules that exist, regardless of whether they're currently enabled.
+     * Includes both built-in rules and any loaded custom rules.
+     * @returns Array of all available rule classes
+     */
+    getAvailableRules() {
+        return this.allAvailableRules;
+    }
+    /**
+     * Meta-linting rules for herb:disable comments cannot be disabled
+     * This ensures that invalid herb:disable comments are always caught
+     */
+    get nonExcludableRules() {
+        return [
+            "herb-disable-comment-valid-rule-name",
+            "herb-disable-comment-no-redundant-all",
+            "herb-disable-comment-no-duplicate-rules",
+            "herb-disable-comment-malformed",
+            "herb-disable-comment-missing-rules",
+            "herb-disable-comment-unnecessary"
+        ];
     }
     getRuleCount() {
         return this.rules.length;
@@ -35,6 +115,97 @@ export class Linter {
     isSourceRule(rule) {
         return rule.constructor.type === "source";
     }
+    /**
+     * Execute a single rule and return its unbound offenses.
+     * Handles rule type checking (Lexer/Parser/Source) and isEnabled checks.
+     */
+    executeRule(rule, parseResult, lexResult, source, context) {
+        if (this.config && context?.fileName) {
+            if (!this.config.isRuleEnabledForPath(rule.name, context.fileName)) {
+                return [];
+            }
+        }
+        if (context?.fileName && !this.config?.linter?.rules?.[rule.name]?.exclude) {
+            const defaultExclude = rule.defaultConfig?.exclude ?? DEFAULT_RULE_CONFIG.exclude;
+            if (defaultExclude && defaultExclude.length > 0) {
+                const isExcluded = defaultExclude.some((pattern) => minimatch(context.fileName, pattern));
+                if (isExcluded) {
+                    return [];
+                }
+            }
+        }
+        let isEnabled = true;
+        let ruleOffenses;
+        if (this.isLexerRule(rule)) {
+            if (rule.isEnabled) {
+                isEnabled = rule.isEnabled(lexResult, context);
+            }
+            if (isEnabled) {
+                ruleOffenses = rule.check(lexResult, context);
+            }
+            else {
+                ruleOffenses = [];
+            }
+        }
+        else if (this.isSourceRule(rule)) {
+            if (rule.isEnabled) {
+                isEnabled = rule.isEnabled(source, context);
+            }
+            if (isEnabled) {
+                ruleOffenses = rule.check(source, context);
+            }
+            else {
+                ruleOffenses = [];
+            }
+        }
+        else {
+            if (rule.isEnabled) {
+                isEnabled = rule.isEnabled(parseResult, context);
+            }
+            if (isEnabled) {
+                ruleOffenses = rule.check(parseResult, context);
+            }
+            else {
+                ruleOffenses = [];
+            }
+        }
+        return ruleOffenses;
+    }
+    filterOffenses(ruleOffenses, ruleName, ignoredOffensesByLine, herbDisableCache, ignoreDisableComments) {
+        const kept = [];
+        const ignored = [];
+        const wouldBeIgnored = [];
+        if (this.nonExcludableRules.includes(ruleName)) {
+            return { kept: ruleOffenses, ignored: [], wouldBeIgnored: [] };
+        }
+        if (ignoreDisableComments) {
+            for (const offense of ruleOffenses) {
+                const line = offense.location.start.line;
+                const disabledRules = herbDisableCache?.get(line) || [];
+                if (disabledRules.includes(ruleName) || disabledRules.includes("all")) {
+                    wouldBeIgnored.push(offense);
+                }
+            }
+            return { kept: ruleOffenses, ignored: [], wouldBeIgnored };
+        }
+        for (const offense of ruleOffenses) {
+            const line = offense.location.start.line;
+            const disabledRules = herbDisableCache?.get(line) || [];
+            if (disabledRules.includes(ruleName) || disabledRules.includes("all")) {
+                ignored.push(offense);
+                if (ignoredOffensesByLine) {
+                    if (!ignoredOffensesByLine.has(line)) {
+                        ignoredOffensesByLine.set(line, new Set());
+                    }
+                    const usedRuleName = disabledRules.includes(ruleName) ? ruleName : "all";
+                    ignoredOffensesByLine.get(line).add(usedRuleName);
+                }
+                continue;
+            }
+            kept.push(offense);
+        }
+        return { kept, ignored, wouldBeIgnored: [] };
+    }
     /**
      * Lint source code using Parser/AST, Lexer, and Source rules.
      * @param source - The source code to lint
@@ -42,53 +213,217 @@ export class Linter {
      */
     lint(source, context) {
         this.offenses = [];
+        let ignoredCount = 0;
+        let wouldBeIgnoredCount = 0;
         const parseResult = this.herb.parse(source, { track_whitespace: true });
         const lexResult = this.herb.lex(source);
-        for (const RuleClass of this.rules) {
+        const hasParserErrors = parseResult.recursiveErrors().length > 0;
+        const sourceLines = source.split("\n");
+        const ignoredOffensesByLine = new Map();
+        const herbDisableCache = new Map();
+        if (hasParserErrors) {
+            const hasParserRule = this.rules.find(RuleClass => (new RuleClass()).name === "parser-no-errors");
+            if (hasParserRule) {
+                const rule = new ParserNoErrorsRule();
+                const offenses = rule.check(parseResult);
+                this.offenses.push(...offenses);
+            }
+            return {
+                offenses: this.offenses,
+                errors: this.offenses.filter(o => o.severity === "error").length,
+                warnings: this.offenses.filter(o => o.severity === "warning").length,
+                info: this.offenses.filter(o => o.severity === "info").length,
+                hints: this.offenses.filter(o => o.severity === "hint").length,
+                ignored: 0
+            };
+        }
+        for (let i = 0; i < sourceLines.length; i++) {
+            const line = sourceLines[i];
+            if (line.includes("herb:disable")) {
+                const herbDisable = parseHerbDisableLine(line);
+                herbDisableCache.set(i + 1, herbDisable?.ruleNames || []);
+            }
+        }
+        context = {
+            ...context,
+            validRuleNames: this.getAvailableRules().map(RuleClass => new RuleClass().name),
+            ignoredOffensesByLine
+        };
+        const regularRules = this.rules.filter(RuleClass => {
             const rule = new RuleClass();
-            let isEnabled = true;
-            let ruleOffenses;
-            if (this.isLexerRule(rule)) {
-                if (rule.isEnabled) {
-                    isEnabled = rule.isEnabled(lexResult, context);
-                }
-                if (isEnabled) {
-                    ruleOffenses = rule.check(lexResult, context);
+            return rule.name !== "herb-disable-comment-unnecessary";
+        });
+        for (const RuleClass of regularRules) {
+            const rule = new RuleClass();
+            const unboundOffenses = this.executeRule(rule, parseResult, lexResult, source, context);
+            const boundOffenses = this.bindSeverity(unboundOffenses, rule.name);
+            const { kept, ignored, wouldBeIgnored } = this.filterOffenses(boundOffenses, rule.name, ignoredOffensesByLine, herbDisableCache, context?.ignoreDisableComments);
+            ignoredCount += ignored.length;
+            wouldBeIgnoredCount += wouldBeIgnored.length;
+            this.offenses.push(...kept);
+        }
+        const unnecessaryRuleClass = this.rules.find(RuleClass => {
+            const rule = new RuleClass();
+            return rule.name === "herb-disable-comment-unnecessary";
+        });
+        if (unnecessaryRuleClass) {
+            const unnecessaryRule = new unnecessaryRuleClass();
+            const unboundOffenses = unnecessaryRule.check(parseResult, context);
+            const boundOffenses = this.bindSeverity(unboundOffenses, unnecessaryRule.name);
+            this.offenses.push(...boundOffenses);
+        }
+        const finalOffenses = this.offenses;
+        const errors = finalOffenses.filter(offense => offense.severity === "error").length;
+        const warnings = finalOffenses.filter(offense => offense.severity === "warning").length;
+        const info = finalOffenses.filter(offense => offense.severity === "info").length;
+        const hints = finalOffenses.filter(offense => offense.severity === "hint").length;
+        const result = {
+            offenses: finalOffenses,
+            errors,
+            warnings,
+            info,
+            hints,
+            ignored: ignoredCount
+        };
+        if (wouldBeIgnoredCount > 0) {
+            result.wouldBeIgnored = wouldBeIgnoredCount;
+        }
+        return result;
+    }
+    /**
+     * Bind severity to unbound offenses based on rule's defaultConfig and user config overrides.
+     *
+     * Priority:
+     * 1. User config severity override (if specified in config)
+     * 2. Rule's default severity (from defaultConfig.severity)
+     *
+     * @param unboundOffenses - Array of offenses without severity
+     * @param ruleName - Name of the rule that produced the offenses
+     * @returns Array of offenses with severity bound
+     */
+    bindSeverity(unboundOffenses, ruleName) {
+        const RuleClass = this.rules.find(rule => {
+            const instance = new rule();
+            return instance.name === ruleName;
+        });
+        if (!RuleClass) {
+            return unboundOffenses.map(offense => ({
+                ...offense,
+                severity: "error"
+            }));
+        }
+        const ruleInstance = new RuleClass();
+        const defaultSeverity = ruleInstance.defaultConfig?.severity ?? DEFAULT_RULE_CONFIG.severity;
+        const userRuleConfig = this.config?.linter?.rules?.[ruleName];
+        const severity = userRuleConfig?.severity ?? defaultSeverity;
+        return unboundOffenses.map(offense => ({
+            ...offense,
+            severity
+        }));
+    }
+    /**
+     * Automatically fix offenses in the source code.
+     * Uses AST mutation for parser rules and token mutation for lexer rules.
+     * @param source - The source code to fix
+     * @param context - Optional context for linting (e.g., fileName)
+     * @param offensesToFix - Optional array of specific offenses to fix. If not provided, all fixable offenses will be fixed.
+     * @returns AutofixResult containing the corrected source and lists of fixed/unfixed offenses
+     */
+    autofix(source, context, offensesToFix) {
+        const lintResult = offensesToFix ? { offenses: offensesToFix } : this.lint(source, context);
+        const parserOffenses = [];
+        const lexerOffenses = [];
+        const sourceOffenses = [];
+        for (const offense of lintResult.offenses) {
+            const RuleClass = this.rules.find(rule => {
+                const instance = new rule();
+                return instance.name === offense.rule;
+            });
+            if (!RuleClass)
+                continue;
+            if (RuleClass.type === "lexer") {
+                lexerOffenses.push(offense);
+            }
+            else if (RuleClass.type === "source") {
+                sourceOffenses.push(offense);
+            }
+            else {
+                parserOffenses.push(offense);
+            }
+        }
+        let currentSource = source;
+        const fixed = [];
+        const unfixed = [];
+        if (parserOffenses.length > 0) {
+            const parseResult = this.herb.parse(currentSource, { track_whitespace: true });
+            for (const offense of parserOffenses) {
+                const RuleClass = this.rules.find(rule => new rule().name === offense.rule);
+                if (!RuleClass) {
+                    unfixed.push(offense);
+                    continue;
                 }
-                else {
-                    ruleOffenses = [];
+                const rule = new RuleClass();
+                if (!rule.autofix) {
+                    unfixed.push(offense);
+                    continue;
                 }
-            }
-            else if (this.isSourceRule(rule)) {
-                if (rule.isEnabled) {
-                    isEnabled = rule.isEnabled(source, context);
+                if (offense.autofixContext) {
+                    const originalNodeType = offense.autofixContext.node.type;
+                    const location = offense.autofixContext.node.location ? Location.from(offense.autofixContext.node.location) : offense.location;
+                    const freshNode = findNodeByLocation(parseResult.value, location, (node) => node.type === originalNodeType);
+                    if (freshNode) {
+                        offense.autofixContext.node = freshNode;
+                    }
+                    else {
+                        unfixed.push(offense);
+                        continue;
+                    }
                 }
-                if (isEnabled) {
-                    ruleOffenses = rule.check(source, context);
+                const fixedResult = rule.autofix(offense, parseResult, context);
+                if (fixedResult) {
+                    fixed.push(offense);
                 }
                 else {
-                    ruleOffenses = [];
+                    unfixed.push(offense);
                 }
             }
-            else {
-                if (rule.isEnabled) {
-                    isEnabled = rule.isEnabled(parseResult, context);
+            if (fixed.length > 0) {
+                const printer = new IdentityPrinter();
+                currentSource = printer.print(parseResult.value);
+            }
+        }
+        if (sourceOffenses.length > 0) {
+            const sortedSourceOffenses = sourceOffenses.sort((a, b) => {
+                if (a.location.start.line !== b.location.start.line) {
+                    return b.location.start.line - a.location.start.line;
+                }
+                return b.location.start.column - a.location.start.column;
+            });
+            for (const offense of sortedSourceOffenses) {
+                const RuleClass = this.rules.find(rule => new rule().name === offense.rule);
+                if (!RuleClass) {
+                    unfixed.push(offense);
+                    continue;
                 }
-                if (isEnabled) {
-                    ruleOffenses = rule.check(parseResult, context);
+                const rule = new RuleClass();
+                if (!rule.autofix) {
+                    unfixed.push(offense);
+                    continue;
+                }
+                const correctedSource = rule.autofix(offense, currentSource, context);
+                if (correctedSource) {
+                    currentSource = correctedSource;
+                    fixed.push(offense);
                 }
                 else {
-                    ruleOffenses = [];
+                    unfixed.push(offense);
                 }
             }
-            this.offenses.push(...ruleOffenses);
         }
-        const errors = this.offenses.filter(offense => offense.severity === "error").length;
-        const warnings = this.offenses.filter(offense => offense.severity === "warning").length;
         return {
-            offenses: this.offenses,
-            errors,
-            warnings
+            source: currentSource,
+            fixed,
+            unfixed
         };
     }
 }

package/dist/src/linter.js.map

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

package/dist/src/loader.js

@@ -0,0 +1,17 @@
+export * from "./index.js";
+export { CustomRuleLoader } from "./custom-rule-loader.js";
+import { CustomRuleLoader } from "./custom-rule-loader.js";
+/**
+ * Loads custom rules from the filesystem.
+ * Only available in Node.js environments.
+ */
+export async function loadCustomRules(options) {
+    const loader = new CustomRuleLoader(options);
+    const { rules: customRules, ruleInfo, duplicateWarnings } = await loader.loadRulesWithInfo();
+    return {
+        rules: customRules,
+        ruleInfo,
+        warnings: duplicateWarnings
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/loader.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAIrC;IAKC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAA;IAE5F,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,QAAQ;QACR,QAAQ,EAAE,iBAAiB;KAC5B,CAAA;AACH,CAAC"}