@mseep/korean-dart-mcp 0.9.3

package/build/lib/xbrl-parser.d.ts

@@ -0,0 +1,145 @@
+/**
+ * XBRL 파서 — DART instance document 에서 주요 재무제표(BS/IS/CF) 추출.
+ *
+ * 설계:
+ *   - v0.8: whitelist 기반 (핵심 50 태그 내외). presentation/calculation linkbase 무시.
+ *   - v0.9: "full" 모드 추가 — presentation linkbase 기반 계층/순서, calculation
+ *     linkbase 기반 합산 검증. 업종별 택소노미에 자동 대응 (taxonomy에서 직접 추출).
+ *   - 라벨: 한국어(lab-ko.xml) primary role 만 사용, 없으면 tag 로 폴백.
+ *   - 재무제표 본체 facts: segment 가 ConsolidatedMember/SeparateMember "만" 있는
+ *     단순 context (추가 axis 를 가진 주석 facts 는 제외).
+ *   - 기간: context id prefix 로 판별 (CFY=current, PFY=prior, BPFY=before-prior).
+ *   - 단위: 원화(KRW) 그대로. decimals 는 표시 지침이라 별도 스케일 변환 없음.
+ *
+ * DART role 코드:
+ *   D210=BS, D310=IS, D410=CI, D520=SE(자본변동), D610=CF.
+ *   접미 00=연결, 05=별도. D8xxxxx 는 주석/공시.
+ */
+export declare const BS_TAGS: string[];
+export declare const IS_TAGS: string[];
+export declare const CF_TAGS: string[];
+export interface XbrlFact {
+    tag: string;
+    contextRef: string;
+    unitRef?: string;
+    decimals?: string;
+    value: string;
+}
+export interface XbrlContext {
+    id: string;
+    consolidated: boolean | null;
+    dimensionCount: number;
+    periodType: "instant" | "duration";
+    instant?: string;
+    startDate?: string;
+    endDate?: string;
+    periodBucket: "current" | "prior" | "priorPrior" | null;
+    pointType: "instant" | "duration";
+}
+export interface XbrlData {
+    facts: XbrlFact[];
+    contexts: Map<string, XbrlContext>;
+    labels: Map<string, string>;
+    entityId: string | null;
+    taxonomy?: XbrlTaxonomy;
+    /** DOM 파싱 중 누적된 경고·에러 메시지. 빈 결과와 파싱 실패를 구분하기 위함. */
+    parseWarnings?: string[];
+}
+export interface RoleInfo {
+    roleUri: string;
+    statementType: "BS" | "IS" | "CI" | "SE" | "CF" | null;
+    fs_div: "consolidated" | "separate" | null;
+}
+export interface PresentationNode {
+    tag: string;
+    depth: number;
+    order: number;
+    parent: string | null;
+}
+export interface RolePresentation {
+    info: RoleInfo;
+    nodes: PresentationNode[];
+}
+export interface CalcRelation {
+    parent: string;
+    child: string;
+    weight: number;
+    order: number;
+}
+export interface RoleCalculation {
+    info: RoleInfo;
+    relations: CalcRelation[];
+}
+export interface XbrlTaxonomy {
+    presentations: RolePresentation[];
+    calculations: RoleCalculation[];
+}
+export interface StatementRow {
+    tag: string;
+    label: string;
+    depth?: number;
+    current: number | null;
+    prior: number | null;
+    priorPrior: number | null;
+}
+export interface StatementTable {
+    rows: StatementRow[];
+}
+export interface CalcViolation {
+    parent: string;
+    parent_label: string;
+    expected: number;
+    actual: number;
+    diff: number;
+    ratio: number;
+    period: "current" | "prior" | "priorPrior";
+}
+export interface Statements {
+    periods: {
+        current: {
+            end?: string;
+            start?: string;
+        } | null;
+        prior: {
+            end?: string;
+            start?: string;
+        } | null;
+        priorPrior: {
+            end?: string;
+            start?: string;
+        } | null;
+    };
+    fs_div: "consolidated" | "separate";
+    mode: "whitelist" | "full";
+    statements: {
+        BS?: StatementTable;
+        IS?: StatementTable;
+        CF?: StatementTable;
+    };
+    validations?: CalcViolation[];
+}
+export declare function extractXbrlFilesFromZip(zipBuf: Buffer): Promise<Map<string, string>>;
+export declare function parseInstance(xml: string): {
+    facts: XbrlFact[];
+    contexts: Map<string, XbrlContext>;
+    entityId: string | null;
+    errors: string[];
+};
+export declare function parseLabels(xml: string): Map<string, string>;
+/** role URI → {statementType, fs_div}. 주석(D8xx)·자본변동(D52)은 제외 시 null 반환됨. */
+export declare function classifyRole(roleUri: string): RoleInfo;
+export declare function parsePresentationLinkbase(xml: string): RolePresentation[];
+export declare function parseCalculationLinkbase(xml: string): RoleCalculation[];
+export declare function parseXbrlZip(zipBuf: Buffer, opts?: {
+    loadTaxonomy?: boolean;
+}): Promise<XbrlData>;
+export declare function buildStatements(data: XbrlData, opts: {
+    fs_div: "consolidated" | "separate";
+    sections: ("BS" | "IS" | "CF")[];
+}): Statements;
+/** presentation linkbase 트리를 기반으로 full 재무제표 구성. 원본 항목 순서/계층 보존. */
+export declare function buildStatementsFull(data: XbrlData, opts: {
+    fs_div: "consolidated" | "separate";
+    sections: ("BS" | "IS" | "CF")[];
+}): Statements;
+export declare function renderMarkdown(st: Statements): string;