feishu-docs-cli 0.1.0-beta.10

package/dist/parser/block-types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * BlockType constants and code language mapping.
+ *
+ * IDs from Feishu DocX API:
+ * https://open.feishu.cn/document/client-docs/docs-add-on/block-type-overview
+ */
+export declare const BlockType: {
+    readonly PAGE: 1;
+    readonly TEXT: 2;
+    readonly HEADING1: 3;
+    readonly HEADING2: 4;
+    readonly HEADING3: 5;
+    readonly HEADING4: 6;
+    readonly HEADING5: 7;
+    readonly HEADING6: 8;
+    readonly HEADING7: 9;
+    readonly HEADING8: 10;
+    readonly HEADING9: 11;
+    readonly BULLET: 12;
+    readonly ORDERED: 13;
+    readonly CODE: 14;
+    readonly QUOTE: 15;
+    readonly EQUATION: 16;
+    readonly TODO: 17;
+    readonly BITABLE: 18;
+    readonly CALLOUT: 19;
+    readonly CHAT_CARD: 20;
+    readonly DIAGRAM: 21;
+    readonly DIVIDER: 22;
+    readonly FILE: 23;
+    readonly GRID: 24;
+    readonly GRID_COLUMN: 25;
+    readonly IFRAME: 26;
+    readonly IMAGE: 27;
+    readonly ISV: 28;
+    readonly MINDNOTE: 29;
+    readonly SHEET: 30;
+    readonly TABLE: 31;
+    readonly TABLE_CELL: 32;
+    readonly VIEW: 33;
+    readonly QUOTE_CONTAINER: 34;
+    readonly TASK: 35;
+    readonly OKR: 36;
+    readonly OKR_OBJECTIVE: 37;
+    readonly OKR_KEY_RESULT: 38;
+    readonly OKR_PROGRESS: 39;
+    readonly ADDONS: 40;
+    readonly JIRA_ISSUE: 41;
+    readonly WIKI_CATALOG: 42;
+    readonly BOARD: 43;
+    readonly AGENDA: 44;
+    readonly AGENDA_ITEM: 45;
+    readonly AGENDA_ITEM_TITLE: 46;
+    readonly AGENDA_ITEM_CONTENT: 47;
+    readonly LINK_PREVIEW: 48;
+    readonly SOURCE_SYNCED: 49;
+    readonly REFERENCE_SYNCED: 50;
+    readonly SUB_PAGE_LIST: 51;
+    readonly AI_TEMPLATE: 52;
+};
+export declare function isHeading(type: number): boolean;
+export declare function headingLevel(type: number): number;
+/**
+ * Feishu code language enum → display name.
+ * Values from SDK: 0 = PlainText, 1 = ABAP, etc.
+ */
+export declare const CODE_LANGUAGES: {
+    readonly 0: "plaintext";
+    readonly 2: "abap";
+    readonly 3: "ada";
+    readonly 4: "apache";
+    readonly 5: "apex";
+    readonly 6: "assembly";
+    readonly 7: "bash";
+    readonly 8: "c#";
+    readonly 9: "c++";
+    readonly 10: "c";
+    readonly 11: "cobol";
+    readonly 12: "css";
+    readonly 13: "coffeescript";
+    readonly 14: "d";
+    readonly 15: "dart";
+    readonly 16: "delphi";
+    readonly 17: "django";
+    readonly 18: "dockerfile";
+    readonly 19: "erlang";
+    readonly 20: "fortran";
+    readonly 21: "foxpro";
+    readonly 22: "go";
+    readonly 23: "groovy";
+    readonly 24: "html";
+    readonly 25: "elixir";
+    readonly 26: "http";
+    readonly 27: "haskell";
+    readonly 28: "json";
+    readonly 29: "java";
+    readonly 30: "javascript";
+    readonly 31: "julia";
+    readonly 32: "kotlin";
+    readonly 33: "latex";
+    readonly 34: "lisp";
+    readonly 35: "logo";
+    readonly 36: "lua";
+    readonly 37: "matlab";
+    readonly 38: "makefile";
+    readonly 39: "markdown";
+    readonly 40: "nginx";
+    readonly 41: "objective-c";
+    readonly 42: "openedgeabl";
+    readonly 43: "php";
+    readonly 44: "perl";
+    readonly 45: "postscript";
+    readonly 46: "powershell";
+    readonly 47: "prolog";
+    readonly 48: "protobuf";
+    readonly 49: "python";
+    readonly 50: "r";
+    readonly 51: "rpg";
+    readonly 52: "ruby";
+    readonly 53: "rust";
+    readonly 54: "sas";
+    readonly 55: "plsql";
+    readonly 56: "sql";
+    readonly 57: "scala";
+    readonly 58: "scheme";
+    readonly 59: "scratch";
+    readonly 60: "shell";
+    readonly 61: "swift";
+    readonly 62: "thrift";
+    readonly 63: "typescript";
+    readonly 64: "vbscript";
+    readonly 65: "visual basic";
+    readonly 66: "xml";
+    readonly 67: "yaml";
+    readonly 68: "cmake";
+    readonly 69: "ansi";
+    readonly 70: "graphql";
+    readonly 71: "solidity";
+    readonly 72: "toml";
+};
+export declare const LANGUAGE_TO_ENUM: Readonly<Record<string, number | undefined>>;

package/dist/parser/block-types.js

@@ -0,0 +1,167 @@
+/**
+ * BlockType constants and code language mapping.
+ *
+ * IDs from Feishu DocX API:
+ * https://open.feishu.cn/document/client-docs/docs-add-on/block-type-overview
+ */
+export const BlockType = {
+    PAGE: 1,
+    TEXT: 2,
+    HEADING1: 3,
+    HEADING2: 4,
+    HEADING3: 5,
+    HEADING4: 6,
+    HEADING5: 7,
+    HEADING6: 8,
+    HEADING7: 9,
+    HEADING8: 10,
+    HEADING9: 11,
+    BULLET: 12,
+    ORDERED: 13,
+    CODE: 14,
+    QUOTE: 15,
+    EQUATION: 16,
+    TODO: 17,
+    BITABLE: 18,
+    CALLOUT: 19,
+    CHAT_CARD: 20,
+    DIAGRAM: 21,
+    DIVIDER: 22,
+    FILE: 23,
+    GRID: 24,
+    GRID_COLUMN: 25,
+    IFRAME: 26,
+    IMAGE: 27,
+    ISV: 28,
+    MINDNOTE: 29,
+    SHEET: 30,
+    TABLE: 31,
+    TABLE_CELL: 32,
+    VIEW: 33,
+    QUOTE_CONTAINER: 34,
+    TASK: 35,
+    OKR: 36,
+    OKR_OBJECTIVE: 37,
+    OKR_KEY_RESULT: 38,
+    OKR_PROGRESS: 39,
+    ADDONS: 40,
+    JIRA_ISSUE: 41,
+    WIKI_CATALOG: 42,
+    BOARD: 43,
+    AGENDA: 44,
+    AGENDA_ITEM: 45,
+    AGENDA_ITEM_TITLE: 46,
+    AGENDA_ITEM_CONTENT: 47,
+    LINK_PREVIEW: 48,
+    SOURCE_SYNCED: 49,
+    REFERENCE_SYNCED: 50,
+    SUB_PAGE_LIST: 51,
+    AI_TEMPLATE: 52,
+};
+export function isHeading(type) {
+    return type >= BlockType.HEADING1 && type <= BlockType.HEADING9;
+}
+export function headingLevel(type) {
+    return type - BlockType.HEADING1 + 1;
+}
+/**
+ * Feishu code language enum → display name.
+ * Values from SDK: 0 = PlainText, 1 = ABAP, etc.
+ */
+export const CODE_LANGUAGES = {
+    0: "plaintext",
+    2: "abap",
+    3: "ada",
+    4: "apache",
+    5: "apex",
+    6: "assembly",
+    7: "bash",
+    8: "c#",
+    9: "c++",
+    10: "c",
+    11: "cobol",
+    12: "css",
+    13: "coffeescript",
+    14: "d",
+    15: "dart",
+    16: "delphi",
+    17: "django",
+    18: "dockerfile",
+    19: "erlang",
+    20: "fortran",
+    21: "foxpro",
+    22: "go",
+    23: "groovy",
+    24: "html",
+    25: "elixir",
+    26: "http",
+    27: "haskell",
+    28: "json",
+    29: "java",
+    30: "javascript",
+    31: "julia",
+    32: "kotlin",
+    33: "latex",
+    34: "lisp",
+    35: "logo",
+    36: "lua",
+    37: "matlab",
+    38: "makefile",
+    39: "markdown",
+    40: "nginx",
+    41: "objective-c",
+    42: "openedgeabl",
+    43: "php",
+    44: "perl",
+    45: "postscript",
+    46: "powershell",
+    47: "prolog",
+    48: "protobuf",
+    49: "python",
+    50: "r",
+    51: "rpg",
+    52: "ruby",
+    53: "rust",
+    54: "sas",
+    55: "plsql",
+    56: "sql",
+    57: "scala",
+    58: "scheme",
+    59: "scratch",
+    60: "shell",
+    61: "swift",
+    62: "thrift",
+    63: "typescript",
+    64: "vbscript",
+    65: "visual basic",
+    66: "xml",
+    67: "yaml",
+    68: "cmake",
+    69: "ansi",
+    70: "graphql",
+    71: "solidity",
+    72: "toml",
+};
+/**
+ * Markdown language name → Feishu code language enum value.
+ */
+const baseLangMap = Object.fromEntries(Object.entries(CODE_LANGUAGES).map(([k, v]) => [v.toLowerCase(), Number(k)]));
+export const LANGUAGE_TO_ENUM = Object.freeze({
+    ...baseLangMap,
+    // Common aliases
+    js: baseLangMap["javascript"],
+    ts: baseLangMap["typescript"],
+    py: baseLangMap["python"],
+    rb: baseLangMap["ruby"],
+    sh: baseLangMap["shell"],
+    yml: baseLangMap["yaml"],
+    md: baseLangMap["markdown"],
+    rs: baseLangMap["rust"],
+    cs: baseLangMap["c#"],
+    cpp: baseLangMap["c++"],
+    objc: baseLangMap["objective-c"],
+    ps1: baseLangMap["powershell"],
+    vb: baseLangMap["visual basic"],
+    mermaid: baseLangMap["plaintext"],
+});
+//# sourceMappingURL=block-types.js.map

package/dist/parser/block-types.js.map

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

package/dist/parser/blocks-to-md.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Convert Feishu document blocks to Markdown.
+ *
+ * Input: Block[] (flat array with parent_id + children)
+ * Output: Markdown string
+ */
+import { Block } from "../types/index.js";
+interface BlocksToMarkdownOptions {
+    imageUrlMap?: Map<string, string>;
+    userNameMap?: Map<string, string>;
+    bitableDataMap?: Map<string, {
+        fields: string[];
+        records: unknown[][];
+    }>;
+    boardImageMap?: Map<string, string>;
+    sheetDataMap?: Map<string, {
+        fields: string[];
+        records: unknown[][];
+        title?: string;
+    }>;
+}
+/**
+ * Main entry: convert blocks to markdown string.
+ */
+export declare function blocksToMarkdown(blocks: Block[], options?: BlocksToMarkdownOptions): string;
+export {};