@cyanheads/secedgar-mcp-server 0.12.5 → 0.13.1

package/dist/services/edgar/concept-map.js

@@ -2,13 +2,40 @@
  * @fileoverview Static mapping of friendly financial concept names to XBRL tags.
  * @module services/edgar/concept-map
  */
-/** Friendly name → XBRL tag mapping. Tags are tried in order for companyconcept lookups. */
+/**
+ * Friendly name → XBRL tag mapping. Tags are tried in order for companyconcept
+ * lookups, and index 0 is the preferred total when two tags report the same
+ * frame (#44).
+ *
+ * `ifrsTags` is the `ifrs-full` counterpart, used when a caller asks for that
+ * taxonomy. Every entry is confirmed present in the live companyfacts of at
+ * least one 20-F IFRS filer — an IFRS element existing in the taxonomy is not
+ * evidence that filers tag it. A concept with no confirmed IFRS element carries
+ * no `ifrsTags` and is reported as a gap rather than mapped to a guess.
+ */
 const CONCEPT_MAP = {
     revenue: {
         group: 'income_statement',
+        /**
+         * ASC 606 splits the top line by whether assessed sales/excise tax is included.
+         * The Including variant is the reported total for food, beverage, and tobacco
+         * filers, whose ASC 606 election presents revenue gross of tax; without it those
+         * filers fall through to the deprecated tags at the end of the array and return
+         * a series that stops in 2018 (#98).
+         *
+         * It sits behind `Revenues`, not ahead of it, because the two do not agree for
+         * every filer and `Revenues` was already winning those frames: a brewer tags
+         * gross sales under one element and net-of-excise sales under the other, so
+         * promoting the Including variant over `Revenues` swaps the definition partway
+         * back through the history and prints a year-over-year step that is a tag
+         * change, not a business fact. Behind `Revenues` it only fills frames no
+         * current tag covers, which is the case #98 is about. Excluding stays at index
+         * 0 so a filer reporting both variants still resolves to the net total (#44).
+         */
         tags: [
             'RevenueFromContractWithCustomerExcludingAssessedTax',
             'Revenues',
+            'RevenueFromContractWithCustomerIncludingAssessedTax',
             'SalesRevenueNet',
             'SalesRevenueGoodsNet',
         ],
@@ -37,6 +64,7 @@ const CONCEPT_MAP = {
     operating_income: {
         group: 'income_statement',
         tags: ['OperatingIncomeLoss'],
+        ifrsTags: ['ProfitLossFromOperatingActivities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Operating Income (Loss)',
@@ -44,6 +72,7 @@ const CONCEPT_MAP = {
     gross_profit: {
         group: 'income_statement',
         tags: ['GrossProfit'],
+        ifrsTags: ['GrossProfit'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Gross Profit',
@@ -51,6 +80,7 @@ const CONCEPT_MAP = {
     eps_basic: {
         group: 'per_share',
         tags: ['EarningsPerShareBasic'],
+        ifrsTags: ['BasicEarningsLossPerShare'],
         taxonomy: 'us-gaap',
         unit: 'USD/shares',
         label: 'Earnings Per Share (Basic)',
@@ -58,6 +88,7 @@ const CONCEPT_MAP = {
     eps_diluted: {
         group: 'per_share',
         tags: ['EarningsPerShareDiluted'],
+        ifrsTags: ['DilutedEarningsLossPerShare'],
         taxonomy: 'us-gaap',
         unit: 'USD/shares',
         label: 'Earnings Per Share (Diluted)',
@@ -74,6 +105,7 @@ const CONCEPT_MAP = {
     liabilities: {
         group: 'balance_sheet',
         tags: ['Liabilities'],
+        ifrsTags: ['Liabilities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Total Liabilities',
@@ -87,6 +119,13 @@ const CONCEPT_MAP = {
                 note: 'Total equity including noncontrolling interests; the primary line for filers with material minority interests.',
             },
         ],
+        /**
+         * Mirrors the us-gaap split: `EquityAttributableToOwnersOfParent` is the IFRS
+         * counterpart of `StockholdersEquity` (parent-attributable) and leads, with the
+         * `Equity` roll-up — which includes noncontrolling interests, the counterpart of
+         * the relatedTag above — as the fallback for filers that tag only the total.
+         */
+        ifrsTags: ['EquityAttributableToOwnersOfParent', 'Equity'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: "Stockholders' Equity",
@@ -100,6 +139,7 @@ const CONCEPT_MAP = {
                 note: 'Total including restricted cash (the ASU 2016-18 cash-flow reconciliation total); the primary line for many banks and filers with restricted cash.',
             },
         ],
+        ifrsTags: ['CashAndCashEquivalents'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Cash and Cash Equivalents',
@@ -107,6 +147,12 @@ const CONCEPT_MAP = {
     debt: {
         group: 'balance_sheet',
         tags: ['LongTermDebt', 'LongTermDebtNoncurrent'],
+        /**
+         * `LongtermBorrowings` only — the IFRS `Borrowings` element is total borrowings
+         * including the current portion, a different quantity from the long-term line
+         * this concept means, so it is not used as a fallback.
+         */
+        ifrsTags: ['LongtermBorrowings'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Long-Term Debt',
@@ -127,6 +173,7 @@ const CONCEPT_MAP = {
                 note: 'Continuing operations only — excludes discontinued operations; some filers report only this variant.',
             },
         ],
+        ifrsTags: ['CashFlowsFromUsedInOperatingActivities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Operating Cash Flow',
@@ -134,6 +181,7 @@ const CONCEPT_MAP = {
     capex: {
         group: 'cash_flow',
         tags: ['PaymentsToAcquirePropertyPlantAndEquipment'],
+        ifrsTags: ['PurchaseOfPropertyPlantAndEquipmentClassifiedAsInvestingActivities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Capital Expenditures',
@@ -141,6 +189,20 @@ const CONCEPT_MAP = {
     depreciation_amortization: {
         group: 'cash_flow',
         tags: ['DepreciationDepletionAndAmortization', 'DepreciationAndAmortization', 'Depreciation'],
+        /**
+         * Exact counterpart first, approximations behind it: the combined D&A line
+         * matching `DepreciationDepletionAndAmortization` at index 0 above, then the
+         * variant that folds impairment in with it, then depreciation alone. The
+         * middle one runs wider than both its neighbours — it is a fallback for filers
+         * that report no separate D&A line, not a widest-first lead. IFRS filers split
+         * across all three rather than converging on one, so all three are needed for
+         * cross-filer coverage.
+         */
+        ifrsTags: [
+            'DepreciationAndAmortisationExpense',
+            'DepreciationAmortisationAndImpairmentLossReversalOfImpairmentLossRecognisedInProfitOrLoss',
+            'DepreciationExpense',
+        ],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Depreciation & Amortization',
@@ -148,6 +210,11 @@ const CONCEPT_MAP = {
     // Distinct from `debt` (which targets long-term debt directly). `notes_payable` prefers
     // the notes-specific tags and only falls back to LongTermDebt for filers that report it
     // there exclusively.
+    //
+    // No `ifrsTags`: IFRS presents borrowings as one caption and has no balance-sheet
+    // element for the notes/debt split this concept expresses. Left unmapped rather than
+    // pointed at a borrowings total that would silently answer a different question — the
+    // concept comes back as a gap under `ifrs-full`, which is the honest result.
     notes_payable: {
         group: 'balance_sheet',
         tags: ['LongTermNotesPayable', 'NotesPayable', 'LongTermDebt'],
@@ -158,7 +225,14 @@ const CONCEPT_MAP = {
     // Income statement
     cogs: {
         group: 'income_statement',
+        /**
+         * `CostOfGoodsSold` was deprecated in the 2018 taxonomy and survives only as
+         * the last fallback, for filers whose history predates the replacement tags.
+         * When it wins, the resolved series carries SEC's `(Deprecated …)` label and
+         * the reading tools raise a staleness caveat off it (#98).
+         */
         tags: ['CostOfGoodsAndServicesSold', 'CostOfRevenue', 'CostOfGoodsSold'],
+        ifrsTags: ['CostOfSales'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Cost of Goods Sold',
@@ -166,6 +240,9 @@ const CONCEPT_MAP = {
     rd_expense: {
         group: 'income_statement',
         tags: ['ResearchAndDevelopmentExpense'],
+        // The element name is identical in both taxonomies, but the lookup is
+        // namespace-scoped, so ifrs-full needs its own entry to resolve.
+        ifrsTags: ['ResearchAndDevelopmentExpense'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Research & Development Expense',
@@ -173,6 +250,10 @@ const CONCEPT_MAP = {
     sga_expense: {
         group: 'income_statement',
         tags: ['SellingGeneralAndAdministrativeExpense'],
+        // Same element name in ifrs-full, and IFRS filers do report the combined
+        // caption. The narrower `AdministrativeExpense` is deliberately not a
+        // fallback — it excludes selling costs and would understate the line.
+        ifrsTags: ['SellingGeneralAndAdministrativeExpense'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Selling, General & Administrative Expense',
@@ -180,6 +261,14 @@ const CONCEPT_MAP = {
     interest_expense: {
         group: 'income_statement',
         tags: ['InterestExpense', 'InterestExpenseDebt'],
+        /**
+         * `InterestExpense` leads because it is the exact counterpart of the us-gaap
+         * tag. `FinanceCosts` is the IAS 1 income-statement caption and is broader —
+         * it also carries discount unwinding and other financing charges — so it is
+         * the fallback for filers that report no separate interest line, not the
+         * preferred total. A filer reporting both resolves to the narrower, exact one.
+         */
+        ifrsTags: ['InterestExpense', 'FinanceCosts'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Interest Expense',
@@ -187,6 +276,13 @@ const CONCEPT_MAP = {
     tax_expense: {
         group: 'income_statement',
         tags: ['IncomeTaxExpenseBenefit'],
+        /**
+         * IFRS names its income-statement tax caption for continuing operations
+         * because IAS 1 presents discontinued operations net of tax on a separate
+         * line — so this element is the whole tax expense shown on the face of the
+         * statement, not a partial one. It is the only tax element IFRS filers tag.
+         */
+        ifrsTags: ['IncomeTaxExpenseContinuingOperations'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Income Tax Expense (Benefit)',
@@ -194,6 +290,7 @@ const CONCEPT_MAP = {
     stock_based_compensation: {
         group: 'income_statement',
         tags: ['ShareBasedCompensation', 'AllocatedShareBasedCompensationExpense'],
+        ifrsTags: ['ExpenseFromSharebasedPaymentTransactionsWithEmployees'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Stock-Based Compensation',
@@ -202,6 +299,7 @@ const CONCEPT_MAP = {
     current_assets: {
         group: 'balance_sheet',
         tags: ['AssetsCurrent'],
+        ifrsTags: ['CurrentAssets'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Current Assets',
@@ -209,6 +307,7 @@ const CONCEPT_MAP = {
     current_liabilities: {
         group: 'balance_sheet',
         tags: ['LiabilitiesCurrent'],
+        ifrsTags: ['CurrentLiabilities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Current Liabilities',
@@ -216,6 +315,7 @@ const CONCEPT_MAP = {
     inventory: {
         group: 'balance_sheet',
         tags: ['InventoryNet', 'InventoryGross'],
+        ifrsTags: ['Inventories'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Inventory',
@@ -227,6 +327,16 @@ const CONCEPT_MAP = {
             'ReceivablesNetCurrent',
             'AccountsReceivableGrossCurrent',
         ],
+        /**
+         * IFRS filers split between a trade-only caption and the combined
+         * trade-and-other one; both are needed for cross-filer coverage.
+         * `CurrentTradeReceivables` leads because it is the counterpart of
+         * `AccountsReceivableNetCurrent` at index 0 above — the combined caption also
+         * carries prepayments, deposits, and tax receivables, and for a filer
+         * reporting both it runs roughly half again as large, so leading with it
+         * would answer the same concept with a different quantity under each taxonomy.
+         */
+        ifrsTags: ['CurrentTradeReceivables', 'TradeAndOtherCurrentReceivables'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Accounts Receivable (Net)',
@@ -234,6 +344,7 @@ const CONCEPT_MAP = {
     accounts_payable: {
         group: 'balance_sheet',
         tags: ['AccountsPayableCurrent'],
+        ifrsTags: ['TradeAndOtherCurrentPayables'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Accounts Payable',
@@ -241,6 +352,7 @@ const CONCEPT_MAP = {
     goodwill: {
         group: 'balance_sheet',
         tags: ['Goodwill'],
+        ifrsTags: ['Goodwill'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Goodwill',
@@ -248,6 +360,7 @@ const CONCEPT_MAP = {
     intangible_assets: {
         group: 'balance_sheet',
         tags: ['FiniteLivedIntangibleAssetsNet', 'IntangibleAssetsNetExcludingGoodwill'],
+        ifrsTags: ['IntangibleAssetsOtherThanGoodwill'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Intangible Assets (Net)',
@@ -256,6 +369,7 @@ const CONCEPT_MAP = {
     dividends_paid: {
         group: 'cash_flow',
         tags: ['PaymentsOfDividends', 'PaymentsOfDividendsCommonStock'],
+        ifrsTags: ['DividendsPaid', 'DividendsPaidClassifiedAsFinancingActivities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Dividends Paid',
@@ -267,6 +381,16 @@ const CONCEPT_MAP = {
             'PaymentsForRepurchaseOfEquity',
             'StockRepurchasedAndRetiredDuringPeriodValue',
         ],
+        /**
+         * `PaymentsToAcquireOrRedeemEntitysShares` leads: it is the IAS 7 financing
+         * outflow for buying back own shares however they are then treated, the
+         * counterpart of `PaymentsForRepurchaseOfCommonStock` at index 0 above.
+         * `PurchaseOfTreasuryShares` counts only the shares a filer holds in treasury,
+         * so a filer that cancels repurchased shares tags it zero — or at the value of
+         * an employee-scheme purchase — while running a buyback of a wholly different
+         * size, and leading with it would report that zero as the buyback.
+         */
+        ifrsTags: ['PaymentsToAcquireOrRedeemEntitysShares', 'PurchaseOfTreasuryShares'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Share Repurchases',
@@ -280,6 +404,7 @@ const CONCEPT_MAP = {
                 note: 'Continuing operations only — excludes discontinued operations; some filers report only this variant.',
             },
         ],
+        ifrsTags: ['CashFlowsFromUsedInInvestingActivities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Investing Cash Flow',
@@ -293,6 +418,7 @@ const CONCEPT_MAP = {
                 note: 'Continuing operations only — excludes discontinued operations; some filers report only this variant.',
             },
         ],
+        ifrsTags: ['CashFlowsFromUsedInFinancingActivities'],
         taxonomy: 'us-gaap',
         unit: 'USD',
         label: 'Financing Cash Flow',
@@ -306,6 +432,22 @@ export function resolveConcept(input) {
     const normalized = input.toLowerCase().replace(/[- ]/g, '_');
     return CONCEPT_MAP[normalized];
 }
+/**
+ * Resolve a concept input plus a requested taxonomy into the taxonomy and tag
+ * list to query. A friendly name that prefers its own taxonomy (`dei` for
+ * shares_outstanding) keeps it unless the caller asked for something other than
+ * the `us-gaap` default; `ifrs-full` uses the mapping's confirmed IFRS variants
+ * when it has them and falls back to the standard tags otherwise. Unknown input
+ * passes through as a raw XBRL tag under the requested taxonomy.
+ */
+export function resolveConceptTarget(input, requestedTaxonomy) {
+    const mapping = resolveConcept(input);
+    if (!mapping)
+        return { label: input, tags: [input], taxonomy: requestedTaxonomy };
+    const taxonomy = requestedTaxonomy === 'us-gaap' ? mapping.taxonomy : requestedTaxonomy;
+    const tags = taxonomy === 'ifrs-full' && mapping.ifrsTags?.length ? mapping.ifrsTags : mapping.tags;
+    return { label: mapping.label, tags, taxonomy, unit: mapping.unit };
+}
 /** Get all concept mappings for reference resource generation. */
 export function getAllConcepts() {
     return CONCEPT_MAP;

package/dist/services/edgar/concept-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"concept-map.js","sourceRoot":"","sources":["../../../src/services/edgar/concept-map.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"concept-map.js","sourceRoot":"","sources":["../../../src/services/edgar/concept-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,GAAmC;IAClD,OAAO,EAAE;QACP,KAAK,EAAE,kBAAkB;QACzB;;;;;;;;;;;;;;;WAeG;QACH,IAAI,EAAE;YACJ,qDAAqD;YACrD,UAAU;YACV,qDAAqD;YACrD,iBAAiB;YACjB,sBAAsB;SACvB;QACD;;;;;;;WAOG;QACH,QAAQ,EAAE,CAAC,SAAS,EAAE,mCAAmC,CAAC;QAC1D,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,SAAS;KACjB;IACD,UAAU,EAAE;QACV,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,eAAe,CAAC;QACvB,6DAA6D;QAC7D,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,mBAAmB;KAC3B;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,qBAAqB,CAAC;QAC7B,QAAQ,EAAE,CAAC,mCAAmC,CAAC;QAC/C,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,yBAAyB;KACjC;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,aAAa,CAAC;QACrB,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,cAAc;KACtB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,uBAAuB,CAAC;QAC/B,QAAQ,EAAE,CAAC,2BAA2B,CAAC;QACvC,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,4BAA4B;KACpC;IACD,WAAW,EAAE;QACX,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,yBAAyB,CAAC;QACjC,QAAQ,EAAE,CAAC,6BAA6B,CAAC;QACzC,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,8BAA8B;KACtC;IACD,MAAM,EAAE;QACN,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,6DAA6D;QAC7D,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,cAAc;KACtB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,aAAa,CAAC;QACrB,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,mBAAmB;KAC3B;IACD,MAAM,EAAE;QACN,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,oBAAoB,CAAC;QAC5B,WAAW,EAAE;YACX;gBACE,GAAG,EAAE,wEAAwE;gBAC7E,IAAI,EAAE,gHAAgH;aACvH;SACF;QACD;;;;;WAKG;QACH,QAAQ,EAAE,CAAC,oCAAoC,EAAE,QAAQ,CAAC;QAC1D,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,sBAAsB;KAC9B;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,uCAAuC,CAAC;QAC/C,WAAW,EAAE;YACX;gBACE,GAAG,EAAE,+DAA+D;gBACpE,IAAI,EAAE,oJAAoJ;aAC3J;SACF;QACD,QAAQ,EAAE,CAAC,wBAAwB,CAAC;QACpC,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,2BAA2B;KACnC;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,cAAc,EAAE,wBAAwB,CAAC;QAChD;;;;WAIG;QACH,QAAQ,EAAE,CAAC,oBAAoB,CAAC;QAChC,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gBAAgB;KACxB;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,CAAC,oCAAoC,CAAC;QAC5C,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,oBAAoB;KAC5B;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,4CAA4C,CAAC;QACpD,WAAW,EAAE;YACX;gBACE,GAAG,EAAE,gEAAgE;gBACrE,IAAI,EAAE,sGAAsG;aAC7G;SACF;QACD,QAAQ,EAAE,CAAC,wCAAwC,CAAC;QACpD,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,qBAAqB;KAC7B;IACD,KAAK,EAAE;QACL,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,4CAA4C,CAAC;QACpD,QAAQ,EAAE,CAAC,oEAAoE,CAAC;QAChF,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,sBAAsB;KAC9B;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,sCAAsC,EAAE,6BAA6B,EAAE,cAAc,CAAC;QAC7F;;;;;;;;WAQG;QACH,QAAQ,EAAE;YACR,oCAAoC;YACpC,2FAA2F;YAC3F,qBAAqB;SACtB;QACD,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,6BAA6B;KACrC;IACD,wFAAwF;IACxF,wFAAwF;IACxF,qBAAqB;IACrB,EAAE;IACF,kFAAkF;IAClF,qFAAqF;IACrF,sFAAsF;IACtF,6EAA6E;IAC7E,aAAa,EAAE;QACb,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,sBAAsB,EAAE,cAAc,EAAE,cAAc,CAAC;QAC9D,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,eAAe;KACvB;IAED,mBAAmB;IACnB,IAAI,EAAE;QACJ,KAAK,EAAE,kBAAkB;QACzB;;;;;WAKG;QACH,IAAI,EAAE,CAAC,4BAA4B,EAAE,eAAe,EAAE,iBAAiB,CAAC;QACxE,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,oBAAoB;KAC5B;IACD,UAAU,EAAE;QACV,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,+BAA+B,CAAC;QACvC,sEAAsE;QACtE,iEAAiE;QACjE,QAAQ,EAAE,CAAC,+BAA+B,CAAC;QAC3C,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gCAAgC;KACxC;IACD,WAAW,EAAE;QACX,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,wCAAwC,CAAC;QAChD,yEAAyE;QACzE,sEAAsE;QACtE,sEAAsE;QACtE,QAAQ,EAAE,CAAC,wCAAwC,CAAC;QACpD,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,2CAA2C;KACnD;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;QAChD;;;;;;WAMG;QACH,QAAQ,EAAE,CAAC,iBAAiB,EAAE,cAAc,CAAC;QAC7C,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,kBAAkB;KAC1B;IACD,WAAW,EAAE;QACX,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,yBAAyB,CAAC;QACjC;;;;;WAKG;QACH,QAAQ,EAAE,CAAC,sCAAsC,CAAC;QAClD,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,8BAA8B;KACtC;IACD,wBAAwB,EAAE;QACxB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,CAAC,wBAAwB,EAAE,wCAAwC,CAAC;QAC1E,QAAQ,EAAE,CAAC,uDAAuD,CAAC;QACnE,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,0BAA0B;KAClC;IAED,gBAAgB;IAChB,cAAc,EAAE;QACd,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,eAAe,CAAC;QACvB,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gBAAgB;KACxB;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,oBAAoB,CAAC;QAC5B,QAAQ,EAAE,CAAC,oBAAoB,CAAC;QAChC,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,qBAAqB;KAC7B;IACD,SAAS,EAAE;QACT,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC;QACxC,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,WAAW;KACnB;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE;YACJ,8BAA8B;YAC9B,uBAAuB;YACvB,gCAAgC;SACjC;QACD;;;;;;;;WAQG;QACH,QAAQ,EAAE,CAAC,yBAAyB,EAAE,iCAAiC,CAAC;QACxE,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,2BAA2B;KACnC;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,wBAAwB,CAAC;QAChC,QAAQ,EAAE,CAAC,8BAA8B,CAAC;QAC1C,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,kBAAkB;KAC1B;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,UAAU;KAClB;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,CAAC,gCAAgC,EAAE,sCAAsC,CAAC;QAChF,QAAQ,EAAE,CAAC,mCAAmC,CAAC;QAC/C,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,yBAAyB;KACjC;IAED,YAAY;IACZ,cAAc,EAAE;QACd,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,qBAAqB,EAAE,gCAAgC,CAAC;QAC/D,QAAQ,EAAE,CAAC,eAAe,EAAE,8CAA8C,CAAC;QAC3E,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,gBAAgB;KACxB;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE;YACJ,oCAAoC;YACpC,+BAA+B;YAC/B,6CAA6C;SAC9C;QACD;;;;;;;;WAQG;QACH,QAAQ,EAAE,CAAC,wCAAwC,EAAE,0BAA0B,CAAC;QAChF,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,mBAAmB;KAC3B;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,4CAA4C,CAAC;QACpD,WAAW,EAAE;YACX;gBACE,GAAG,EAAE,gEAAgE;gBACrE,IAAI,EAAE,sGAAsG;aAC7G;SACF;QACD,QAAQ,EAAE,CAAC,wCAAwC,CAAC;QACpD,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,qBAAqB;KAC7B;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,CAAC,4CAA4C,CAAC;QACpD,WAAW,EAAE;YACX;gBACE,GAAG,EAAE,gEAAgE;gBACrE,IAAI,EAAE,sGAAsG;aAC7G;SACF;QACD,QAAQ,EAAE,CAAC,wCAAwC,CAAC;QACpD,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,qBAAqB;KAC7B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7D,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,iBAAkC;IAElC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAElF,MAAM,QAAQ,GAAG,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACxF,MAAM,IAAI,GACR,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACzF,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AACtE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC;AACrB,CAAC;AAOD;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;SAChD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,8FAA8F;AAC9F,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,QAAiB;IAC7D,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAAO,GAAG,YAAY,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAE5B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,MAAM,SAAS,GAAG;YAChB,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;YAC9B,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC;YAC/B,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC;YACrC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC;YACjD,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SACnE,CAAC;QACF,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/edgar/concept-series.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Frame-aligned XBRL series resolution, shared by every tool that
+ * reads company facts. One value per standard calendar period: entries without a
+ * `frame` are dropped, same-frame collisions resolve by tag priority (index 0 =
+ * the preferred total), and ties within one tag resolve to the latest `filed`
+ * date so a restatement replaces the original. Extracted from `get_financials`
+ * so the snapshot and comparison tools produce numbers identical to it rather
+ * than re-implementing the rules.
+ * @module services/edgar/concept-series
+ */
+import type { CompanyConceptUnit, CompanyFactsResponse } from './types.js';
+/** A reported value carrying the priority index of the tag that produced it. */
+export interface TagPrioritizedUnit extends CompanyConceptUnit {
+    /** Position of the source tag in the concept's tag array. Lower wins a collision. */
+    tagIndex: number;
+}
+/** A reported value guaranteed to carry a standard calendar-period frame. */
+export interface FramedUnit extends CompanyConceptUnit {
+    frame: string;
+}
+/** Period filter applied to a resolved series. */
+export type PeriodType = 'annual' | 'quarterly' | 'all';
+/**
+ * Collapse a company's reported values to one per standard calendar period.
+ *
+ * Values with no `frame` are non-standard periods and are dropped. When two
+ * values share a frame, the one from the lower-priority-index tag wins (index 0
+ * is the preferred total, e.g. IFRS `Revenue` over the
+ * `RevenueFromContractsWithCustomers` sub-line); within one tag, the later
+ * `filed` date wins so an amended filing replaces the original. Returns an empty
+ * map when nothing carried a frame — the caller distinguishes that from "the
+ * concept is not reported at all".
+ */
+export declare function resolveFrameSeries(units: readonly TagPrioritizedUnit[]): Map<string, FramedUnit>;
+/**
+ * Caveat for a concept that resolved to a tag SEC has retired from the taxonomy.
+ *
+ * A friendly name is a priority-ordered list of tags, and the lookup walks it
+ * until one returns data. When every current tag comes back empty for a filer,
+ * a deprecated tag at the end of the list can still match and produce a series
+ * that looks complete but stops around the tag's retirement — the failure is
+ * otherwise silent, since nothing in the values themselves says the tag is dead.
+ * The signal is the taxonomy label SEC already ships with the payload, so this
+ * generalizes to any concept whose fallback chain reaches a retired tag rather
+ * than to one hard-coded pair.
+ *
+ * Returns an empty array for a current tag, which is the common case.
+ */
+export declare function deprecatedTagCaveats(tag: string, label: string): string[];
+/**
+ * Whether a frame belongs to the requested period type. `fp` reflects the source
+ * filing rather than the data point, so the frame label is the only reliable
+ * period key.
+ */
+export declare function matchesPeriodType(frame: string, periodType: PeriodType): boolean;
+/** One concept resolved out of a companyfacts payload. */
+export interface ConceptSeries {
+    /** XBRL taxonomy description. Absent for company-extension and older tags. */
+    description?: string;
+    /** Human-readable label from the taxonomy. */
+    label: string;
+    /** Frame-aligned values, newest first. Empty when the tag reports no framed periods. */
+    series: FramedUnit[];
+    /** The tag that produced the values. */
+    tag: string;
+    /** Every tag attempted, in priority order. */
+    tagsTried: string[];
+    /** Taxonomy the values were read from. */
+    taxonomy: string;
+    /** Unit of measure key (e.g. `USD`, `USD/shares`, `shares`). */
+    unit: string;
+}
+/**
+ * Resolve one concept from a companyfacts payload, applying the same tag
+ * priority and frame dedup as {@link resolveFrameSeries}. Returns `undefined`
+ * when the filer reports none of the candidate tags under this taxonomy, which
+ * the caller surfaces as a gap alongside the tags it tried.
+ */
+export declare function seriesFromCompanyFacts(facts: CompanyFactsResponse, taxonomy: string, tags: readonly string[]): ConceptSeries | undefined;
+//# sourceMappingURL=concept-series.d.ts.map

package/dist/services/edgar/concept-series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-series.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/concept-series.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,gFAAgF;AAChF,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAW,SAAQ,kBAAkB;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;AAgBxD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAoBhG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAIhF;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,aAAa,GAAG,SAAS,CA0B3B"}

package/dist/services/edgar/concept-series.js

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Frame-aligned XBRL series resolution, shared by every tool that
+ * reads company facts. One value per standard calendar period: entries without a
+ * `frame` are dropped, same-frame collisions resolve by tag priority (index 0 =
+ * the preferred total), and ties within one tag resolve to the latest `filed`
+ * date so a restatement replaces the original. Extracted from `get_financials`
+ * so the snapshot and comparison tools produce numbers identical to it rather
+ * than re-implementing the rules.
+ * @module services/edgar/concept-series
+ */
+/**
+ * SEC stamps a retired element's retirement date into the taxonomy label it
+ * serves with every companyconcept and companyfacts payload — e.g.
+ * `"Sales Revenue, Goods, Net (Deprecated 2018-01-31)"`. Matching it is the whole
+ * staleness signal; no extra upstream call is involved.
+ */
+const DEPRECATED_LABEL = /\(Deprecated\s+(\d{4}-\d{2}-\d{2})\)/i;
+/** Annual duration frame — `CY2023`. */
+const ANNUAL_FRAME = /^CY\d{4}$/;
+/** Quarterly frame — `CY2023Q3` (duration) or `CY2023Q3I` (instant). */
+const QUARTERLY_FRAME = /^CY\d{4}Q\d/;
+/**
+ * Collapse a company's reported values to one per standard calendar period.
+ *
+ * Values with no `frame` are non-standard periods and are dropped. When two
+ * values share a frame, the one from the lower-priority-index tag wins (index 0
+ * is the preferred total, e.g. IFRS `Revenue` over the
+ * `RevenueFromContractsWithCustomers` sub-line); within one tag, the later
+ * `filed` date wins so an amended filing replaces the original. Returns an empty
+ * map when nothing carried a frame — the caller distinguishes that from "the
+ * concept is not reported at all".
+ */
+export function resolveFrameSeries(units) {
+    const byFrame = new Map();
+    for (const unit of units) {
+        const { frame } = unit;
+        if (!frame)
+            continue;
+        const existing = byFrame.get(frame);
+        if (!existing ||
+            unit.tagIndex < existing.tagIndex ||
+            (unit.tagIndex === existing.tagIndex && unit.filed > existing.filed)) {
+            byFrame.set(frame, { ...unit, frame });
+        }
+    }
+    const resolved = new Map();
+    for (const [frame, { tagIndex: _tagIndex, ...unit }] of byFrame) {
+        resolved.set(frame, unit);
+    }
+    return resolved;
+}
+/**
+ * Caveat for a concept that resolved to a tag SEC has retired from the taxonomy.
+ *
+ * A friendly name is a priority-ordered list of tags, and the lookup walks it
+ * until one returns data. When every current tag comes back empty for a filer,
+ * a deprecated tag at the end of the list can still match and produce a series
+ * that looks complete but stops around the tag's retirement — the failure is
+ * otherwise silent, since nothing in the values themselves says the tag is dead.
+ * The signal is the taxonomy label SEC already ships with the payload, so this
+ * generalizes to any concept whose fallback chain reaches a retired tag rather
+ * than to one hard-coded pair.
+ *
+ * Returns an empty array for a current tag, which is the common case.
+ */
+export function deprecatedTagCaveats(tag, label) {
+    const match = DEPRECATED_LABEL.exec(label);
+    if (!match?.[1])
+        return [];
+    return [
+        `XBRL tag ${tag} was retired from the taxonomy on ${match[1]} — SEC labels it "${label}". It matched only because every current tag ahead of it in this concept's priority list reports nothing for this filer, so the series can end years before the filer's latest report. Check secedgar_search_concepts for the concept's full tag list, or pass the tag this filer reports today.`,
+    ];
+}
+/**
+ * Whether a frame belongs to the requested period type. `fp` reflects the source
+ * filing rather than the data point, so the frame label is the only reliable
+ * period key.
+ */
+export function matchesPeriodType(frame, periodType) {
+    if (periodType === 'annual')
+        return ANNUAL_FRAME.test(frame);
+    if (periodType === 'quarterly')
+        return QUARTERLY_FRAME.test(frame);
+    return true;
+}
+/**
+ * Resolve one concept from a companyfacts payload, applying the same tag
+ * priority and frame dedup as {@link resolveFrameSeries}. Returns `undefined`
+ * when the filer reports none of the candidate tags under this taxonomy, which
+ * the caller surfaces as a gap alongside the tags it tried.
+ */
+export function seriesFromCompanyFacts(facts, taxonomy, tags) {
+    const namespace = facts.facts[taxonomy];
+    if (!namespace)
+        return;
+    const units = [];
+    const tagsTried = [];
+    let resolved;
+    for (const [tagIndex, tag] of tags.entries()) {
+        tagsTried.push(tag);
+        const concept = namespace[tag];
+        if (!concept?.units)
+            continue;
+        for (const [unitKey, values] of Object.entries(concept.units)) {
+            resolved ??= {
+                tag,
+                label: concept.label ?? tag,
+                unit: unitKey,
+                ...(concept.description !== undefined ? { description: concept.description } : {}),
+            };
+            for (const value of values)
+                units.push({ ...value, tagIndex });
+        }
+    }
+    if (!resolved)
+        return;
+    const series = [...resolveFrameSeries(units).values()].sort((a, b) => b.end.localeCompare(a.end));
+    return { ...resolved, series, tagsTried, taxonomy };
+}
+//# sourceMappingURL=concept-series.js.map

package/dist/services/edgar/concept-series.js.map

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

package/dist/services/edgar/edgar-api-service.d.ts

@@ -5,7 +5,7 @@
  * @module services/edgar/edgar-api-service
  */
 import { type FilingDocumentHeader } from './filing-headers.js';
-import type { CikMatch, CompanyConceptResponse, EftsResponse, FilingIndex, FilingsRecent, FramesResponse, FullIndexEntry, SubmissionsResponse } from './types.js';
+import type { CikMatch, CompanyConceptResponse, CompanyFactsResponse, EftsResponse, FilingIndex, FilingsRecent, FramesResponse, FullIndexEntry, SubmissionsResponse } from './types.js';
 /** A candidate suggestion from the trigram scan on no-result name search. */
 export interface CompanySuggestion {
     cik: string;
@@ -142,12 +142,14 @@ declare class EdgarApiService {
         reportDate: string;
     }>>;
     /**
-     * Fetch all XBRL facts for a company. Returns `null` on 404.
-     * Used on the no-data error path to surface which namespaces and tags a filer actually uses.
+     * Fetch every XBRL fact a company has reported. Returns `null` on 404.
+     * Backs the whole-company reads (`get_snapshot`, `compare_companies`) and the
+     * no-data error path, which surfaces the namespaces and tags a filer uses.
+     * Served from the local mirror when enabled and synced — the mirror stores one
+     * row per (cik, taxonomy, tag) and reassembles the API shape off a `cik` point
+     * lookup; the live API is the fallback.
      */
-    tryGetCompanyFacts(cik: string): Promise<{
-        facts: Record<string, Record<string, unknown>>;
-    } | null>;
+    tryGetCompanyFacts(cik: string): Promise<CompanyFactsResponse | null>;
     /**
      * Fetch XBRL data for a concept. Returns `null` if the company does not report this tag.
      * Served from the local mirror when enabled and synced; the live API is the