feat: add @hikkaku/gobox (#142)

* feat(gobox): add runtime package, example, and publish flow

* fix

* Update packages/gobox/package.json

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix(gobox): add `files` field to package.json (#143)

* Initial plan

* fix(gobox): add "files" field to package.json for publish

Co-authored-by: nakasyou <79000684+nakasyou@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: nakasyou <79000684+nakasyou@users.noreply.github.com>

* returning

* fix

* fix

* fix

* aa

* fix

* fix

* fix

* fix

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>

Author: 3 people

.github/workflows/ci.yml

@@ -53,6 +53,7 @@ jobs:
           bun run --cwd packages/testing test -- --coverage
           bun run --cwd packages/hikkaku test -- --coverage
           bun run --cwd packages/moonscratch test -- --coverage
+          bun run --cwd packages/gobox test -- --coverage
 
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v5
@@ -64,4 +65,5 @@ jobs:
             packages/hikkaku/coverage/lcov.info
             packages/testing/coverage/lcov.info
             packages/moonscratch/coverage/lcov.info
+            packages/gobox/coverage/lcov.info
           fail_ci_if_error: false

.github/workflows/publish.yml

@@ -13,6 +13,7 @@ on:
           - vite-plugin-turbowarp-packager
           - moonscratch
           - testing
+          - gobox
       release_type:
         description: 'Version bump type'
         required: true
@@ -90,7 +91,7 @@ jobs:
           package="$PACKAGE_NAME"
           release_type="$INPUT_RELEASE_TYPE"
 
-          if ! [[ "$package" =~ ^(hikkaku|create-hikkaku|vite-plugin-turbowarp-packager|moonscratch|testing)$ ]]; then
+          if ! [[ "$package" =~ ^(hikkaku|create-hikkaku|vite-plugin-turbowarp-packager|moonscratch|testing|gobox)$ ]]; then
             echo "Unsupported package: $package"
             exit 1
           fi
@@ -114,6 +115,12 @@ jobs:
             exit 1
           fi
 
+          has_repository="$(node -e "const fs=require('fs');const pkg=JSON.parse(fs.readFileSync(process.argv[1],'utf8'));const repo=pkg.repository;const ok=(typeof repo==='string'&&repo.trim()!=='')||(repo&&typeof repo==='object'&&typeof repo.url==='string'&&repo.url.trim()!=='');process.stdout.write(ok?'yes':'no')" "$package_json_path")"
+          if [ "$has_repository" != "yes" ]; then
+            echo "package.json must contain a non-empty repository field: $package_json_path"
+            exit 1
+          fi
+
           if ! current_version="$(npm view "$package_name" version 2>/dev/null | tr -d '\r\n')"; then
             current_version="$(node -e "const fs=require('fs');const pkg=JSON.parse(fs.readFileSync(process.argv[1],'utf8'));process.stdout.write(typeof pkg.version==='string'?pkg.version.trim():'')" "$package_json_path")"
             if [ -z "$current_version" ]; then
@@ -199,6 +206,10 @@ jobs:
         if: steps.metadata.outputs.package == 'testing'
         run: bun run --cwd packages/testing build
 
+      - name: Build gobox
+        if: steps.metadata.outputs.package == 'gobox'
+        run: bun run --cwd packages/gobox build
+
       - name: Build gpts zip
         if: steps.metadata.outputs.package == 'hikkaku'
         run: bun run --filter gpts-zip build
@@ -223,6 +234,9 @@ jobs:
             testing)
               dir='packages/testing'
               ;;
+            gobox)
+              dir='packages/gobox'
+              ;;
             *)
               echo "Unsupported package: ${{ steps.metadata.outputs.package }}"
               exit 1

AGENTS.md

@@ -2,6 +2,7 @@
 
 ## Project Structure & Module Organization
 - `packages/hikkaku/` is the main library package. Source lives in `packages/hikkaku/src/` (e.g., `blocks/`, `core/`, `client/`, `vite/`, `utils/`).
+- `packages/gobox/` provides high-level typed value/signal/function abstractions on top of `hikkaku`.
 - `packages/skill/` contains skill docs and guides (`guides/`, `practices/`).
 - `packages/testing/` provides Vitest-oriented Hikkaku + MoonScratch test helpers.
 - `examples/example1/` is the dev playground app for running the library with Vite.

bun.lock

@@ -31,6 +31,14 @@
     },
     "status": "ok"
   },
+  {
+    "id": "gobox-counter",
+    "title": "Gobox Counter",
+    "path": "/showcase/gobox-counter.html",
+    "sourceUrl": "https://github.com/pnsk-lab/hikkaku/tree/main/examples/gobox-counter",
+    "status": "error",
+    "error": "ENOENT: no such file or directory, open '/home/nakasyou/hikkaku/hikkaku1/examples/gobox-counter/dist/project.sb3'"
+  },
   {
     "id": "json-parser",
     "title": "Json Parser",
@@ -83,8 +91,7 @@
     "title": "Simple",
     "path": "/showcase/simple.html",
     "sourceUrl": "https://github.com/pnsk-lab/hikkaku/tree/main/examples/simple",
-    "status": "error",
-    "error": "ENOENT: no such file or directory, open '/root/jet9/hikkaku/examples/simple/dist/project.sb3'"
+    "status": "ok"
   },
   {
     "id": "tesseract",

docs/public/showcase/manifest.json

@@ -16,7 +16,7 @@ Input: `times`, `handler`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `times: PrimitiveSource<number>` - number of iterations
+* `times: PrimitiveSource<HikkakuNumber>` - number of iterations
 * `handler: () => void` - body of the loop
 
 Example:
@@ -34,7 +34,7 @@ Input: `condition`, `handler`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `condition: PrimitiveSource<boolean>`
+* `condition: PrimitiveSource<HikkakuBool>`
 * `handler: () => void`
 
 Example:
@@ -52,7 +52,7 @@ Input: `condition`, `handler`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `condition: PrimitiveSource<boolean>`
+* `condition: PrimitiveSource<HikkakuBool>`
 * `handler: () => void`
 
 Example:
@@ -71,7 +71,7 @@ Input: `variable`, `value`, `handler`.
 Output: Scratch statement block definition that is appended to the current script stack.
 
 * `variable: VariableReference`
-* `value: PrimitiveSource<number>` - upper bound
+* `value: PrimitiveSource<HikkakuNumber>` - upper bound
 * `handler: () => void`
 
 Example:
@@ -106,7 +106,7 @@ Input: `seconds`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `seconds: PrimitiveSource<number>`
+* `seconds: PrimitiveSource<HikkakuNumber>`
 
 Example:
 ```ts
@@ -123,7 +123,7 @@ Input: `condition`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `condition: PrimitiveSource<boolean>`
+* `condition: PrimitiveSource<HikkakuBool>`
 
 Example:
 ```ts
@@ -140,7 +140,7 @@ Input: `condition`, `handler`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `condition: PrimitiveSource<boolean>`
+* `condition: PrimitiveSource<HikkakuBool>`
 * `handler: () => void`
 
 Example:
@@ -158,7 +158,7 @@ Input: `condition`, `thenHandler`, `elseHandler`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `condition: PrimitiveSource<boolean>`
+* `condition: PrimitiveSource<HikkakuBool>`
 * `thenHandler: () => void`
 * `elseHandler: () => void`
 
@@ -226,7 +226,7 @@ Input: `target`.
 
 Output: Scratch statement block definition that is appended to the current script stack.
 
-* `target: PrimitiveSource<string>` - string
+* `target: PrimitiveSource<HikkakuString>` - string
 
 Example:
 ```ts

docs/reference/blocks/control.md

@@ -34,7 +34,7 @@ Input: `variable`, `value`.
 Output: Scratch statement block definition that is appended to the current script stack.
 
 * `variable: VariableReference`
-* `value: PrimitiveSource<number | string>`
+* `value: PrimitiveSource<HikkakuNumber | HikkakuString>`
 
 Example:
 ```ts
@@ -52,7 +52,7 @@ Input: `variable`, `value`.
 Output: Scratch statement block definition that is appended to the current script stack.
 
 * `variable: VariableReference`
-* `value: PrimitiveSource<number>`
+* `value: PrimitiveSource<HikkakuNumber>`
 
 Example:
 ```ts
@@ -121,7 +121,7 @@ Input: `list`, `item`.
 Output: Scratch statement block definition that is appended to the current script stack.
 
 * `list: ListReference`
-* `item: PrimitiveSource<string | number>`
+* `item: PrimitiveSource<HikkakuString | HikkakuNumber>`
 
 Example:
 ```ts
@@ -139,7 +139,7 @@ Input: `list`, `index`.
 Output: Scratch statement block definition that is appended to the current script stack.
 
 * `list: Input value used by this block`
-* `index: ListIndex` - PrimitiveSource<number | string>
+* `index: ListIndex` - PrimitiveSource<HikkakuNumber | HikkakuString>
 
 Example:
 ```ts

docs/reference/blocks/data.md

@@ -117,7 +117,7 @@ isProcedureArgument: true,
 name: 'value',
 type: 'stringOrNumber',
 id: 'var-id',
-getter: () => valueBlock('argument_reporter_string_number', { fields: { VALUE: ['value', null] } }),
+getter: () => valueBlock<HikkakuString | HikkakuNumber>('argument_reporter_string_number', { fields: { VALUE: ['value', null] } }),
 })
 ```
 
@@ -138,6 +138,6 @@ isProcedureArgument: true,
 name: 'flag',
 type: 'boolean',
 id: 'flag-id',
-getter: () => valueBlock('argument_reporter_boolean', { fields: { VALUE: ['flag', null] } }),
+getter: () => valueBlock<HikkakuBool>('argument_reporter_boolean', { fields: { VALUE: ['flag', null] } }),
 })
 ```