docusaurus-plugin-gitbook 0.1.0

package/README.md

@@ -0,0 +1,210 @@
+# docusaurus-plugin-gitbook
+
+A [Docusaurus plugin](https://docusaurus.io/docs/advanced/plugins) that adds support for GitBook-specific block syntax in MDX files.
+
+📖 **[Full Documentation](https://www.jasny.net/docusaurus-plugin-gitbook/)**
+
+## Supported Blocks
+
+| Block | Description | Docs |
+|-------|-------------|------|
+| Hints | Info, warning, danger, and success callouts | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/hints) |
+| Tabs | Tabbed content panels | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/tabs) |
+| Stepper | Numbered step-by-step guides | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/stepper) |
+| Columns | Side-by-side column layouts | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/columns) |
+| Code blocks | Code blocks with titles and line numbers | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/code) |
+| Embeds | Embedded external content (YouTube, etc.) | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/embeds) |
+| Files | File download links | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/files) |
+| Buttons | Primary and secondary action buttons | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/buttons) |
+| Cards | Card grid layouts | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/cards) |
+| Icons | Font Awesome icons | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/icons) |
+| OpenAPI | OpenAPI/Swagger endpoint documentation | [View](https://www.jasny.net/docusaurus-plugin-gitbook/blocks/openapi) |
+
+## Installation
+
+```bash
+npm install docusaurus-plugin-gitbook
+# or
+yarn add docusaurus-plugin-gitbook
+```
+
+## Configuration
+
+Add the plugin to your `docusaurus.config.js`:
+
+```javascript
+export default {
+  plugins: ['docusaurus-plugin-gitbook'],
+
+  // Or with options:
+  plugins: [
+    ['docusaurus-plugin-gitbook', {
+      // options
+    }]
+  ],
+};
+```
+
+### Using as Remark/Rehype plugins directly
+
+You can also use the remark and rehype plugins directly:
+
+```javascript
+import { remarkGitBook, rehypeGitBook } from 'docusaurus-plugin-gitbook';
+
+export default {
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        docs: {
+          remarkPlugins: [remarkGitBook],
+          rehypePlugins: [rehypeGitBook],
+        },
+      },
+    ],
+  ],
+};
+```
+
+## Usage
+
+### Hint
+
+```markdown
+{% hint style="info" %}
+This is an informational hint.
+{% endhint %}
+
+{% hint style="warning" %}
+Be careful with this action.
+{% endhint %}
+
+{% hint style="danger" %}
+This action cannot be undone!
+{% endhint %}
+
+{% hint style="success" %}
+Operation completed successfully.
+{% endhint %}
+```
+
+### Tabs
+
+```markdown
+{% tabs %}
+{% tab title="JavaScript" %}
+\`\`\`javascript
+console.log('Hello');
+\`\`\`
+{% endtab %}
+
+{% tab title="Python" %}
+\`\`\`python
+print('Hello')
+\`\`\`
+{% endtab %}
+{% endtabs %}
+```
+
+### Stepper
+
+```markdown
+{% stepper %}
+{% step %}
+## Step 1
+First step content.
+{% endstep %}
+
+{% step %}
+## Step 2
+Second step content.
+{% endstep %}
+{% endstepper %}
+```
+
+### Columns
+
+```markdown
+{% columns %}
+{% column %}
+Left column content.
+{% endcolumn %}
+
+{% column %}
+Right column content.
+{% endcolumn %}
+{% endcolumns %}
+```
+
+### Code with Title
+
+```markdown
+{% code title="example.js" %}
+\`\`\`javascript
+const foo = 'bar';
+\`\`\`
+{% endcode %}
+```
+
+### Embed
+
+```markdown
+{% embed url="https://www.youtube.com/watch?v=VIDEO_ID" %}
+```
+
+### File
+
+```markdown
+{% file src="/path/to/file.pdf" %}
+Optional description.
+{% endfile %}
+```
+
+### Button (HTML)
+
+```html
+<a href="https://example.com" class="button primary">Get Started</a>
+<a href="https://docs.example.com" class="button secondary">Documentation</a>
+```
+
+### Cards (HTML)
+
+```html
+<table data-view="cards">
+    <thead>
+        <tr>
+            <th>Title</th>
+            <th data-card-target data-type="content-ref">Target</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>Getting Started</td>
+            <td><a href="getting-started.md">Quick Start</a></td>
+        </tr>
+    </tbody>
+</table>
+```
+
+## Styling
+
+The plugin includes default styles that work with Docusaurus's light and dark themes. You can customize the appearance using CSS variables:
+
+```css
+:root {
+  --gitbook-hint-info-bg: #e7f3ff;
+  --gitbook-hint-info-border: #0969da;
+  --gitbook-hint-warning-bg: #fff8e6;
+  --gitbook-hint-warning-border: #9a6700;
+  --gitbook-hint-danger-bg: #ffebe9;
+  --gitbook-hint-danger-border: #cf222e;
+  --gitbook-hint-success-bg: #dafbe1;
+  --gitbook-hint-success-border: #1a7f37;
+  /* ... more variables */
+}
+```
+
+## License
+
+MIT

package/lib/index.d.ts

@@ -0,0 +1,51 @@
+import type { LoadContext, Plugin } from '@docusaurus/types';
+export { remarkGitBook } from './remark/index.js';
+export type { RemarkGitBookOptions } from './remark/index.js';
+export { rehypeGitBook } from './rehype/index.js';
+export type { RehypeGitBookOptions } from './rehype/index.js';
+export * from './parser/index.js';
+export * from './theme-types.js';
+/**
+ * Plugin options
+ */
+export interface PluginOptions {
+    /**
+     * Plugin instance ID
+     */
+    id?: string;
+    /**
+     * Enable/disable specific blocks
+     */
+    blocks?: {
+        hint?: boolean;
+        tabs?: boolean;
+        stepper?: boolean;
+        columns?: boolean;
+        updates?: boolean;
+        code?: boolean;
+        embed?: boolean;
+        file?: boolean;
+        include?: boolean;
+        openapi?: boolean;
+        cards?: boolean;
+        button?: boolean;
+        icon?: boolean;
+        expression?: boolean;
+    };
+    /**
+     * Custom class name prefix for CSS
+     */
+    classNamePrefix?: string;
+}
+/**
+ * Docusaurus plugin for GitBook syntax support
+ */
+export default function pluginGitbook(_context: LoadContext, options?: PluginOptions): Plugin;
+/**
+ * Validate plugin options
+ */
+export declare function validateOptions({ options, validate: _validate, }: {
+    options: PluginOptions;
+    validate: <T>(schema: unknown, options: T) => T;
+}): PluginOptions;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EAAE,SAAS,GACpB,EAAE;IACD,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;CACjD,GAAG,aAAa,CAIhB"}

package/lib/index.js

@@ -0,0 +1,39 @@
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+// Re-export remark plugin
+export { remarkGitBook } from './remark/index.js';
+// Re-export rehype plugin
+export { rehypeGitBook } from './rehype/index.js';
+// Re-export parser utilities
+export * from './parser/index.js';
+// Re-export theme types
+export * from './theme-types.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Docusaurus plugin for GitBook syntax support
+ */
+export default function pluginGitbook(_context, options = {}) {
+    const { blocks: _blocks, classNamePrefix: _classNamePrefix } = options;
+    return {
+        name: 'docusaurus-plugin-gitbook',
+        getThemePath() {
+            return path.resolve(__dirname, './theme');
+        },
+        getTypeScriptThemePath() {
+            return path.resolve(__dirname, '../src/theme');
+        },
+        getClientModules() {
+            return [path.resolve(__dirname, './theme/gitbook.css')];
+        },
+    };
+}
+/**
+ * Validate plugin options
+ */
+export function validateOptions({ options, validate: _validate, }) {
+    // For now, just return options as-is
+    // In the future, we could add Joi schema validation
+    return options;
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,0BAA0B;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,6BAA6B;AAC7B,cAAc,mBAAmB,CAAC;AAElC,wBAAwB;AACxB,cAAc,kBAAkB,CAAC;AAqCjC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,QAAqB,EACrB,UAAyB,EAAE;IAE3B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAEvE,OAAO;QACL,IAAI,EAAE,2BAA2B;QAEjC,YAAY;YACV,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,sBAAsB;YACpB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACjD,CAAC;QAED,gBAAgB;YACd,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EAAE,SAAS,GAIpB;IACC,qCAAqC;IACrC,oDAAoD;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/parser/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GitBook parser exports
+ */
+export { tokenize, parseAttributes, isToken, isTextSegment, type Token, type TokenType, type TextSegment, type Segment, } from './tokenizer.js';
+export { parse, findBlocks, extractBlocks, type GitBookBlock, type ParseResult, type ParseError, } from './parser.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,OAAO,EACP,aAAa,EACb,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,EACL,UAAU,EACV,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC"}

package/lib/parser/index.js

@@ -0,0 +1,6 @@
+/**
+ * GitBook parser exports
+ */
+export { tokenize, parseAttributes, isToken, isTextSegment, } from './tokenizer.js';
+export { parse, findBlocks, extractBlocks, } from './parser.js';
+//# sourceMappingURL=index.js.map

package/lib/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,OAAO,EACP,aAAa,GAKd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,EACL,UAAU,EACV,aAAa,GAId,MAAM,aAAa,CAAC"}

package/lib/parser/parser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * GitBook block parser
+ * Parses tokenized GitBook syntax into a structured tree
+ */
+export interface GitBookBlock {
+    name: string;
+    attributes: Record<string, string>;
+    content: string;
+    children: GitBookBlock[];
+    raw: string;
+    start: number;
+    end: number;
+}
+export interface ParseResult {
+    blocks: GitBookBlock[];
+    errors: ParseError[];
+}
+export interface ParseError {
+    message: string;
+    start: number;
+    end: number;
+}
+/**
+ * Parse GitBook block syntax from text
+ */
+export declare function parse(text: string): ParseResult;
+/**
+ * Find all blocks of a specific type in parsed result
+ */
+export declare function findBlocks(blocks: GitBookBlock[], name: string): GitBookBlock[];
+/**
+ * Extract content between GitBook tags, returning both the content
+ * and remaining text
+ */
+export declare function extractBlocks(text: string): {
+    blocks: GitBookBlock[];
+    textSegments: Array<{
+        content: string;
+        start: number;
+        end: number;
+    }>;
+};
+//# sourceMappingURL=parser.d.ts.map

package/lib/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAsGD;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAyD/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE,MAAM,GACX,YAAY,EAAE,CAWhB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,YAAY,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAqClG"}

package/lib/parser/parser.js

@@ -0,0 +1,192 @@
+/**
+ * GitBook block parser
+ * Parses tokenized GitBook syntax into a structured tree
+ */
+import { tokenize, isTextSegment, } from './tokenizer.js';
+/**
+ * Parse a block starting from an open token
+ */
+function parseBlock(ctx, openToken) {
+    const children = [];
+    const contentParts = [];
+    while (ctx.index < ctx.segments.length) {
+        const segment = ctx.segments[ctx.index];
+        if (isTextSegment(segment)) {
+            contentParts.push(segment.content);
+            ctx.index++;
+            continue;
+        }
+        // It's a token
+        if (segment.type === 'close' && segment.name === openToken.name) {
+            // Found matching close tag
+            ctx.index++;
+            const content = contentParts.join('');
+            const endPos = segment.end;
+            return {
+                name: openToken.name,
+                attributes: openToken.attributes,
+                content: content.trim(),
+                children,
+                raw: ctx.source.slice(openToken.start, endPos),
+                start: openToken.start,
+                end: endPos,
+            };
+        }
+        if (segment.type === 'close') {
+            // Mismatched close tag - error
+            ctx.errors.push({
+                message: `Unexpected closing tag {% end${segment.name} %}, expected {% end${openToken.name} %}`,
+                start: segment.start,
+                end: segment.end,
+            });
+            ctx.index++;
+            continue;
+        }
+        if (segment.type === 'self-closing') {
+            // Self-closing tag becomes a child
+            children.push({
+                name: segment.name,
+                attributes: segment.attributes,
+                content: '',
+                children: [],
+                raw: segment.raw,
+                start: segment.start,
+                end: segment.end,
+            });
+            ctx.index++;
+            continue;
+        }
+        if (segment.type === 'open') {
+            // Nested block - recurse
+            ctx.index++;
+            const childBlock = parseBlock(ctx, segment);
+            if (childBlock) {
+                children.push(childBlock);
+            }
+            continue;
+        }
+        ctx.index++;
+    }
+    // Reached end without finding close tag
+    ctx.errors.push({
+        message: `Unclosed tag {% ${openToken.name} %}, expected {% end${openToken.name} %}`,
+        start: openToken.start,
+        end: openToken.end,
+    });
+    // Return what we have anyway
+    return {
+        name: openToken.name,
+        attributes: openToken.attributes,
+        content: contentParts.join('').trim(),
+        children,
+        raw: ctx.source.slice(openToken.start),
+        start: openToken.start,
+        end: ctx.source.length,
+    };
+}
+/**
+ * Parse GitBook block syntax from text
+ */
+export function parse(text) {
+    const segments = tokenize(text);
+    const blocks = [];
+    const ctx = {
+        segments,
+        index: 0,
+        errors: [],
+        source: text,
+    };
+    while (ctx.index < segments.length) {
+        const segment = segments[ctx.index];
+        if (isTextSegment(segment)) {
+            // Skip top-level text
+            ctx.index++;
+            continue;
+        }
+        if (segment.type === 'close') {
+            // Orphan close tag
+            ctx.errors.push({
+                message: `Unexpected closing tag {% end${segment.name} %} without matching open tag`,
+                start: segment.start,
+                end: segment.end,
+            });
+            ctx.index++;
+            continue;
+        }
+        if (segment.type === 'self-closing') {
+            blocks.push({
+                name: segment.name,
+                attributes: segment.attributes,
+                content: '',
+                children: [],
+                raw: segment.raw,
+                start: segment.start,
+                end: segment.end,
+            });
+            ctx.index++;
+            continue;
+        }
+        if (segment.type === 'open') {
+            ctx.index++;
+            const block = parseBlock(ctx, segment);
+            if (block) {
+                blocks.push(block);
+            }
+            continue;
+        }
+        ctx.index++;
+    }
+    return { blocks, errors: ctx.errors };
+}
+/**
+ * Find all blocks of a specific type in parsed result
+ */
+export function findBlocks(blocks, name) {
+    const result = [];
+    for (const block of blocks) {
+        if (block.name === name) {
+            result.push(block);
+        }
+        result.push(...findBlocks(block.children, name));
+    }
+    return result;
+}
+/**
+ * Extract content between GitBook tags, returning both the content
+ * and remaining text
+ */
+export function extractBlocks(text) {
+    const textSegments = [];
+    const parseResult = parse(text);
+    // Collect text segments that are not part of any block
+    let lastBlockEnd = 0;
+    for (const block of parseResult.blocks) {
+        if (block.start > lastBlockEnd) {
+            const content = text.slice(lastBlockEnd, block.start);
+            if (content.trim()) {
+                textSegments.push({
+                    content,
+                    start: lastBlockEnd,
+                    end: block.start,
+                });
+            }
+        }
+        lastBlockEnd = block.end;
+    }
+    // Add trailing text
+    if (lastBlockEnd < text.length) {
+        const content = text.slice(lastBlockEnd);
+        if (content.trim()) {
+            textSegments.push({
+                content,
+                start: lastBlockEnd,
+                end: text.length,
+            });
+        }
+    }
+    return {
+        blocks: parseResult.blocks,
+        textSegments,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/lib/parser/parser.js.map

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

package/lib/parser/tokenizer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitBook tag tokenizer
+ * Tokenizes {% tag %} syntax into structured tokens
+ */
+export type TokenType = 'open' | 'close' | 'self-closing';
+export interface Token {
+    type: TokenType;
+    name: string;
+    attributes: Record<string, string>;
+    raw: string;
+    start: number;
+    end: number;
+}
+export interface TextSegment {
+    type: 'text';
+    content: string;
+    start: number;
+    end: number;
+}
+export type Segment = Token | TextSegment;
+/**
+ * Parse attributes string into key-value pairs
+ */
+export declare function parseAttributes(attrString: string): Record<string, string>;
+/**
+ * Tokenize text into segments (tokens and text)
+ */
+export declare function tokenize(text: string): Segment[];
+/**
+ * Check if a segment is a token (not text)
+ */
+export declare function isToken(segment: Segment): segment is Token;
+/**
+ * Check if a segment is a text segment
+ */
+export declare function isTextSegment(segment: Segment): segment is TextSegment;
+//# sourceMappingURL=tokenizer.d.ts.map

package/lib/parser/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/parser/tokenizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;AAE1D,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;AAc1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqC1E;AAoFD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CA8ChD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,KAAK,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CAEtE"}