feat: refresh docs and lint config for v1.3

Author: alpha912

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.0
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+      - name: Lint
+        run: bun run lint
+      - name: Build
+        run: bun run build

app/docs/api-reference/page.tsx

@@ -41,12 +41,14 @@ npm install omniscript-parser
 // Parse OSF to AST
 const osfCode = \`
 @meta { title: "My Document"; }
-@doc { content: "# Hello World"; }
+@doc {
+  # Hello World
+}
 \`;
 
 const ast = parse(osfCode);
 console.log(ast);
-// Output: { version: "1.0", blocks: [...] }
+// Output: { blocks: [...] }
 
 // Serialize AST back to OSF
 const osfOutput = serialize(ast);
@@ -56,15 +58,15 @@ console.log(osfOutput);`}
             <h3 className="text-2xl font-bold mb-4">API</h3>
 
             <div className="mb-6 border-2 border-blue-500 p-6">
-              <h4 className="font-bold text-xl mb-3">parse(osfCode: string): OSFDocument</h4>
+              <h4 className="font-bold text-xl mb-3">parse(osfCode: string, options?: ParseOptions): OSFDocument</h4>
               <p className="text-gray-300 mb-4">
                 Parses OSF text into an Abstract Syntax Tree (AST).
               </p>
               <p className="text-sm text-gray-400">
-                <strong>Parameters:</strong> osfCode - String containing OSF content
+                <strong>Parameters:</strong> osfCode - String containing OSF content; options - Include resolution settings
               </p>
               <p className="text-sm text-gray-400">
-                <strong>Returns:</strong> OSFDocument object with version and blocks array
+                <strong>Returns:</strong> OSFDocument object with blocks array (and includes when present)
               </p>
               <p className="text-sm text-gray-400">
                 <strong>Throws:</strong> Error if syntax is invalid
@@ -89,26 +91,24 @@ console.log(osfOutput);`}
 {`interface OSFDocument {
   version?: string;
   blocks: OSFBlock[];
+  includes?: IncludeDirective[];
 }
 
-type OSFBlock = 
-  | MetaBlock 
-  | DocBlock 
-  | SlideBlock 
-  | SheetBlock 
-  | ChartBlock 
-  | DiagramBlock 
-  | OSFCodeBlock;
+type OSFValue = string | number | boolean | OSFValue[] | { [key: string]: OSFValue };
+
+type OSFBlock =
+  | MetaBlock
+  | DocBlock
+  | SlideBlock
+  | SheetBlock
+  | ChartBlock
+  | DiagramBlock
+  | OSFCodeBlock
+  | TableBlock;
 
 interface MetaBlock {
   type: 'meta';
-  title?: string;
-  author?: string;
-  date?: string;
-  version?: string;
-  theme?: string;
-  tags?: string[];
-  description?: string;
+  props: Record<string, OSFValue>;
 }
 
 interface ChartBlock {
@@ -117,6 +117,21 @@ interface ChartBlock {
   title: string;
   data: ChartDataSeries[];
   options?: ChartOptions;
+}
+
+interface TableBlock {
+  type: 'table';
+  caption?: string;
+  style?: 'bordered' | 'striped' | 'minimal';
+  alignment?: ('left' | 'center' | 'right')[];
+  headers: string[];
+  rows: { cells: { text: string }[] }[];
+}
+
+interface IncludeDirective {
+  type: 'include';
+  path: string;
+  resolved?: OSFDocument;
 }`}
             </pre>
           </section>
@@ -191,6 +206,8 @@ fs.writeFileSync('output.xlsx', result.buffer);`}
   orientation?: 'portrait' | 'landscape';
   fontSize?: number;
   fontFamily?: string;
+  timeoutMs?: number;       // PDF rendering timeout (ms)
+  puppeteerArgs?: string[]; // Custom Puppeteer launch args
 }`}
             </pre>
 

bun.lock

@@ -1,21 +1,24 @@
-import { FlatCompat } from "@eslint/eslintrc";
-import { dirname } from "node:path";
-import { fileURLToPath } from "node:url";
+// File: eslint.config.mjs
+// What: ESLint configuration for the OmniScript documentation site
+// Why: Enable non-interactive linting with Next.js + TypeScript rules
+// Related: package.json scripts, next.config.js
+import { FlatCompat } from '@eslint/eslintrc';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+const __dirname = dirname(fileURLToPath(import.meta.url));
 const compat = new FlatCompat({ baseDirectory: __dirname });
 
 const eslintConfig = [
-  ...compat.extends("next/core-web-vitals", "next/typescript"),
   {
-    ignores: [
-      "node_modules/**",
-      ".next/**",
-      "out/**",
-      "build/**",
-      "next-env.d.ts",
-    ],
+    ignores: ['node_modules/**', '.next/**', 'out/**', 'build/**', 'next-env.d.ts'],
+  },
+  ...compat.extends('next/core-web-vitals', 'next/typescript'),
+  {
+    files: ['**/*.d.ts'],
+    rules: {
+      '@typescript-eslint/triple-slash-reference': 'off',
+    },
   },
 ];
 

eslint.config.mjs

@@ -19,6 +19,7 @@
     "react-dom": "^19.2.3"
   },
   "devDependencies": {
+    "@eslint/eslintrc": "^3.3.0",
     "@types/node": "24.8.1",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.2",