@netfoundry/docusaurus-theme 0.1.0 → 0.1.2

package/src/docusaurus-plugins/remarkYamlTable.ts

@@ -0,0 +1,83 @@
+import { Plugin } from 'unified'
+import { visit } from 'unist-util-visit'
+import yaml from 'js-yaml'
+import { Parent } from 'unist'
+import { Literal } from 'unist'
+import {Logger, LogLevel, resolveLogLevel} from './logger'
+
+console.log("🦖 remarkYamlTable plugin module loaded")
+
+interface Code extends Literal {
+    type: 'code'
+    lang?: string
+    value: string
+}
+
+interface TableCell {
+    type: 'tableCell'
+    children: { type: 'text'; value: string }[]
+}
+
+interface TableRow {
+    type: 'tableRow'
+    children: TableCell[]
+}
+
+interface Table {
+    type: 'table'
+    align: (null | 'left' | 'right' | 'center')[]
+    children: TableRow[]
+}
+
+interface Options {
+    logLevel?: LogLevel
+}
+
+export const remarkYamlTable: Plugin<[Options]> = (options?: Options) => {
+    const { logLevel = LogLevel.Silent } = options ?? {}
+    const logger = new Logger(resolveLogLevel(options?.logLevel), 'remarkYamlTable')
+
+    logger.log('initialized')
+
+    return (tree) => {
+        visit(tree, 'code', (node: Code, index: number | undefined, parent: Parent | undefined) => {
+            if (!parent || index === undefined) return
+            if (node.lang === 'yaml-table') {
+                try {
+                    const data = yaml.load(node.value)
+                    if (Array.isArray(data) && data.length > 0 && typeof data[0] === 'object') {
+                        const headers = Object.keys(data[0] as Record<string, unknown>)
+
+                        const tableRows: TableRow[] = (data as Record<string, unknown>[]).map((row) => ({
+                            type: 'tableRow',
+                            children: headers.map<TableCell>((header) => ({
+                                type: 'tableCell',
+                                children: [{ type: 'text', value: String(row[header] ?? '') }],
+                            })),
+                        }))
+
+                        const tableNode: Table = {
+                            type: 'table',
+                            align: headers.map(() => null),
+                            children: [
+                                {
+                                    type: 'tableRow',
+                                    children: headers.map<TableCell>((header) => ({
+                                        type: 'tableCell',
+                                        children: [{ type: 'text', value: header }],
+                                    })),
+                                },
+                                ...tableRows,
+                            ],
+                        }
+
+                        parent.children[index] = tableNode
+                        logger.log(`generated table with ${headers.length} columns and ${data.length} rows`, LogLevel.Info)
+                    }
+                } catch (error) {
+                    logger.log(`YAML parsing error: ${(error as Error).message}`, LogLevel.Info)
+                }
+            }
+        })
+    }
+}

package/src/docusaurus-plugins/remarkYouTube.ts

@@ -0,0 +1,56 @@
+import type { Plugin } from 'unified'
+import { visit } from 'unist-util-visit'
+import type { Node } from 'unist'
+import {Logger, LogLevel, resolveLogLevel} from './logger'
+
+console.log("🦖 remarkYouTube plugin module loaded")
+
+interface YouTubeOptions {
+    logLevel?: LogLevel
+}
+
+export const remarkYouTube: Plugin<[YouTubeOptions]> = (options?: YouTubeOptions) => {
+    const { logLevel = LogLevel.Silent } = options ?? {}
+    const logger = new Logger(resolveLogLevel(options?.logLevel), 'remarkYouTube')
+
+    logger.log('initialized')
+
+    return (tree: Node) => {
+        visit(tree, ['link', 'text'], (node: any, index: number | undefined, parent: any) => {
+            if (!parent || typeof index !== 'number') return
+            let raw = node.url || node.value || ''
+            let ytUrl = raw.trim()
+
+            const hashnodeMatch = ytUrl.match(/^%\[(.+)\]$/)
+            if (hashnodeMatch) {
+                ytUrl = hashnodeMatch[1]
+                logger.log(`hashnode-style embed detected: ${ytUrl}`, LogLevel.Info)
+            }
+
+            const m =
+                ytUrl.match(/youtube\.com\/watch\?v=([A-Za-z0-9_-]+)/) ||
+                ytUrl.match(/youtu\.be\/([A-Za-z0-9_-]+)/) ||
+                ytUrl.match(/youtube-nocookie\.com\/watch\?v=([A-Za-z0-9_-]+)/)
+
+            if (m) {
+                logger.log(`rewriting YouTube URL: ${ytUrl} → videoId=${m[1]}`, LogLevel.Debug)
+                parent.children.splice(index, 1, {
+                    type: 'mdxJsxFlowElement',
+                    name: 'LiteYouTubeEmbed',
+                    attributes: [
+                        { type: 'mdxJsxAttribute', name: 'id', value: m[1] },
+                        { type: 'mdxJsxAttribute', name: 'title', value: 'YouTube video' },
+                    ],
+                })
+            }
+        })
+
+        visit(tree, 'text', (node: any, index: number | undefined, parent: any) => {
+            if (!parent || typeof index !== 'number') return
+            if (node.value.trim() === '%[' || node.value.trim() === ']') {
+                logger.log(`stripping hashnode bracket artifact: ${node.value}`, LogLevel.Debug)
+                parent.children.splice(index, 1)
+            }
+        })
+    }
+}

package/src/docusaurus-plugins/timedPlugin.ts

@@ -0,0 +1,22 @@
+import { Plugin } from "unified"
+import {Logger, LogLevel, resolveLogLevel} from './logger'
+
+export function timedPlugin<T extends Plugin>(
+    name: string,
+    plugin: T,
+    opts: { logLevel?: LogLevel } = {}
+): T {
+    const { logLevel = LogLevel.Info } = opts
+    const logger = new Logger(resolveLogLevel(opts?.logLevel), name)
+
+    return ((...args: any[]) => {
+        const instance = (plugin as any)(...args)
+        return (tree: any, file: any) => {
+            const start = Date.now()
+            const res = instance(tree, file)
+            const dur = Date.now() - start
+            logger.log(`⏱ finished in ${dur}ms`)
+            return res
+        }
+    }) as any
+}

package/src/node.ts

@@ -0,0 +1,6 @@
+/**
+ * Node.js utilities entry point
+ *
+ * Import from '@netfoundry/docusaurus-theme/node' in Node.js contexts.
+ */
+export * from './docusaurus-envhelper';

package/src/plugins.ts

@@ -0,0 +1,6 @@
+/**
+ * Remark plugins entry point
+ *
+ * Import from '@netfoundry/docusaurus-theme/plugins' in docusaurus.config.ts.
+ */
+export * from './docusaurus-plugins';

package/src/ui.ts

@@ -0,0 +1,7 @@
+/**
+ * UI components entry point
+ *
+ * Import from '@netfoundry/docusaurus-theme/ui' in client code.
+ */
+export * from './components';
+export * from './docusaurus-envhelper';

package/src/version.ts

@@ -0,0 +1 @@
+export const version = '0.1.1';

package/theme/Layout/index.tsx

@@ -4,7 +4,7 @@ import {
   NetFoundryLayout,
   defaultNetFoundryFooterProps,
   defaultSocialProps,
-} from '@netfoundry/docusaurus-shared/ui';
+} from '../../src/ui';
 import type { ThemeConfigWithNetFoundry } from '../../src/options';
 
 export interface LayoutProps {