@podlite/schema 0.0.38 → 0.0.39

package/esm/selectors.d.ts

@@ -0,0 +1,18 @@
+import { PodliteDocument, PodNode } from './index';
+/**
+ * Minimal corpus item that the selector engine needs. Concrete consumers
+ * (publisher's `publishRecord`, editor preview, etc.) supply richer
+ * objects; only `file` and `node` are read here.
+ */
+export declare type SelectorDoc = {
+    file: string;
+    node: PodNode | PodliteDocument;
+};
+export declare type ParsedSelector = {
+    scheme?: string;
+    document?: string;
+    anchor?: string;
+    blockFilters: string[];
+};
+export declare const parseSelector: (selector: string) => ParsedSelector | undefined;
+export declare const runSelector: <T extends SelectorDoc>(selector: string, docs: T[]) => PodNode[] | T[];

package/esm/selectors.js

@@ -0,0 +1,158 @@
+import { getFromTree, getNodeId, getTextContentFromNode, makeAttrs } from './index';
+export const parseSelector = (selector) => {
+    const trimmed = selector.trim();
+    if (!trimmed)
+        return undefined;
+    // Split on the first '|' — left is source, right is blocks selector
+    const pipeIdx = trimmed.indexOf('|');
+    const sourcePart = (pipeIdx === -1 ? trimmed : trimmed.slice(0, pipeIdx)).trim();
+    const filterPart = pipeIdx === -1 ? '' : trimmed.slice(pipeIdx + 1).trim();
+    const blockFilters = filterPart
+        ? filterPart
+            .split(',')
+            .map(s => s.trim())
+            .filter(Boolean)
+        : [];
+    // Source: scheme:path or scheme:path#anchor
+    const sourceMatch = sourcePart.match(/^([^:]+):([^#]+)(?:#(.+))?$/);
+    if (sourceMatch) {
+        return {
+            scheme: sourceMatch[1],
+            document: sourceMatch[2].trim(),
+            anchor: sourceMatch[3],
+            blockFilters,
+        };
+    }
+    if (blockFilters.length > 0) {
+        return { blockFilters };
+    }
+    return undefined;
+};
+// Normalize a path for loose suffix comparison:
+//   'src/foo.podlite'      ~= 'foo.podlite'
+//   './includes/x.podlite' ~= 'includes/x.podlite'
+const normalizePath = (p) => p.replace(/\\/g, '/').replace(/^\.\//, '');
+const isGlobPattern = (s) => /[*?[]/.test(s);
+// Convert a glob pattern to an anchored RegExp.
+//   **/   →  (?:.*/)?   zero or more directory segments (lets **/foo match root-level foo)
+//   **    →  .*         any characters, crosses /
+//   *     →  [^/]*      any characters within a single segment
+//   ?     →  [^/]       single character within a segment
+// Other regex meta characters are escaped.
+const globRegexCache = new Map();
+const globToRegex = (glob) => {
+    const cached = globRegexCache.get(glob);
+    if (cached)
+        return cached;
+    let re = '';
+    let i = 0;
+    while (i < glob.length) {
+        const c = glob[i];
+        const next = glob[i + 1];
+        if (c === '*' && next === '*' && glob[i + 2] === '/') {
+            re += '(?:.*/)?';
+            i += 3;
+        }
+        else if (c === '*' && next === '*') {
+            re += '.*';
+            i += 2;
+        }
+        else if (c === '*') {
+            re += '[^/]*';
+            i += 1;
+        }
+        else if (c === '?') {
+            re += '[^/]';
+            i += 1;
+        }
+        else if (/[\\^$.()+|{}[\]]/.test(c)) {
+            re += '\\' + c;
+            i += 1;
+        }
+        else {
+            re += c;
+            i += 1;
+        }
+    }
+    const compiled = new RegExp(`^${re}$`);
+    globRegexCache.set(glob, compiled);
+    return compiled;
+};
+const filePathMatches = (docFile, target) => {
+    const a = normalizePath(docFile);
+    const b = normalizePath(target);
+    if (isGlobPattern(b)) {
+        const rx = globToRegex(b);
+        if (rx.test(a))
+            return true;
+        // Suffix-tolerant match: allow any parent prefix (consistent with
+        // non-glob suffix matching, so 'src/00-foo/x.pod' matches '00-foo/x.pod').
+        const body = rx.source.slice(1, -1);
+        const rxSuffix = new RegExp(`^(?:.*/)${body}$`);
+        return rxSuffix.test(a);
+    }
+    return a === b || a.endsWith('/' + b) || b.endsWith('/' + a);
+};
+const getDocIDs = (doc) => {
+    const ids = [];
+    getFromTree(doc.node, 'NAME', 'TITLE').forEach(block => {
+        const conf = makeAttrs(block, {});
+        const title = getTextContentFromNode(block).trim();
+        if (conf.exists('id')) {
+            const id = conf.getFirstValue('id');
+            if (id)
+                ids.push(id);
+        }
+        ids.push(title);
+    });
+    return ids;
+};
+function getMapIDsBlocks(srcNode) {
+    const idsMap = new Map();
+    getFromTree(srcNode, { type: 'block' }).forEach(i => {
+        const id = getNodeId(i, {});
+        if (id)
+            idsMap.set(id, i);
+    });
+    return idsMap;
+}
+export const runSelector = (selector, docs) => {
+    const parsed = parseSelector(selector);
+    if (!parsed)
+        return [];
+    const { scheme, document, anchor, blockFilters } = parsed;
+    let matchedDocs = docs;
+    if (scheme === 'doc' && document) {
+        matchedDocs = docs.filter(doc => getDocIDs(doc).includes(document));
+    }
+    else if (scheme === 'file' && document) {
+        matchedDocs = docs.filter(doc => filePathMatches(doc.file, document));
+    }
+    else if (scheme && scheme !== 'doc' && scheme !== 'file') {
+        return [];
+    }
+    // Anchor takes precedence — single-block-by-id lookup
+    if (anchor) {
+        const collectedBlocks = [];
+        for (const d of matchedDocs) {
+            const idsMap = getMapIDsBlocks(d.node);
+            const block = idsMap.get(anchor);
+            if (block)
+                collectedBlocks.push(block);
+        }
+        return collectedBlocks;
+    }
+    // Block filters — extract blocks by name across matched docs
+    if (blockFilters.length > 0) {
+        const collectedBlocks = [];
+        for (const d of matchedDocs) {
+            for (const name of blockFilters) {
+                collectedBlocks.push(...getFromTree(d.node, name));
+            }
+        }
+        return collectedBlocks;
+    }
+    // No anchor, no filter — return whole docs
+    return matchedDocs.map(d => d.node);
+};
+//# sourceMappingURL=selectors.js.map

package/esm/selectors.js.map

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

package/lib/index.d.ts

@@ -78,5 +78,7 @@ export { parse as parse };
 export { default as toHtml } from './exportHtml';
 export { default as toMarkdown } from './exportMarkdown';
 export { default as Writer } from './writer';
+export { parseSelector, runSelector } from './selectors';
+export type { SelectorDoc, ParsedSelector } from './selectors';
 declare const VERSION: any;
 export { VERSION as version };

package/lib/index.js

@@ -25,7 +25,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.version = exports.Writer = exports.toMarkdown = exports.toHtml = exports.parse = exports.toTree = exports.isValidateError = exports.validateAst = exports.validateAstTree = exports.validatePodliteAst = exports.getPodContentFromNode = exports.getTextContentFromNode = exports.toAst = exports.frozenIds = exports.cleanIds = exports.podlitePluggable = exports.toAnyRules = exports.pluginCleanLocation = exports.makeAttrs = exports.toAny = exports.isSemanticBlock = exports.isNamedBlock = exports.makeTransformer = exports.makeInterator = void 0;
+exports.version = exports.runSelector = exports.parseSelector = exports.Writer = exports.toMarkdown = exports.toHtml = exports.parse = exports.toTree = exports.isValidateError = exports.validateAst = exports.validateAstTree = exports.validatePodliteAst = exports.getPodContentFromNode = exports.getTextContentFromNode = exports.toAst = exports.frozenIds = exports.cleanIds = exports.podlitePluggable = exports.toAnyRules = exports.pluginCleanLocation = exports.makeAttrs = exports.toAny = exports.isSemanticBlock = exports.isNamedBlock = exports.makeTransformer = exports.makeInterator = void 0;
 const ajv_1 = __importDefault(require("ajv"));
 const pointer = __importStar(require("json-pointer"));
 const jsonShemes = __importStar(require("../schema"));
@@ -189,6 +189,9 @@ var exportMarkdown_1 = require("./exportMarkdown");
 Object.defineProperty(exports, "toMarkdown", { enumerable: true, get: function () { return __importDefault(exportMarkdown_1).default; } });
 var writer_1 = require("./writer");
 Object.defineProperty(exports, "Writer", { enumerable: true, get: function () { return __importDefault(writer_1).default; } });
+var selectors_1 = require("./selectors");
+Object.defineProperty(exports, "parseSelector", { enumerable: true, get: function () { return selectors_1.parseSelector; } });
+Object.defineProperty(exports, "runSelector", { enumerable: true, get: function () { return selectors_1.runSelector; } });
 // Cannot be `import` as it's not under TS root dir
 // https://stackoverflow.com/questions/51070138/how-to-import-package-json-into-typescript-file-without-including-it-in-the-comp
 const { version: VERSION } = require('../package.json');