Merge branch 'main' of github.com:pnsk-lab/hikkaku

Author: nakasyou

bun.lock

@@ -19,7 +19,7 @@
     "@egoist/tailwindcss-icons": "^1.9.0",
     "@iconify-json/tabler": "^1.2.26",
     "@tailwindcss/vite": "^4.1.7",
-    "@types/bun": "latest",
+    "@types/bun": "1.3.10",
     "@typescript/native-preview": "^7.0.0-dev.20260210.1",
     "monaco-editor": "^0.55.1",
     "oxc-minify": "^0.112.0",

docs/package.json

@@ -1,3 +1,4 @@
+import { spawn } from 'node:child_process'
 import {
   access,
   mkdir,
@@ -42,6 +43,28 @@ const pathExists = async (targetPath: string) => {
   }
 }
 
+const runExampleBuild = (projectDir: string, exampleId: string) =>
+  new Promise<void>((resolve, reject) => {
+    const child = spawn('bun', ['run', 'example:build'], {
+      cwd: projectDir,
+      stdio: 'inherit',
+      env: process.env,
+    })
+
+    child.on('error', reject)
+    child.on('exit', (code) => {
+      if (code === 0) {
+        resolve()
+        return
+      }
+      reject(
+        new Error(
+          `Failed to build ${exampleId} example (exit code: ${code ?? 'unknown'}).`,
+        ),
+      )
+    })
+  })
+
 const toTitle = (id: string) =>
   id
     .split('-')
@@ -215,6 +238,43 @@ const collectExampleIds = async () => {
   return exampleIds.sort()
 }
 
+const ensureSb3Artifacts = async (exampleIds: string[]) => {
+  const missingArtifacts = await Promise.all(
+    exampleIds.map(async (exampleId) => {
+      const projectDir = path.join(examplesDir, exampleId)
+      const sb3Path = path.join(projectDir, 'dist', 'project.sb3')
+      return (await pathExists(sb3Path))
+        ? null
+        : {
+            exampleId,
+            projectDir,
+            sb3Path,
+          }
+    }),
+  )
+
+  const missing = missingArtifacts.filter((item) => item !== null)
+  if (missing.length === 0) {
+    return
+  }
+
+  console.warn(
+    `[showcase] ${missing.length} example build artifact(s) are missing. Rebuilding examples before packaging.`,
+  )
+
+  for (const item of missing) {
+    console.log(
+      `[showcase] rebuilding ${item.exampleId} to generate project.sb3`,
+    )
+    await runExampleBuild(item.projectDir, item.exampleId)
+    if (!(await pathExists(item.sb3Path))) {
+      throw new Error(
+        `Failed to find ${item.sb3Path} after rebuilding ${item.exampleId}.`,
+      )
+    }
+  }
+}
+
 const main = async () => {
   const exampleIds = await collectExampleIds()
   if (exampleIds.length === 0) {
@@ -234,6 +294,8 @@ const main = async () => {
     console.warn(
       '[showcase] scratch asset host is unreachable. Generating fallback pages instead of packaged HTML.',
     )
+  } else {
+    await ensureSb3Artifacts(exampleIds)
   }
 
   const buildJobs = exampleIds.map(async (exampleId) => {

docs/scripts/build-showcase.ts

@@ -0,0 +1 @@
+../../../../packages/skill/hikkaku

examples/bigint/.agents/skills/hikkaku

@@ -0,0 +1,3 @@
+* `src/main.ts`: The main entry point of the application.
+
+* use `bun typecheck` to run type checking.

examples/bigint/AGENTS.md

@@ -0,0 +1,25 @@
+{
+  "name": "@repo/example-bigint",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "bun run example:build",
+    "typecheck": "tsgo",
+    "example:build": "bun --bun vite build"
+  },
+  "dependencies": {
+    "hikkaku": "workspace:*"
+  },
+  "devDependencies": {
+    "@typescript/native-preview": "^7.0.0-dev.20260127.1",
+    "vite": "8.0.0-beta.14"
+  },
+  "exports": {
+    ".": "./src/main.ts"
+  },
+  "author": {
+    "name": "Kingping",
+    "url": "https://scratch.mit.edu/users/Kangping/"
+  }
+}