@jant/core 0.0.1

package/bin/jant.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+
+/**
+ * Jant CLI
+ *
+ * Commands:
+ *   swizzle <component> [--wrap|--eject]  - Override a theme component
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Available components that can be swizzled
+const SWIZZLABLE_COMPONENTS = {
+  PostCard: {
+    file: "PostCard.tsx",
+    props: "PostCardProps",
+  },
+  PostList: {
+    file: "PostList.tsx",
+    props: "PostListProps",
+  },
+  Pagination: {
+    file: "Pagination.tsx",
+    props: "PaginationProps",
+  },
+  EmptyState: {
+    file: "EmptyState.tsx",
+    props: "EmptyStateProps",
+  },
+  BaseLayout: {
+    file: "BaseLayout.tsx",
+    props: "BaseLayoutProps",
+    isLayout: true,
+  },
+};
+
+function showHelp() {
+  console.log(`
+Jant CLI
+
+Usage:
+  jant swizzle <component> [options]
+
+Commands:
+  swizzle <component>   Override a theme component
+
+Options:
+  --wrap     Create a wrapper around the original component (default)
+  --eject    Copy the full component source for complete customization
+  --list     List available components
+
+Examples:
+  jant swizzle PostCard           # Wrap PostCard component
+  jant swizzle PostCard --eject   # Copy PostCard source
+  jant swizzle --list             # List all swizzlable components
+`);
+}
+
+function listComponents() {
+  console.log("\nAvailable components to swizzle:\n");
+  for (const [name, info] of Object.entries(SWIZZLABLE_COMPONENTS)) {
+    const type = info.isLayout ? "[Layout]" : "[Component]";
+    console.log(`  ${name.padEnd(15)} ${type}`);
+  }
+  console.log("\nUsage: jant swizzle <component> [--wrap|--eject]\n");
+}
+
+function generateWrapperCode(componentName, info) {
+  const importPath = info.isLayout
+    ? "@jant/core/theme/layouts"
+    : "@jant/core/theme/components";
+
+  return `/**
+ * Custom ${componentName} component
+ *
+ * This is a wrapper around the original ${componentName}.
+ * You can customize the rendering while keeping the original functionality.
+ */
+
+import type { ${info.props} } from "@jant/core";
+import { ${componentName} as Original${componentName} } from "${importPath}";
+
+export function ${componentName}(props: ${info.props}) {
+  // Add your customizations here
+  return (
+    <div class="custom-${componentName.toLowerCase()}-wrapper">
+      <Original${componentName} {...props} />
+    </div>
+  );
+}
+`;
+}
+
+function swizzle(componentName, mode) {
+  const info = SWIZZLABLE_COMPONENTS[componentName];
+  if (!info) {
+    console.error(`Error: Unknown component "${componentName}"`);
+    console.log("\nAvailable components:");
+    listComponents();
+    process.exit(1);
+  }
+
+  const targetDir = info.isLayout
+    ? resolve(process.cwd(), "src/theme/layouts")
+    : resolve(process.cwd(), "src/theme/components");
+
+  const targetFile = resolve(targetDir, info.file);
+
+  // Check if file already exists
+  if (existsSync(targetFile)) {
+    console.error(`Error: ${targetFile} already exists`);
+    console.log("Remove it first if you want to re-swizzle.");
+    process.exit(1);
+  }
+
+  // Create directory if needed
+  mkdirSync(targetDir, { recursive: true });
+
+  if (mode === "eject") {
+    // For eject mode, we'd need to copy the actual source
+    // For now, show a message about where to find it
+    console.log(`
+To eject ${componentName}, copy the source from:
+  node_modules/@jant/core/src/theme/${info.isLayout ? "layouts" : "components"}/${info.file}
+
+Then modify it as needed.
+`);
+    return;
+  }
+
+  // Generate wrapper code
+  const code = generateWrapperCode(componentName, info);
+  writeFileSync(targetFile, code, "utf-8");
+
+  console.log(`
+✓ Created ${targetFile}
+
+Next steps:
+1. Customize the component in the generated file
+2. Import it in your src/index.ts:
+
+   import { ${componentName} } from "./theme/${info.isLayout ? "layouts" : "components"}/${componentName}";
+
+   export default createApp({
+     theme: {
+       components: {
+         ${componentName},
+       },
+     },
+   });
+`);
+}
+
+// Parse arguments
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+  showHelp();
+  process.exit(0);
+}
+
+const command = args[0];
+
+if (command === "swizzle") {
+  if (args.includes("--list")) {
+    listComponents();
+    process.exit(0);
+  }
+
+  const componentName = args[1];
+  if (!componentName) {
+    console.error("Error: Component name required");
+    console.log("Usage: jant swizzle <component> [--wrap|--eject]");
+    process.exit(1);
+  }
+
+  const mode = args.includes("--eject") ? "eject" : "wrap";
+  swizzle(componentName, mode);
+} else {
+  console.error(`Unknown command: ${command}`);
+  showHelp();
+  process.exit(1);
+}

package/drizzle.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from "drizzle-kit";
+
+export default defineConfig({
+  schema: "./src/db/schema.ts",
+  out: "./src/db/migrations",
+  dialect: "sqlite",
+  dbCredentials: {
+    url: ".wrangler/state/v3/d1/miniflare-D1DatabaseObject/local.sqlite",
+  },
+});

package/lingui.config.ts

@@ -0,0 +1,16 @@
+import type { LinguiConfig } from "@lingui/conf";
+
+const config: LinguiConfig = {
+  locales: ["en", "zh-Hans", "zh-Hant"],
+  sourceLocale: "en",
+  catalogs: [
+    {
+      path: "<rootDir>/src/i18n/locales/{locale}",
+      include: ["<rootDir>/src/**/*.{ts,tsx}"],
+    },
+  ],
+  format: "po",
+  compileNamespace: "ts",
+};
+
+export default config;

package/package.json

@@ -0,0 +1,116 @@
+{
+  "name": "@jant/core",
+  "version": "0.0.1",
+  "description": "A modern, open-source microblogging platform built on Cloudflare Workers",
+  "type": "module",
+  "bin": {
+    "jant": "./bin/jant.js"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./theme": "./src/theme/index.ts",
+    "./theme/*": "./src/theme/*",
+    "./src/*": "./src/*",
+    "./static/*": "./static/*"
+  },
+  "files": [
+    "bin",
+    "src",
+    "static",
+    "migrations",
+    "drizzle.config.ts",
+    "lingui.config.ts",
+    "postcss.config.js",
+    "tailwind.config.ts",
+    "tsconfig.json",
+    "vite.config.ts",
+    "wrangler.toml"
+  ],
+  "scripts": {
+    "dev": "pnpm db:migrate:local && vite dev",
+    "dev:debug": "pnpm db:migrate:local && vite dev --port 19019",
+    "build": "vite build",
+    "deploy": "pnpm build && wrangler deploy",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate:local": "wrangler d1 migrations apply DB --local",
+    "db:migrate:remote": "wrangler d1 migrations apply DB --remote",
+    "i18n:extract": "lingui extract",
+    "i18n:compile": "lingui compile --typescript",
+    "i18n:build": "pnpm i18n:extract && pnpm i18n:compile",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@lingui/core": "^5.9.0",
+    "better-auth": "^1.4.18",
+    "drizzle-orm": "^0.45.1",
+    "hono": "^4.11.7",
+    "marked": "^17.0.1",
+    "sqids": "^0.3.0",
+    "uuidv7": "^1.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.28.6",
+    "@babel/core": "^7.29.0",
+    "@babel/preset-typescript": "^7.28.5",
+    "@cloudflare/vite-plugin": "^1.22.1",
+    "@cloudflare/workers-types": "^4.20260131.0",
+    "@eslint/js": "^9.39.2",
+    "@lingui/babel-plugin-lingui-macro": "^5.9.0",
+    "@lingui/cli": "^5.9.0",
+    "@lingui/format-json": "^5.9.0",
+    "@lingui/format-po": "^5.9.0",
+    "@lingui/swc-plugin": "^5.10.1",
+    "@swc/core": "^1.15.11",
+    "@tailwindcss/cli": "^4.1.18",
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/node": "^25.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "autoprefixer": "^10.4.24",
+    "basecoat-css": "^0.3.10",
+    "drizzle-kit": "^0.31.8",
+    "esbuild-plugin-lingui-macro": "^1.0.1",
+    "eslint": "^9.39.2",
+    "eslint-plugin-react": "^7.37.5",
+    "glob": "^13.0.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "postcss": "^8.5.6",
+    "prettier": "^3.8.1",
+    "tailwindcss": "^4.1.18",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "unplugin-swc": "^1.5.9",
+    "vite": "^7.3.1",
+    "wrangler": "^4.61.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jant-me/jant.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "jant",
+    "microblog",
+    "cloudflare",
+    "workers",
+    "hono",
+    "d1",
+    "r2"
+  ],
+  "author": "Jant Contributors",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jant-me/jant/issues"
+  },
+  "homepage": "https://jant.me",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}