@documentdb-js/operator-registry 0.8.0

package/dist/metaTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaTags.d.ts","sourceRoot":"","sources":["../src/metaTags.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AAGH,eAAO,MAAM,UAAU,EAAG,OAAgB,CAAC;AAC3C,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AACjE,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAC3D,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AACjE,eAAO,MAAM,gBAAgB,EAAG,aAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAC3D,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AACjE,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AACjE,eAAO,MAAM,eAAe,EAAG,YAAqB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAG,QAAiB,CAAC;AAC7C,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AACzD,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AACzD,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAG7D,eAAO,MAAM,UAAU,EAAG,OAAgB,CAAC;AAC3C,eAAO,MAAM,gBAAgB,EAAG,aAAsB,CAAC;AAGvD,eAAO,MAAM,eAAe,EAAG,YAAqB,CAAC;AACrD,eAAO,MAAM,eAAe,EAAG,YAAqB,CAAC;AACrD,eAAO,MAAM,cAAc,EAAG,WAAoB,CAAC;AACnD,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AACjE,eAAO,MAAM,cAAc,EAAG,WAAoB,CAAC;AACnD,eAAO,MAAM,gBAAgB,EAAG,aAAsB,CAAC;AACvD,eAAO,MAAM,aAAa,EAAG,UAAmB,CAAC;AACjD,eAAO,MAAM,gBAAgB,EAAG,aAAsB,CAAC;AACvD,eAAO,MAAM,cAAc,EAAG,WAAoB,CAAC;AACnD,eAAO,MAAM,cAAc,EAAG,WAAoB,CAAC;AACnD,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAC3D,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAC7D,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AACzD,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AACzD,eAAO,MAAM,cAAc,EAAG,WAAoB,CAAC;AACnD,eAAO,MAAM,kBAAkB,EAAG,eAAwB,CAAC;AAG3D,eAAO,MAAM,WAAW,EAAG,QAAiB,CAAC;AAG7C,eAAO,MAAM,SAAS,EAAG,MAAe,CAAC;AAGzC,eAAO,MAAM,aAAa,EAAG,UAAmB,CAAC;AAGjD,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,aAAa,4jBAsChB,CAAC;AAIX,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAkC,CAAC;AAEvF,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAqD,CAAC;AAE9G,wEAAwE;AACxE,eAAO,MAAM,gCAAgC,EAAE,SAAS,MAAM,EAAgD,CAAC;AAE/G,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAiC,CAAC;AAE1F,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAe,CAAC;AAEpE,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAc,CAAC;AAElE,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA0D,CAAC"}

package/dist/metaTags.js

@@ -0,0 +1,116 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WINDOW_COMPLETION_META = exports.STAGE_COMPLETION_META = exports.UPDATE_COMPLETION_META = exports.EXPRESSION_COMPLETION_META = exports.GROUP_EXPRESSION_COMPLETION_META = exports.PROJECTION_COMPLETION_META = exports.FILTER_COMPLETION_META = exports.ALL_META_TAGS = exports.META_FIELD_IDENTIFIER = exports.META_VARIABLE = exports.META_BSON = exports.META_WINDOW = exports.META_EXPR_VARIABLE = exports.META_EXPR_MISC = exports.META_EXPR_LITERAL = exports.META_EXPR_BITWISE = exports.META_EXPR_TIMESTAMP = exports.META_EXPR_DATASIZE = exports.META_EXPR_TYPE = exports.META_EXPR_TRIG = exports.META_EXPR_STRING = exports.META_EXPR_SET = exports.META_EXPR_OBJECT = exports.META_EXPR_DATE = exports.META_EXPR_CONDITIONAL = exports.META_EXPR_COMPARISON = exports.META_EXPR_BOOL = exports.META_EXPR_ARRAY = exports.META_EXPR_ARITH = exports.META_ACCUMULATOR = exports.META_STAGE = exports.META_UPDATE_BITWISE = exports.META_UPDATE_ARRAY = exports.META_UPDATE_FIELD = exports.META_UPDATE = exports.META_QUERY_MISC = exports.META_QUERY_PROJECTION = exports.META_QUERY_GEOSPATIAL = exports.META_QUERY_BITWISE = exports.META_QUERY_ARRAY = exports.META_QUERY_EVALUATION = exports.META_QUERY_ELEMENT = exports.META_QUERY_LOGICAL = exports.META_QUERY_COMPARISON = exports.META_QUERY = void 0;
+/**
+ * Meta tag constants for categorizing operators in the DocumentDB constants package.
+ *
+ * Tags use a hierarchical scheme where prefix matching is supported:
+ * filtering by 'query' matches 'query', 'query:comparison', 'query:logical', etc.
+ */
+// -- Query operators --
+exports.META_QUERY = 'query';
+exports.META_QUERY_COMPARISON = 'query:comparison';
+exports.META_QUERY_LOGICAL = 'query:logical';
+exports.META_QUERY_ELEMENT = 'query:element';
+exports.META_QUERY_EVALUATION = 'query:evaluation';
+exports.META_QUERY_ARRAY = 'query:array';
+exports.META_QUERY_BITWISE = 'query:bitwise';
+exports.META_QUERY_GEOSPATIAL = 'query:geospatial';
+exports.META_QUERY_PROJECTION = 'query:projection';
+exports.META_QUERY_MISC = 'query:misc';
+// -- Update operators --
+exports.META_UPDATE = 'update';
+exports.META_UPDATE_FIELD = 'update:field';
+exports.META_UPDATE_ARRAY = 'update:array';
+exports.META_UPDATE_BITWISE = 'update:bitwise';
+// -- Aggregation pipeline --
+exports.META_STAGE = 'stage';
+exports.META_ACCUMULATOR = 'accumulator';
+// -- Expression operators --
+exports.META_EXPR_ARITH = 'expr:arith';
+exports.META_EXPR_ARRAY = 'expr:array';
+exports.META_EXPR_BOOL = 'expr:bool';
+exports.META_EXPR_COMPARISON = 'expr:comparison';
+exports.META_EXPR_CONDITIONAL = 'expr:conditional';
+exports.META_EXPR_DATE = 'expr:date';
+exports.META_EXPR_OBJECT = 'expr:object';
+exports.META_EXPR_SET = 'expr:set';
+exports.META_EXPR_STRING = 'expr:string';
+exports.META_EXPR_TRIG = 'expr:trig';
+exports.META_EXPR_TYPE = 'expr:type';
+exports.META_EXPR_DATASIZE = 'expr:datasize';
+exports.META_EXPR_TIMESTAMP = 'expr:timestamp';
+exports.META_EXPR_BITWISE = 'expr:bitwise';
+exports.META_EXPR_LITERAL = 'expr:literal';
+exports.META_EXPR_MISC = 'expr:misc';
+exports.META_EXPR_VARIABLE = 'expr:variable';
+// -- Window operators --
+exports.META_WINDOW = 'window';
+// -- BSON constructors --
+exports.META_BSON = 'bson';
+// -- System variables --
+exports.META_VARIABLE = 'variable';
+// -- Schema-injected field names (not static — provided at runtime) --
+exports.META_FIELD_IDENTIFIER = 'field:identifier';
+/**
+ * All known meta tag values for validation purposes.
+ */
+exports.ALL_META_TAGS = [
+    exports.META_QUERY,
+    exports.META_QUERY_COMPARISON,
+    exports.META_QUERY_LOGICAL,
+    exports.META_QUERY_ELEMENT,
+    exports.META_QUERY_EVALUATION,
+    exports.META_QUERY_ARRAY,
+    exports.META_QUERY_BITWISE,
+    exports.META_QUERY_GEOSPATIAL,
+    exports.META_QUERY_PROJECTION,
+    exports.META_QUERY_MISC,
+    exports.META_UPDATE,
+    exports.META_UPDATE_FIELD,
+    exports.META_UPDATE_ARRAY,
+    exports.META_UPDATE_BITWISE,
+    exports.META_STAGE,
+    exports.META_ACCUMULATOR,
+    exports.META_EXPR_ARITH,
+    exports.META_EXPR_ARRAY,
+    exports.META_EXPR_BOOL,
+    exports.META_EXPR_COMPARISON,
+    exports.META_EXPR_CONDITIONAL,
+    exports.META_EXPR_DATE,
+    exports.META_EXPR_OBJECT,
+    exports.META_EXPR_SET,
+    exports.META_EXPR_STRING,
+    exports.META_EXPR_TRIG,
+    exports.META_EXPR_TYPE,
+    exports.META_EXPR_DATASIZE,
+    exports.META_EXPR_TIMESTAMP,
+    exports.META_EXPR_BITWISE,
+    exports.META_EXPR_LITERAL,
+    exports.META_EXPR_MISC,
+    exports.META_EXPR_VARIABLE,
+    exports.META_WINDOW,
+    exports.META_BSON,
+    exports.META_VARIABLE,
+    exports.META_FIELD_IDENTIFIER,
+];
+// -- Completion context presets --
+/** Query filter contexts: find filter bar, $match stage body */
+exports.FILTER_COMPLETION_META = ['query', 'bson', 'variable'];
+/** Projection/sort contexts: field names + projection operators */
+exports.PROJECTION_COMPLETION_META = ['field:identifier', 'query:projection', 'bson'];
+/** $group/$project/$addFields stage body: expressions + accumulators */
+exports.GROUP_EXPRESSION_COMPLETION_META = ['expr', 'accumulator', 'bson', 'variable'];
+/** Other stage bodies: expressions only (no accumulators) */
+exports.EXPRESSION_COMPLETION_META = ['expr', 'bson', 'variable'];
+/** Update operations: update operators */
+exports.UPDATE_COMPLETION_META = ['update'];
+/** Top-level aggregation pipeline: stage names */
+exports.STAGE_COMPLETION_META = ['stage'];
+/** Window fields: window operators + accumulators + expressions */
+exports.WINDOW_COMPLETION_META = ['window', 'accumulator', 'expr', 'bson', 'variable'];
+//# sourceMappingURL=metaTags.js.map

package/dist/metaTags.js.map

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

package/dist/operatorReference.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operatorReference.test.d.ts.map

package/dist/operatorReference.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorReference.test.d.ts","sourceRoot":"","sources":["../src/operatorReference.test.ts"],"names":[],"mappings":""}

package/dist/operatorReference.test.js

@@ -0,0 +1,209 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Dump-vs-implementation verification test.
+ *
+ * Ensures the TypeScript operator implementation always matches the
+ * resource dump (scraped/operator-reference.md). This test is the
+ * enforcing contract between "what does DocumentDB support?" (the dump)
+ * and "what does our code provide?" (the implementation).
+ *
+ * See §2.3.3 of docs/plan/03-operator-registry.md for design rationale.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const index_1 = require("./index");
+const parseOperatorReference_1 = require("./parseOperatorReference");
+const dumpPath = path.join(__dirname, '..', 'resources', 'scraped', 'operator-reference.md');
+const dumpContent = fs.readFileSync(dumpPath, 'utf-8');
+const parsed = (0, parseOperatorReference_1.parseOperatorReference)(dumpContent);
+const referenceOperators = parsed.operators;
+const notListedOperators = parsed.notListed;
+const implementedOperators = (0, index_1.getAllCompletions)();
+/**
+ * Category-to-meta mapping. Maps dump category names to the meta tags
+ * used in the implementation. Some dump categories map to the same meta
+ * tag (e.g., both accumulator categories map to 'accumulator').
+ */
+const CATEGORY_TO_META = {
+    'Comparison Query Operators': 'query:comparison',
+    'Logical Query Operators': 'query:logical',
+    'Element Query Operators': 'query:element',
+    'Evaluation Query Operators': 'query:evaluation',
+    'Geospatial Operators': 'query:geospatial',
+    'Array Query Operators': 'query:array',
+    'Bitwise Query Operators': 'query:bitwise',
+    'Projection Operators': 'query:projection',
+    'Miscellaneous Query Operators': 'query:misc',
+    'Field Update Operators': 'update:field',
+    'Array Update Operators': 'update:array',
+    'Bitwise Update Operators': 'update:bitwise',
+    'Arithmetic Expression Operators': 'expr:arith',
+    'Array Expression Operators': 'expr:array',
+    'Bitwise Operators': 'expr:bitwise',
+    'Boolean Expression Operators': 'expr:bool',
+    'Comparison Expression Operators': 'expr:comparison',
+    'Data Size Operators': 'expr:datasize',
+    'Date Expression Operators': 'expr:date',
+    'Literal Expression Operator': 'expr:literal',
+    'Miscellaneous Operators': 'expr:misc',
+    'Object Expression Operators': 'expr:object',
+    'Set Expression Operators': 'expr:set',
+    'String Expression Operators': 'expr:string',
+    'Timestamp Expression Operators': 'expr:timestamp',
+    'Trigonometry Expression Operators': 'expr:trig',
+    'Type Expression Operators': 'expr:type',
+    'Accumulators ($group, $bucket, $bucketAuto, $setWindowFields)': 'accumulator',
+    'Accumulators (in Other Stages)': 'accumulator',
+    'Variable Expression Operators': 'expr:variable',
+    'Window Operators': 'window',
+    'Conditional Expression Operators': 'expr:conditional',
+    'Aggregation Pipeline Stages': 'stage',
+    'Variables in Aggregation Expressions': 'variable',
+};
+describe('operator reference verification', () => {
+    test('dump file exists and is parseable', () => {
+        expect(dumpContent.length).toBeGreaterThan(1000);
+        expect(referenceOperators.length).toBeGreaterThan(250);
+    });
+    test('every listed operator in the dump has an implementation entry', () => {
+        const implementedValues = new Set(implementedOperators.map((op) => op.value));
+        const missing = [];
+        for (const ref of referenceOperators) {
+            // Some operators appear in multiple dump categories (e.g., $objectToArray
+            // in both "Array Expression" and "Object Expression"). The implementation
+            // only needs one entry per (value, meta) pair — check by value.
+            if (!implementedValues.has(ref.operator)) {
+                missing.push(`${ref.operator} (${ref.category})`);
+            }
+        }
+        expect(missing).toEqual([]);
+    });
+    test('no extra operators in implementation beyond the dump (excluding BSON/variables)', () => {
+        // Build a set of all operator values from the dump
+        const dumpValues = new Set(referenceOperators.map((r) => r.operator));
+        // Filter implementation entries: exclude BSON constructors and system variables
+        // (these are hand-authored, not from the compatibility page dump)
+        const extras = implementedOperators.filter((op) => !op.meta.startsWith('bson') && !op.meta.startsWith('variable') && !dumpValues.has(op.value));
+        expect(extras.map((e) => `${e.value} (${e.meta})`)).toEqual([]);
+    });
+    test('not-listed operators are NOT in the implementation', () => {
+        const leaked = [];
+        for (const nl of notListedOperators) {
+            // Check the exact meta category from the dump
+            const expectedMeta = CATEGORY_TO_META[nl.category];
+            if (!expectedMeta) {
+                continue;
+            }
+            const found = implementedOperators.find((op) => op.value === nl.operator && op.meta === expectedMeta);
+            if (found) {
+                leaked.push(`${nl.operator} (${nl.category}) — ${nl.reason}`);
+            }
+        }
+        expect(leaked).toEqual([]);
+    });
+    test('all dump categories have a known meta mapping', () => {
+        const categories = new Set(referenceOperators.map((r) => r.category));
+        const unmapped = [...categories].filter((c) => !CATEGORY_TO_META[c]);
+        expect(unmapped).toEqual([]);
+    });
+    test('reference parser found the expected number of not-listed operators', () => {
+        // The plan lists 16 not-listed operators (§2.1)
+        expect(notListedOperators.length).toBeGreaterThanOrEqual(14);
+        expect(notListedOperators.length).toBeLessThanOrEqual(20);
+    });
+});
+// ---------------------------------------------------------------------------
+// Override verification
+//
+// The generator (scripts/generate-from-reference.ts) merges the scraped dump
+// with manual overrides. These tests verify overrides are correctly applied —
+// catching scenarios where:
+//   - Someone adds an override but forgets to run `npm run generate`
+//   - The override file is accidentally truncated
+//   - An override targets a non-existent operator
+// ---------------------------------------------------------------------------
+const overridesPath = path.join(__dirname, '..', 'resources', 'overrides', 'operator-overrides.md');
+const overridesContent = fs.readFileSync(overridesPath, 'utf-8');
+const parsedOverrides = (0, parseOperatorReference_1.parseOperatorReference)(overridesContent);
+const overrideOperators = parsedOverrides.operators;
+describe('override verification', () => {
+    test('overrides file exists and has entries', () => {
+        expect(overridesContent.length).toBeGreaterThan(100);
+        expect(overrideOperators.length).toBeGreaterThan(0);
+    });
+    test('override count is within expected range (detect truncation)', () => {
+        // Currently 56 overrides. Allow some flex for additions/removals,
+        // but catch catastrophic truncation (e.g., file emptied to <10).
+        expect(overrideOperators.length).toBeGreaterThanOrEqual(40);
+        expect(overrideOperators.length).toBeLessThanOrEqual(80);
+    });
+    test('every override targets an operator that exists in the dump', () => {
+        const dumpKeys = new Set(referenceOperators.map((r) => `${r.operator}|${r.category}`));
+        const orphans = [];
+        for (const ov of overrideOperators) {
+            if (!dumpKeys.has(`${ov.operator}|${ov.category}`)) {
+                orphans.push(`${ov.operator} (${ov.category})`);
+            }
+        }
+        expect(orphans).toEqual([]);
+    });
+    test('every override with a description was applied (not silently ignored)', () => {
+        const unapplied = [];
+        for (const ov of overrideOperators) {
+            if (!ov.description) {
+                continue;
+            }
+            const expectedMeta = CATEGORY_TO_META[ov.category];
+            if (!expectedMeta) {
+                continue;
+            }
+            const impl = implementedOperators.find((op) => op.value === ov.operator && op.meta === expectedMeta);
+            if (!impl) {
+                unapplied.push(`${ov.operator} (${ov.category}): no implementation entry found`);
+            }
+            else if (impl.description !== ov.description) {
+                unapplied.push(`${ov.operator} (${ov.category}): override="${ov.description}", ` + `impl="${impl.description}"`);
+            }
+        }
+        expect(unapplied).toEqual([]);
+    });
+});
+//# sourceMappingURL=operatorReference.test.js.map

package/dist/operatorReference.test.js.map

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

package/dist/parseOperatorReference.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Parses the scraped/operator-reference.md dump file into structured data
+ * for use in the operatorReference verification test.
+ *
+ * The dump format uses structured headings:
+ *   ## Category Name           — category section
+ *   ### $operatorName          — operator heading
+ *   - **Description:** text    — operator description
+ *   - **Doc Link:** url        — documentation URL
+ *
+ *   ## Not Listed              — excluded operators section
+ *   - **$operator** (Category) — Reason
+ */
+/**
+ * Represents a single operator entry parsed from the reference dump.
+ */
+export interface ReferenceOperator {
+    /** Operator name, e.g. "$eq", "$$NOW" */
+    readonly operator: string;
+    /** Category from the dump, e.g. "Comparison Query Operators" */
+    readonly category: string;
+    /** Description from the dump (may be empty) */
+    readonly description: string;
+    /** Documentation URL from the dump (may be empty) */
+    readonly docLink: string;
+}
+/**
+ * Represents an operator excluded from the package scope.
+ */
+export interface NotListedOperator {
+    /** Operator name, e.g. "$where", "$meta" */
+    readonly operator: string;
+    /** Category from the dump */
+    readonly category: string;
+    /** Reason for exclusion */
+    readonly reason: string;
+}
+/**
+ * Complete parsed result from the reference dump.
+ */
+export interface ParsedReference {
+    /** All listed (in-scope) operators */
+    readonly operators: readonly ReferenceOperator[];
+    /** All not-listed (excluded) operators */
+    readonly notListed: readonly NotListedOperator[];
+}
+/**
+ * Parses the scraped/operator-reference.md content into structured data.
+ *
+ * @param content - the full Markdown content of the dump file
+ * @returns parsed reference data
+ */
+export declare function parseOperatorReference(content: string): ParsedReference;
+//# sourceMappingURL=parseOperatorReference.d.ts.map

package/dist/parseOperatorReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOperatorReference.d.ts","sourceRoot":"","sources":["../src/parseOperatorReference.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAkGvE"}

package/dist/parseOperatorReference.js

@@ -0,0 +1,103 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOperatorReference = parseOperatorReference;
+/**
+ * Parses the scraped/operator-reference.md content into structured data.
+ *
+ * @param content - the full Markdown content of the dump file
+ * @returns parsed reference data
+ */
+function parseOperatorReference(content) {
+    const lines = content.split('\n');
+    const operators = [];
+    const notListed = [];
+    let currentCategory = '';
+    let inNotListed = false;
+    let inSummary = false;
+    // Temp state for building current operator
+    let currentOperator = '';
+    let currentDescription = '';
+    let currentDocLink = '';
+    function flushOperator() {
+        if (currentOperator && currentCategory && !inNotListed && !inSummary) {
+            operators.push({
+                operator: currentOperator,
+                category: currentCategory,
+                description: currentDescription,
+                docLink: currentDocLink,
+            });
+        }
+        currentOperator = '';
+        currentDescription = '';
+        currentDocLink = '';
+    }
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect ## headings (category sections)
+        const h2Match = trimmed.match(/^## (.+)$/);
+        if (h2Match) {
+            flushOperator();
+            const heading = h2Match[1].trim();
+            if (heading === 'Summary') {
+                inSummary = true;
+                inNotListed = false;
+                currentCategory = '';
+            }
+            else if (heading === 'Not Listed') {
+                inNotListed = true;
+                inSummary = false;
+                currentCategory = '';
+            }
+            else {
+                currentCategory = heading;
+                inNotListed = false;
+                inSummary = false;
+            }
+            continue;
+        }
+        // Skip summary section
+        if (inSummary) {
+            continue;
+        }
+        // Parse "Not Listed" entries: - **$operator** (Category) — Reason
+        if (inNotListed) {
+            const notListedMatch = trimmed.match(/^- \*\*(.+?)\*\* \((.+?)\) — (.+)$/);
+            if (notListedMatch) {
+                notListed.push({
+                    operator: notListedMatch[1],
+                    category: notListedMatch[2],
+                    reason: notListedMatch[3],
+                });
+            }
+            continue;
+        }
+        // Detect ### headings (operator entries)
+        const h3Match = trimmed.match(/^### (.+)$/);
+        if (h3Match) {
+            flushOperator();
+            currentOperator = h3Match[1].trim();
+            continue;
+        }
+        // Parse description: - **Description:** text
+        const descMatch = trimmed.match(/^- \*\*Description:\*\* (.+)$/);
+        if (descMatch && currentOperator) {
+            currentDescription = descMatch[1].trim();
+            continue;
+        }
+        // Parse doc link: - **Doc Link:** url  ('none' means no page at expected location)
+        const linkMatch = trimmed.match(/^- \*\*Doc Link:\*\* (.+)$/);
+        if (linkMatch && currentOperator) {
+            const rawLink = linkMatch[1].trim();
+            currentDocLink = rawLink === 'none' ? '' : rawLink;
+            continue;
+        }
+    }
+    // Flush last operator
+    flushOperator();
+    return { operators, notListed };
+}
+//# sourceMappingURL=parseOperatorReference.js.map

package/dist/parseOperatorReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOperatorReference.js","sourceRoot":"","sources":["../src/parseOperatorReference.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;AA0DhG,wDAkGC;AAxGD;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAwB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAwB,EAAE,CAAC;IAE1C,IAAI,eAAe,GAAG,EAAE,CAAC;IACzB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,2CAA2C;IAC3C,IAAI,eAAe,GAAG,EAAE,CAAC;IACzB,IAAI,kBAAkB,GAAG,EAAE,CAAC;IAC5B,IAAI,cAAc,GAAG,EAAE,CAAC;IAExB,SAAS,aAAa;QAClB,IAAI,eAAe,IAAI,eAAe,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;YACnE,SAAS,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,eAAe;gBACzB,QAAQ,EAAE,eAAe;gBACzB,WAAW,EAAE,kBAAkB;gBAC/B,OAAO,EAAE,cAAc;aAC1B,CAAC,CAAC;QACP,CAAC;QACD,eAAe,GAAG,EAAE,CAAC;QACrB,kBAAkB,GAAG,EAAE,CAAC;QACxB,cAAc,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,yCAAyC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;gBACjB,WAAW,GAAG,KAAK,CAAC;gBACpB,eAAe,GAAG,EAAE,CAAC;YACzB,CAAC;iBAAM,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;gBAClC,WAAW,GAAG,IAAI,CAAC;gBACnB,SAAS,GAAG,KAAK,CAAC;gBAClB,eAAe,GAAG,EAAE,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACJ,eAAe,GAAG,OAAO,CAAC;gBAC1B,WAAW,GAAG,KAAK,CAAC;gBACpB,SAAS,GAAG,KAAK,CAAC;YACtB,CAAC;YACD,SAAS;QACb,CAAC;QAED,uBAAuB;QACvB,IAAI,SAAS,EAAE,CAAC;YACZ,SAAS;QACb,CAAC;QAED,kEAAkE;QAClE,IAAI,WAAW,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC3E,IAAI,cAAc,EAAE,CAAC;gBACjB,SAAS,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;oBAC3B,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;oBAC3B,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;iBAC5B,CAAC,CAAC;YACP,CAAC;YACD,SAAS;QACb,CAAC;QAED,yCAAyC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,CAAC;YAChB,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,SAAS;QACb,CAAC;QAED,6CAA6C;QAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACjE,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;YAC/B,kBAAkB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,SAAS;QACb,CAAC;QAED,mFAAmF;QACnF,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC9D,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,cAAc,GAAG,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACnD,SAAS;QACb,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,aAAa,EAAE,CAAC;IAEhB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC"}

package/dist/parseOperatorReference.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parseOperatorReference.test.d.ts.map

package/dist/parseOperatorReference.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOperatorReference.test.d.ts","sourceRoot":"","sources":["../src/parseOperatorReference.test.ts"],"names":[],"mappings":""}