create-hozu 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-hozu",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Create a Hozu app, set up for Claude Code or for agents that read AGENTS.md",
   "keywords": [
     "hozu",

package/skill/SKILL.md

@@ -34,9 +34,10 @@ npx hozu add feature items --page / --with auth,detail,toggle,filter,remove
 npx hozu map                        # outline with file:line
 npx hozu get / --select button --forms          # a page, no server needed
 npx hozu post / --field title=A --next /        # a no-JS form post, cookies shown
+npx hozu browse / --do 'fill Search=a' --do 'click Save'   # real browser: errors, widgets, text
 npx hozu docs views                 # one topic
 ```
-`get` / `post` replace a running server for checks; `npm start` runs the app. Relative imports end in `.ts`.
+`get` / `post` / `browse` replace a running server for checks; `npm start` runs the app. Relative imports end in `.ts`.
 
 ## A feature in one screen
 ```ts

package/skill/topics/data.md

@@ -15,7 +15,7 @@ export const addItem = mutation({
   errors: { Duplicate: z.object({ title: z.string() }) },          // optional: declared failures
   invalidates: () => [itemsTag()],                                  // refreshes queries with these tags
 })
-export const visible = fn({                   // computation: pure JS, self-contained (no imports, no closures)
+export const visible = fn({                   // computation: pure JS, self-contained (no imports, no helpers outside impl: HZ047)
   input: z.object({ items: z.array(Item), show: Show }), output: z.array(Item),
   impl: ({ items, show }) => items.filter((i) => show === 'all' || !i.done),
 })

package/skill/topics/diagnostics.md

@@ -39,4 +39,5 @@ around the rule.
 | HZ044 | a feature file was loaded without the Hozu transform | run node with `--import @hozu/transform/register` (`npm start` does), or add `hozuTransform()` to Vite / Vitest |
 | HZ045 | `serve.ts` misses the widget bundle or the session store | add `widgets: await bundleWidgets(build)` / `session: sessionCookie(…)` |
 | HZ046 | an endpoint path is reserved, has params, or collides with a page, redirect or endpoint | use a static path such as `/api/…` (patch) |
+| HZ047 | a `fn` body uses a helper or constant defined outside `impl` (it is sent to the browser as source) | write the helper inside `impl`, or pass the value as input |
 | HZ042 | `site.locales` empty / missing `site.lang` / not a canonical tag, or `ui.alternate` of an undeclared locale | fix the list (`'zh-TW'`, not `'zh_tw'`) |

package/skill/topics/testing.md

@@ -6,6 +6,15 @@
   - Each step prints its status, redirect and `set-cookie` attributes (`HttpOnly`, `SameSite`); the session cookie
     is kept across `--next` steps. Two users: run two commands.
   - Endpoints: `hozu get '/api/items?x=1'`.
+- **In a real browser, still without a server:** `hozu browse / --do 'fill Search=park' --do 'click Tech Park'`.
+  - It uses the installed Chrome / Chromium / Edge (`HOZU_CHROME=/path` to choose), loads the page, waits for
+    hydration and runs the steps in order: `fill <label>=<value>`, `select <label>=<option>`, `check <label>`,
+    `click <name>`, `press <key>`, `wait <ms>`, `goto <path>`. Labels and names are what a user reads (aria-label,
+    `<label>`, placeholder, button text, `title`).
+  - It prints the uncaught exceptions, `console.error`s and failed requests, every widget on the page (mounted,
+    failed, size, canvases), the visible text and `--select <css>` elements; exit code 1 when anything failed.
+  - `--screenshot shot.png` saves the viewport (open it to look); `--reduced-motion` emulates reduced motion.
+  - Use it once after client-side work (widgets, islands); `get` / `post` stay the fast checks.
 - In code: `const app = testApp({ build, resolvers })` from `@hozu/testing`; `await app.get('/')` →
   `{ status, headers, html, text, payload }`; `app.post(path, fields)` submits a native form.
 - Vitest: add `hozuTransform()` from `@hozu/transform/vite` to `plugins`.

package/skill/topics/widgets.md

@@ -23,3 +23,6 @@ export default implement<typeof Map>(({ el, props, emit, signal }) => {
 - `serve.ts` passes `widgets: await bundleWidgets(build)` (the server refuses to start without it; `hozu build` bundles
   them itself). A library's CSS goes in `app.css` (`@import "leaflet/dist/leaflet.css";`); a map or chart host needs a
   height class.
+- Check it with `hozu browse /` (no server): each widget is listed as mounted / failed / not mounted with its size
+  and canvases, next to any error it threw. A mounted host carries `data-hozu-widget="<feature>.<Name>"` and
+  `data-hozu-widget-state="mounted"` for your own browser tests.

package/templates/guide.md

@@ -16,6 +16,7 @@ __RUN__ hozu check                         # after every change: types, rules, c
 __RUN__ hozu check --update-lock           # only to accept a clean, intended behaviour change
 __RUN__ hozu get / --select button --forms  # try pages without a server: text, attributes, forms
 __RUN__ hozu post / --field title=Ship --next /   # submit a form like a browser
+__RUN__ hozu browse / --do 'click Save'     # real browser, no server: errors, widgets, text after steps
 ```
 __NOTE__
 ## Rules