podlite 0.0.78 → 0.0.80

package/lib/lint/rules/abbreviated-attrs.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.abbreviatedAttrsRule = exports.ABBREVIATED_ATTRS_RULE_ID = void 0;
+exports.scanAbbreviatedAttrs = scanAbbreviatedAttrs;
+const schema_1 = require("@podlite/schema");
+exports.ABBREVIATED_ATTRS_RULE_ID = 'abbreviated-attrs';
+exports.abbreviatedAttrsRule = {
+    id: exports.ABBREVIATED_ATTRS_RULE_ID,
+    severity: 'warning',
+};
+// The specification is plain about it: the rest of an abbreviated block's line
+// is block data, not configuration. What the author wrote as an attribute
+// arrives as text, the markup stays legal, and nothing says the mechanism did
+// not run.
+const ABBREVIATED = /^\s*=([A-Za-z][\w-]*)[ \t]+(\S.*)$/;
+const DELIMITED = /^\s*=(?:begin|end|for)[ \t]+([\w-]+)/;
+// Only a line made of attributes and nothing else is reported. A line where
+// attributes stand next to real text is the author writing prose that happens
+// to hold a colon, and calling that a fault would bury the rule in noise.
+const ONLY_ATTRIBUTES = /^(:[A-Za-z][\w-]*(<[^>]*>|\([^)]*\)|\{[^}]*\}|\[[^\]]*\])?[ \t]*)+$/;
+// An attribute written with nothing inside documents the attribute itself,
+// which is how the registries and the specifications spell one out.
+const EMPTY_VALUE = /^:[A-Za-z][\w-]*<>$/;
+const allEmpty = (rest) => rest
+    .trim()
+    .split(/[ \t]+/)
+    .every(part => EMPTY_VALUE.test(part));
+function scanAbbreviatedAttrs(content) {
+    const lines = content.split(/\r?\n/);
+    const open = [];
+    const violations = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const delimited = line.match(DELIMITED);
+        if (delimited) {
+            if (/^\s*=end\b/.test(line))
+                open.pop();
+            else if (/^\s*=begin\b/.test(line))
+                open.push(delimited[1]);
+            continue;
+        }
+        if (open.some(schema_1.isVerbatimBlock))
+            continue;
+        const abbreviated = line.match(ABBREVIATED);
+        if (!abbreviated)
+            continue;
+        const [, name, rest] = abbreviated;
+        if ((0, schema_1.isVerbatimBlock)(name))
+            continue;
+        if (!ONLY_ATTRIBUTES.test(rest.trim()))
+            continue;
+        if (allEmpty(rest))
+            continue;
+        // content has to follow, otherwise the line is the whole block and the
+        // author wrote no data at all — a different mistake, if it is one
+        const next = lines[i + 1];
+        if (next === undefined || next.trim() === '' || /^\s*=/.test(next))
+            continue;
+        violations.push({
+            rule: exports.ABBREVIATED_ATTRS_RULE_ID,
+            severity: 'warning',
+            message: `=${name} takes the rest of its line as data, so ${rest.trim()} arrives as text; write =for ${name} to pass configuration`,
+            location: {
+                start: { line: i + 1, column: 1, offset: 0 },
+                end: { line: i + 1, column: 1, offset: 0 },
+            },
+        });
+    }
+    return violations;
+}
+//# sourceMappingURL=abbreviated-attrs.js.map

package/lib/lint/rules/abbreviated-attrs.js.map

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

package/lib/lint/rules/attr-value-dropped.js

@@ -5,9 +5,10 @@ exports.ATTR_VALUE_DROPPED_RULE_ID = 'attr-value-dropped';
 exports.attrValueDroppedRule = {
     id: exports.ATTR_VALUE_DROPPED_RULE_ID,
     severity: 'warning',
-    // a directive the parser could not read is the business of syntax-valid
+    // a directive the parser could not read is the business of syntax-valid,
+    // a table that was reshaped is the business of table-shape
     check: (ast, _ctx) => (ast.diagnostics || [])
-        .filter(d => d.code !== 'directive-unreadable')
+        .filter(d => d.code === 'value-unreadable')
         .map(d => ({
         rule: exports.ATTR_VALUE_DROPPED_RULE_ID,
         severity: d.severity,

package/lib/lint/rules/attr-value-dropped.js.map

@@ -1 +1 @@
-{"version":3,"file":"attr-value-dropped.js","sourceRoot":"","sources":["../../../src/lint/rules/attr-value-dropped.ts"],"names":[],"mappings":";;;AAGa,QAAA,0BAA0B,GAAG,oBAAoB,CAAA;AAEjD,QAAA,oBAAoB,GAAS;IACxC,EAAE,EAAE,kCAA0B;IAC9B,QAAQ,EAAE,SAAS;IACnB,wEAAwE;IACxE,KAAK,EAAE,CAAC,GAAoB,EAAE,IAAiB,EAAe,EAAE,CAC9D,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACT,IAAI,EAAE,kCAA0B;QAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC,CAAC;CACR,CAAA"}
+{"version":3,"file":"attr-value-dropped.js","sourceRoot":"","sources":["../../../src/lint/rules/attr-value-dropped.ts"],"names":[],"mappings":";;;AAGa,QAAA,0BAA0B,GAAG,oBAAoB,CAAA;AAEjD,QAAA,oBAAoB,GAAS;IACxC,EAAE,EAAE,kCAA0B;IAC9B,QAAQ,EAAE,SAAS;IACnB,yEAAyE;IACzE,2DAA2D;IAC3D,KAAK,EAAE,CAAC,GAAoB,EAAE,IAAiB,EAAe,EAAE,CAC9D,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACT,IAAI,EAAE,kCAA0B;QAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC,CAAC;CACR,CAAA"}

package/lib/lint/rules/dead-definitions.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types';
+export declare const DEAD_DEFINITIONS_RULE_ID = "dead-definitions";
+export declare const deadDefinitionsRule: Rule;

package/lib/lint/rules/dead-definitions.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deadDefinitionsRule = exports.DEAD_DEFINITIONS_RULE_ID = void 0;
+const schema_1 = require("@podlite/schema");
+exports.DEAD_DEFINITIONS_RULE_ID = 'dead-definitions';
+const attr = (node, name) => {
+    const item = (Array.isArray(node.config) ? node.config : []).find(c => c && c.name === name);
+    return item && item.value !== undefined && item.value !== null ? String(item.value) : undefined;
+};
+// An alias node carries no location, so the line is read back from the source;
+// a warning that cannot say where is a warning the author cannot act on.
+const aliasLine = (source, name) => {
+    const lines = source.split(/\r?\n/);
+    const at = lines.findIndex(line => new RegExp(`^\\s*=alias\\s+${name}(\\s|$)`).test(line));
+    if (at === -1)
+        return undefined;
+    return { start: { line: at + 1, column: 1, offset: 0 }, end: { line: at + 1, column: 1, offset: 0 } };
+};
+const definitions = (ast) => {
+    const nodes = (0, schema_1.getFromTree)(ast, () => true);
+    const found = [];
+    for (const node of nodes) {
+        if (node.type === 'alias' && node.name) {
+            found.push({ kind: 'alias', name: node.name, location: node.location });
+            continue;
+        }
+        if (node.name === 'data') {
+            const key = attr(node, 'key');
+            if (key)
+                found.push({ kind: 'data', name: key, location: node.location });
+        }
+    }
+    return found;
+};
+const aliasUses = (ast) => {
+    const nodes = (0, schema_1.getFromTree)(ast, () => true);
+    const used = new Set();
+    for (const node of nodes) {
+        if (node.type !== 'fcode' || node.name !== 'A')
+            continue;
+        const name = (0, schema_1.getTextContentFromNode)(node)
+            ?.toString()
+            .trim();
+        if (name)
+            used.add(name);
+    }
+    return used;
+};
+// A data reference is read from the source rather than from the tree: the block
+// that consumes it resolves the reference while the tree is built, so by the
+// time a rule sees the tree the mention is already gone.
+const dataUses = (source) => {
+    const used = new Set();
+    const reference = /data:([A-Za-z0-9_-]+)/g;
+    let match;
+    while ((match = reference.exec(source)) !== null)
+        used.add(match[1]);
+    return used;
+};
+exports.deadDefinitionsRule = {
+    id: exports.DEAD_DEFINITIONS_RULE_ID,
+    severity: 'warning',
+    check: (ast, ctx) => {
+        // without the source a data reference cannot be found at all, and reporting
+        // every keyed block as dead would be worse than saying nothing
+        const declared = definitions(ast).filter(item => item.kind === 'alias' || ctx.source !== undefined);
+        if (declared.length === 0)
+            return [];
+        const aliases = aliasUses(ast);
+        const keys = dataUses(ctx.source || '');
+        return declared
+            .filter(item => !(item.kind === 'alias' ? aliases.has(item.name) : keys.has(item.name)))
+            .map(item => ({
+            rule: exports.DEAD_DEFINITIONS_RULE_ID,
+            severity: 'warning',
+            message: item.kind === 'alias'
+                ? `=alias ${item.name} is never used; A<${item.name}> appears nowhere in the document`
+                : `=data :key<${item.name}> is never used; data:${item.name} appears nowhere in the document`,
+            location: item.location || (item.kind === 'alias' ? aliasLine(ctx.source || '', item.name) : undefined),
+        }));
+    },
+};
+//# sourceMappingURL=dead-definitions.js.map

package/lib/lint/rules/dead-definitions.js.map

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

package/lib/lint/rules/index.js

@@ -7,6 +7,8 @@ const id_unique_1 = require("./id-unique");
 const media_absolute_file_1 = require("./media-absolute-file");
 const link_target_resolves_1 = require("./link-target-resolves");
 const attr_value_dropped_1 = require("./attr-value-dropped");
+const table_shape_1 = require("./table-shape");
+const dead_definitions_1 = require("./dead-definitions");
 exports.DEFAULT_RULES = [
     syntax_valid_1.syntaxValidRule,
     heading_hierarchy_1.headingHierarchyRule,
@@ -14,5 +16,7 @@ exports.DEFAULT_RULES = [
     media_absolute_file_1.mediaAbsoluteFileRule,
     link_target_resolves_1.linkTargetResolvesRule,
     attr_value_dropped_1.attrValueDroppedRule,
+    table_shape_1.tableShapeRule,
+    dead_definitions_1.deadDefinitionsRule,
 ];
 //# sourceMappingURL=index.js.map

package/lib/lint/rules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":";;;AACA,iDAAgD;AAChD,2DAA0D;AAC1D,2CAA0C;AAC1C,+DAA6D;AAC7D,iEAA+D;AAC/D,6DAA2D;AAE9C,QAAA,aAAa,GAAW;IACnC,8BAAe;IACf,wCAAoB;IACpB,wBAAY;IACZ,2CAAqB;IACrB,6CAAsB;IACtB,yCAAoB;CACrB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":";;;AACA,iDAAgD;AAChD,2DAA0D;AAC1D,2CAA0C;AAC1C,+DAA6D;AAC7D,iEAA+D;AAC/D,6DAA2D;AAC3D,+CAA8C;AAC9C,yDAAwD;AAE3C,QAAA,aAAa,GAAW;IACnC,8BAAe;IACf,wCAAoB;IACpB,wBAAY;IACZ,2CAAqB;IACrB,6CAAsB;IACtB,yCAAoB;IACpB,4BAAc;IACd,sCAAmB;CACpB,CAAA"}

package/lib/lint/rules/markdown-in-pod.d.ts

@@ -0,0 +1,4 @@
+import type { Violation, SourceRule } from '../types';
+export declare const MARKDOWN_IN_POD_RULE_ID = "markdown-in-pod";
+export declare const markdownInPodRule: SourceRule;
+export declare function scanMarkdownInPod(content: string): Violation[];

package/lib/lint/rules/markdown-in-pod.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownInPodRule = exports.MARKDOWN_IN_POD_RULE_ID = void 0;
+exports.scanMarkdownInPod = scanMarkdownInPod;
+const schema_1 = require("@podlite/schema");
+exports.MARKDOWN_IN_POD_RULE_ID = 'markdown-in-pod';
+exports.markdownInPodRule = {
+    id: exports.MARKDOWN_IN_POD_RULE_ID,
+    severity: 'warning',
+};
+const FOREIGN = [
+    { test: /^\s*#{1,6}\s+\S/, says: 'a heading written with hashes is text here; write =head1 and its levels' },
+    {
+        test: /^\s*\|?[\s:|-]*-[\s:|-]*\|[\s:|-]*$/,
+        says: 'a row of bars and dashes is text here; a table is written as =begin table with its own separator',
+    },
+    { test: /\*\*[^*\s](?:[^*]*[^*\s])?\*\*/, says: 'a pair of asterisks is text here; bold is written as B<>' },
+];
+// Talk about Markdown is legal: a line whose construct sits inside an inline
+// code span is showing the markup, not using it.
+const insideCode = (line) => /C<[^>]*>/.test(line) || /`[^`]+`/.test(line);
+function scanMarkdownInPod(content) {
+    const lines = content.split(/\r?\n/);
+    const open = [];
+    const violations = [];
+    let abbreviatedTable = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const end = line.match(/^\s*=end\s+([\w-]+)/);
+        if (end) {
+            open.pop();
+            continue;
+        }
+        const begin = line.match(/^\s*=begin\s+([\w-]+)/);
+        if (begin) {
+            open.push(begin[1]);
+            abbreviatedTable = false;
+            continue;
+        }
+        // a dash separator belongs to a table written the short way too, and that
+        // block runs to the first blank line
+        if (/^\s*=(?:for\s+)?table\b/.test(line)) {
+            abbreviatedTable = true;
+            continue;
+        }
+        if (abbreviatedTable && line.trim() === '')
+            abbreviatedTable = false;
+        if (/^\s*=/.test(line))
+            abbreviatedTable = false;
+        if (open.some(schema_1.isVerbatimBlock) || open.includes('data') || abbreviatedTable)
+            continue;
+        if (insideCode(line))
+            continue;
+        for (const foreign of FOREIGN) {
+            if (!foreign.test.test(line))
+                continue;
+            violations.push({
+                rule: exports.MARKDOWN_IN_POD_RULE_ID,
+                severity: 'warning',
+                message: foreign.says,
+                location: {
+                    start: { line: i + 1, column: 1, offset: 0 },
+                    end: { line: i + 1, column: 1, offset: 0 },
+                },
+            });
+            break;
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=markdown-in-pod.js.map

package/lib/lint/rules/markdown-in-pod.js.map

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

package/lib/lint/rules/table-column-width.d.ts

@@ -0,0 +1,4 @@
+import type { Violation, SourceRule } from '../types';
+export declare const TABLE_COLUMN_WIDTH_RULE_ID = "table-column-width";
+export declare const tableColumnWidthRule: SourceRule;
+export declare function scanTableColumns(content: string): Violation[];

package/lib/lint/rules/table-column-width.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableColumnWidthRule = exports.TABLE_COLUMN_WIDTH_RULE_ID = void 0;
+exports.scanTableColumns = scanTableColumns;
+const schema_1 = require("@podlite/schema");
+exports.TABLE_COLUMN_WIDTH_RULE_ID = 'table-column-width';
+exports.tableColumnWidthRule = {
+    id: exports.TABLE_COLUMN_WIDTH_RULE_ID,
+    severity: 'warning',
+};
+const SEPARATOR_LINE = /^[\s=+|_-]*[|+][\s=+|_-]*$/;
+const hasBar = (line) => line.includes('|') || line.includes('+');
+// A table with visible bars is cut by the column positions its separator line
+// sets, not by the bars in the row itself. A cell that reaches the boundary
+// pushes the column open for the whole table, so every row loses its last
+// column at once — and the document still parses, silently.
+const boundaries = (separator) => {
+    const out = [];
+    for (let i = 0; i < separator.length; i++) {
+        if (separator[i] === '|' || separator[i] === '+')
+            out.push(i);
+    }
+    return out;
+};
+const isEdge = (char) => char === '|' || char === '+' || char === ' ';
+const collides = (line, boundary) => {
+    if (boundary >= line.length)
+        return false;
+    // content standing on the boundary is wrong however the row is written
+    if (!isEdge(line[boundary]))
+        return true;
+    // pressed against the boundary only matters where the row draws a bar of its
+    // own: a row whose cells are held apart by spaces may fill its column to the
+    // last position, and the parser reads it correctly
+    const drawsBar = line[boundary] === '|' || line[boundary] === '+';
+    return drawsBar && boundary > 0 && !isEdge(line[boundary - 1]);
+};
+const checkTable = (lines) => {
+    const separator = lines.find(l => SEPARATOR_LINE.test(l.text) && hasBar(l.text));
+    if (!separator)
+        return [];
+    const columns = boundaries(separator.text);
+    if (columns.length === 0)
+        return [];
+    const violations = [];
+    for (const row of lines) {
+        if (row === separator || row.text.trim() === '')
+            continue;
+        if (SEPARATOR_LINE.test(row.text))
+            continue;
+        const hit = columns.find(b => collides(row.text, b));
+        if (hit === undefined)
+            continue;
+        violations.push({
+            rule: exports.TABLE_COLUMN_WIDTH_RULE_ID,
+            severity: 'warning',
+            message: `cell reaches the column boundary at column ${hit + 1}; leave a space before the bar or the table loses a column`,
+            location: {
+                start: { line: row.line, column: hit + 1, offset: 0 },
+                end: { line: row.line, column: hit + 1, offset: 0 },
+            },
+        });
+    }
+    return violations;
+};
+function scanTableColumns(content) {
+    const lines = content.split(/\r?\n/);
+    // a table keeps its content verbatim too, and it is the one being read here
+    const verbatim = (name) => name !== 'table' && (0, schema_1.isVerbatimBlock)(name);
+    const openBlocks = [];
+    const violations = [];
+    let table = null;
+    const closeTable = () => {
+        if (table)
+            violations.push(...checkTable(table));
+        table = null;
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const text = lines[i];
+        const begin = text.match(/^\s*=begin\s+([\w-]+)/);
+        const end = text.match(/^\s*=end\s+([\w-]+)/);
+        const abbreviated = text.match(/^\s*=(?:for\s+)?table\b/);
+        if (end) {
+            if (end[1] === 'table')
+                closeTable();
+            openBlocks.pop();
+            continue;
+        }
+        if (begin) {
+            closeTable();
+            openBlocks.push(begin[1]);
+            if (begin[1] === 'table' && !openBlocks.some(verbatim))
+                table = [];
+            continue;
+        }
+        if (openBlocks.some(verbatim))
+            continue;
+        if (abbreviated) {
+            closeTable();
+            table = [];
+            continue;
+        }
+        // an abbreviated table ends at the first blank line
+        if (table && text.trim() === '' && !openBlocks.includes('table')) {
+            closeTable();
+            continue;
+        }
+        if (table)
+            table.push({ text, line: i + 1 });
+    }
+    closeTable();
+    return violations;
+}
+//# sourceMappingURL=table-column-width.js.map

package/lib/lint/rules/table-column-width.js.map

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

package/lib/lint/rules/table-shape.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../types';
+export declare const TABLE_SHAPE_RULE_ID = "table-shape";
+export declare const tableShapeRule: Rule;

package/lib/lint/rules/table-shape.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableShapeRule = exports.TABLE_SHAPE_RULE_ID = void 0;
+exports.TABLE_SHAPE_RULE_ID = 'table-shape';
+const TABLE_CODES = ['table-row-cells', 'table-cell-outside-row', 'table-mixed-separators', 'table-source-unreadable'];
+exports.tableShapeRule = {
+    id: exports.TABLE_SHAPE_RULE_ID,
+    severity: 'warning',
+    check: (ast, _ctx) => (ast.diagnostics || [])
+        .filter(d => TABLE_CODES.includes(d.code))
+        .map(d => ({
+        rule: exports.TABLE_SHAPE_RULE_ID,
+        severity: d.severity,
+        message: d.message,
+        location: d.location,
+    })),
+};
+//# sourceMappingURL=table-shape.js.map

package/lib/lint/rules/table-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-shape.js","sourceRoot":"","sources":["../../../src/lint/rules/table-shape.ts"],"names":[],"mappings":";;;AAGa,QAAA,mBAAmB,GAAG,aAAa,CAAA;AAEhD,MAAM,WAAW,GAAG,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,yBAAyB,CAAC,CAAA;AAEzG,QAAA,cAAc,GAAS;IAClC,EAAE,EAAE,2BAAmB;IACvB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,CAAC,GAAoB,EAAE,IAAiB,EAAe,EAAE,CAC9D,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACT,IAAI,EAAE,2BAAmB;QACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC,CAAC;CACR,CAAA"}

package/lib/lint/types.d.ts

@@ -1,11 +1,15 @@
 import type { Location, PodliteDocument } from '@podlite/schema';
 export type Severity = 'error' | 'warning' | 'info';
 export type FileType = 'md' | 'podlite';
-export type LintConfig = Record<string, never>;
+export type RuleSetting = 'off' | Severity;
+export type LintConfig = {
+    rules?: Record<string, RuleSetting>;
+};
 export type LintContext = {
     filePath: string;
     fileType: FileType;
     config: LintConfig;
+    source?: string;
 };
 export type Violation = {
     rule: string;

package/lib/lint/worker.d.ts

@@ -0,0 +1,5 @@
+import type { FileReport } from './formatters/text';
+export type WorkerResult = {
+    index: number;
+    report: FileReport;
+};

package/lib/lint/worker.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const index_1 = require("./index");
+if (worker_threads_1.parentPort) {
+    const port = worker_threads_1.parentPort;
+    // the first message back says the parser is loaded and the thread can be fed
+    port.postMessage('ready');
+    port.on('message', (batch) => {
+        const done = batch.jobs.map(job => ({
+            index: job.index,
+            report: (0, index_1.lintFile)(job.filePath, batch.config),
+        }));
+        port.postMessage(done);
+    });
+}
+//# sourceMappingURL=worker.js.map

package/lib/lint/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/lint/worker.ts"],"names":[],"mappings":";;AAAA,mDAA2C;AAE3C,mCAAkC;AAOlC,IAAI,2BAAU,EAAE,CAAC;IACf,MAAM,IAAI,GAAG,2BAAU,CAAA;IACvB,6EAA6E;IAC7E,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACzB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAY,EAAE,EAAE;QAClC,MAAM,IAAI,GAAmB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClD,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,IAAA,gBAAQ,EAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;SAC7C,CAAC,CAAC,CAAA;QACH,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/query.js

@@ -57,7 +57,10 @@ const renderViaRoot = (block, serializer) => {
 };
 const formatBlocks = (format, matches) => {
     if (format === 'json') {
-        return JSON.stringify(matches.map(m => m.block), null, 2);
+        // without the source, a query over several files answers "here are the
+        // blocks" and drops "from where", which leaves the caller no way back to
+        // the document
+        return JSON.stringify(matches.map(m => ({ file: m.source.file, ...m.block })), null, 2);
     }
     if (format === 'podlite') {
         return matches

package/lib/query.js.map

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

package/lib/resolve-includes.js

@@ -38,6 +38,45 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const schema_1 = require("@podlite/schema");
 const isIncludeBlock = (node) => node && typeof node === 'object' && node.type === 'block' && node.name === 'include';
+const hasMask = (target) => /[*?]/.test(target);
+const reachesSubdirs = (target) => target.includes('**');
+// A mask that crosses directories could otherwise walk a whole disk from a
+// short prefix.
+const maxDepth = 32;
+// Everything up to the last separator that carries no mask; the rest is matched
+// by the selector itself, which already knows the pattern language.
+const fixedPrefix = (target) => {
+    const parts = target.split('/');
+    const upto = parts.findIndex(hasMask);
+    return parts.slice(0, upto === -1 ? parts.length : upto).join('/');
+};
+const listDir = (dir, deep, depth = 0) => {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const named = entries.filter(e => !e.name.startsWith('.')).sort((a, b) => (a.name < b.name ? -1 : 1));
+    const files = named.filter(e => e.isFile()).map(e => e.name);
+    if (!deep || depth >= maxDepth)
+        return files;
+    const nested = named
+        .filter(e => e.isDirectory())
+        .flatMap(e => listDir(path.join(dir, e.name), deep, depth + 1).map(inner => `${e.name}/${inner}`));
+    return [...files, ...nested];
+};
+// Candidate paths for a masked target, written the way the target is written so
+// the selector matches them back. Matching runs before the file is read: the
+// directory may hold anything, and a mask that does not name it must not send
+// it through the parser.
+const expandMask = (target, baseDir) => {
+    const prefix = fixedPrefix(target);
+    return listDir(path.resolve(baseDir, prefix), reachesSubdirs(target))
+        .map(name => (prefix ? `${prefix}/${name}` : name))
+        .filter(file => (0, schema_1.filePathMatches)(file, target));
+};
 const keepBlocks = (items) => items.filter(item => item && typeof item === 'object' && !('file' in item));
 const unwrapRoot = (blocks) => blocks.flatMap((b) => b && b.type === 'block' && b.name === 'root' && Array.isArray(b.content) ? b.content : [b]);
 const resolveIncludes = (tree, opts) => {
@@ -50,14 +89,24 @@ const resolveIncludes = (tree, opts) => {
             const parsed = selector ? (0, schema_1.parseSelector)(selector) : undefined;
             if (!selector || !parsed || parsed.scheme !== 'file' || !parsed.document)
                 return node;
-            const target = path.resolve(baseDir, parsed.document);
-            if (stack.includes(target))
-                return [];
-            if (!fs.existsSync(target)) {
+            const masked = hasMask(parsed.document);
+            const written = masked ? expandMask(parsed.document, baseDir) : [parsed.document];
+            if (!masked && !fs.existsSync(path.resolve(baseDir, parsed.document))) {
                 throw new Error(`include target not found: ${parsed.document}`);
             }
-            const subTree = walkNode(opts.parse(fs.readFileSync(target, 'utf-8')), path.dirname(target), [...stack, target]);
-            return unwrapRoot(keepBlocks((0, schema_1.runSelector)(selector, [{ file: parsed.document, node: subTree }])));
+            const docs = [];
+            for (const file of written) {
+                const target = path.resolve(baseDir, file);
+                if (stack.includes(target))
+                    continue;
+                docs.push({
+                    file,
+                    node: walkNode(opts.parse(fs.readFileSync(target, 'utf-8')), path.dirname(target), [...stack, target]),
+                });
+            }
+            if (docs.length === 0)
+                return [];
+            return unwrapRoot(keepBlocks((0, schema_1.runSelector)(selector, docs)));
         }
         if (Array.isArray(node.content))
             return { ...node, content: walkList(node.content, baseDir, stack) };