Init by forking from en version

Author: zxch3n

.cursor/Dockerfile

@@ -0,0 +1,51 @@
+FROM ubuntu:22.04
+
+# Set non-interactive mode for apt
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    git \
+    build-essential \
+    pkg-config \
+    libssl-dev \
+    python3 \
+    unzip \
+    wget \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Node.js 20.x
+RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y nodejs \
+    && npm install -g npm
+
+# Install pnpm
+RUN npm install -g pnpm@8
+
+# Install Deno
+RUN curl -fsSL https://deno.land/x/install/install.sh | sh
+ENV PATH="/root/.deno/bin:${PATH}"
+
+# Install Rust and required components
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal --default-toolchain 1.83.0
+ENV PATH="/root/.cargo/bin:${PATH}"
+RUN rustup target add wasm32-unknown-unknown
+
+# Install wasm-pack
+RUN curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+
+# Install wasm-bindgen
+RUN cargo install wasm-bindgen-cli --version 0.2.100
+
+# Install wasm-opt
+RUN npm install -g wasm-opt
+
+# Install nextest
+RUN curl -LsSf https://get.nexte.st/latest/linux | tar zxf - -C ${CARGO_HOME:-~/.cargo}/bin
+
+# Set the working directory
+WORKDIR /workspace
+
+# Default command
+CMD ["/bin/bash"]

.cursor/environment.json

@@ -0,0 +1,7 @@
+{
+  "build": {
+    "dockerfile": "Dockerfile",
+    "context": "."
+  },
+  "terminals": []
+}

.github/workflows/deno_tests.yml

@@ -0,0 +1,34 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# This workflow will install Deno then run `deno lint` and `deno test`.
+# For more information see: https://github.com/denoland/setup-deno
+
+name: Deno Eval All Code Blocks
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Setup repo
+        uses: actions/checkout@v4
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v1
+        with:
+          deno-version: v2.x
+
+      - name: Run tests
+        run: cd deno_scripts && deno run -A run_code_blocks.ts ..

.gitignore

@@ -0,0 +1,4 @@
+.next
+node_modules
+.DS_Store
+.vercel

.npmrc

@@ -0,0 +1 @@
+enable-pre-post-scripts=true

.storybook/main.ts

@@ -0,0 +1,32 @@
+import type { StorybookConfig } from "@storybook/nextjs";
+const TsconfigPathsPlugin = require('tsconfig-paths-webpack-plugin');
+
+const config: StorybookConfig = {
+  stories: [
+    "../stories/**/*.mdx",
+    "../stories/**/*.stories.@(js|jsx|mjs|ts|tsx)",
+  ],
+  addons: [
+    "@storybook/addon-links",
+    "@storybook/addon-essentials",
+    "@storybook/addon-onboarding",
+    "@storybook/addon-interactions",
+  ],
+  framework: {
+    name: "@storybook/nextjs",
+    options: {},
+  },
+  docs: {
+    autodocs: "tag",
+  },
+  webpackFinal(config) {
+    config.experiments = { ...config.experiments, asyncWebAssembly: true };
+    if (!config.resolve) {
+      config.resolve = {}
+    }
+
+    config.resolve.plugins = [...(config.resolve?.plugins ?? []), new TsconfigPathsPlugin()];
+    return config;
+  },
+};
+export default config;

.storybook/preview.ts

@@ -0,0 +1,21 @@
+import type { Preview } from "@storybook/react";
+import '@fontsource/poppins/300.css';
+import '@fontsource/poppins/400.css';
+import '@fontsource/poppins/500.css';
+import '@fontsource/poppins/600.css';
+import '@fontsource/poppins/700.css';
+import '@fontsource/poppins/800.css';
+
+const preview: Preview = {
+  parameters: {
+    actions: { argTypesRegex: "^on[A-Z].*" },
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+    },
+  },
+};
+
+export default preview;

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "cSpell.words": [
+    "linebreaks"
+  ],
+  "deno.enable": false
+}

AGENTS.md

@@ -0,0 +1,40 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `pages/`: Next.js pages and MDX docs (Nextra). Route files use kebab-case.
+- `components/`: Reusable React components (PascalCase filenames).
+- `lib/`: Local utilities/helpers imported by pages/components.
+- `public/`: Static assets (images, favicons, robots, sitemap output).
+- `.storybook/`: Storybook configuration and stories in `stories/`.
+- `deno_scripts/`: Deno-based tooling and doc code-block tests.
+- `styles/` and `style.css`: Global styles and Tailwind setup.
+
+## Build, Test, and Development Commands
+- `pnpm install`: Install dependencies (pnpm is required).
+- `pnpm dev`: Run Next.js dev server.
+- `pnpm build`: Generate RSS then build Next.js (`gen-rss.js`, `next build`).
+- `pnpm start`: Serve the production build.
+- `pnpm test`: Execute Deno-powered code-block tests across docs.
+- `pnpm storybook` / `pnpm build-storybook`: Run/build Storybook.
+
+## Coding Style & Naming Conventions
+- Language: TypeScript + React (function components).
+- Indentation: 2 spaces; keep files focused and small.
+- Naming: PascalCase for components (`components/CodeBlock.tsx`), camelCase for vars, kebab-case routes (`pages/api/route-name.ts`).
+- Styling: TailwindCSS utilities; prefer composable classes over custom CSS.
+- Imports: Use module paths relative to file; docs code blocks may import from `loro-crdt` directly.
+
+## Testing Guidelines
+- Framework: Deno executes TS code blocks extracted from `.md|.mdx`.
+- Run: `pnpm test` (or `cd deno_scripts && deno run -A run_code_blocks.ts ..`).
+- Expectations: Use `expect` assertions where relevant in examples.
+- Authoring docs: Ensure code blocks are self-contained TS snippets; they should compile and run without external context.
+
+## Commit & Pull Request Guidelines
+- Commits: Follow Conventional Commits (e.g., `docs: ...`, `fix: ...`, `feat: ...`, `test: ...`, `ui: ...`).
+- PRs: Provide a clear summary, link related issues, include screenshots/gifs for UI/docs changes, and list test steps.
+- Checks: Run `pnpm build` and `pnpm test` locally before requesting review.
+
+## Security & Configuration Tips
+- Node: Use the version compatible with Next 14; install via nvm.
+- Secrets: Do not commit tokens or API keys; prefer env vars if needed.

README.md

@@ -0,0 +1,10 @@
+# Loro Docs
+
+The source code for https://loro.dev/
+
+# Development
+
+```bash
+pnpm install
+pnpm dev
+```