docs(v0.24.1): property docs for every component + Properties section in the site

A Slint maintainer reviewed v0.24 and flagged that no component exposed
property docs — a real gap. Fixed across the catalog in one pass.

- Add inline `//` doc comments above every in / in-out / out / callback in all
  43 components + 8 blocks. 181 inserted (20 already had docs from manual
  passes covering Button + the v0.24 menu family).
- scripts/build-docs.mjs: parseProps() extracts each declaration with its
  immediately-preceding doc-comment block; page() renders a Properties section
  (name + kind tag + Slint type + description) after Usage; TOC gains an entry
  when present.
- Single source of truth — docs live next to the .slint declaration, so the
  per-component Properties section can never drift from the component.

No behavior change in the registry components themselves; .slint comments are
no-ops. WASM bundle unchanged.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: stevekwon211

README.md

@@ -81,6 +81,7 @@ node /path/to/slintcn/bin/slintcn.mjs add button card input dialog
 | **v0.22.1** | **Responsive + polish** — mobile nav drawer for the docs, demo fills the window (no letterbox, no resize flicker), Popover/ContextMenu layout fix, Firefox first-click focus | ✅ |
 | **v0.23** | **Blocks expansion** — Team (members + roles), Profile (account form), Stats (metrics + traffic bars) → 8 blocks total | ✅ |
 | **v0.24** | **Menu family** — DropdownMenu (click), HoverCard (hover), Menubar (per-trigger popups), NavigationMenu (active-state nav) → 43 components | ✅ |
+| **v0.24.1** | **Property docs** — every `in` / `in-out` / `out` / callback has a one-line description; docs site surfaces them in a per-component Properties section | ✅ |
 | **v1.0** | Game HUD registry expansion — hotbar, reticle, full keycap hints | later |
 
 SaaS-first is a **wedge**, not a ceiling. Once tokens + motion + hover semantics

docs/ROADMAP.md

@@ -1,6 +1,21 @@
 # slintcn roadmap
 
-## Planned (v0.23+)
+## v0.24.1 — property docs (current)
+
+A Slint maintainer reviewed the v0.24 docs and pointed out that no component
+exposed property docs — a real gap. Fix it across the catalog in one pass.
+
+- [x] Inline `//` doc comment above every `in` / `in-out` / `out` property and
+      `callback` in all 43 components and 8 blocks (181 inserted; 20 already
+      had docs from manual passes).
+- [x] `scripts/build-docs.mjs` parses those comments via `propsOf(item)` and
+      renders a **Properties** section on each docs page — name, kind tag
+      (in / in-out / out / callback), Slint type, one-line description.
+- [x] TOC ("On this page") gains a Properties entry when the section is present.
+- [x] Single source of truth — docs live next to the `.slint` declaration; no
+      separate metadata file to drift.
+
+## Planned (v0.25+)
 
 The distribution system (CLI · registry · docs · adoption mode) is at parity
 with shadcn and ahead in places. The remaining gap is purely **component
@@ -70,7 +85,7 @@ heavy, separate R&D track; the Game/HUD layer is the long-term differentiator.
 
 ---
 
-## v0.24 — menu family (current)
+## v0.24 — menu family
 
 PopupWindow + the verified preferred-* exposure pattern (from Tooltip/Select/
 Popover/ContextMenu) reused for four new overlay/nav primitives:

examples/showcase/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "slintcn-showcase"
-version = "0.24.0"
+version = "0.24.1"
 edition = "2021"
 publish = false
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "slintcn",
-  "version": "0.24.0",
+  "version": "0.24.1",
   "description": "Beautiful copy-paste Slint components — shadcn for native UI",
   "keywords": [
     "slint",

registry/default/blocks/login.slint

@@ -7,9 +7,13 @@ import { Separator, SeparatorOrientation } from "../components/separator.slint";
 
 // Minimal centered login block — leaner than SignIn (no remember/forgot row).
 export component Login inherits Card {
+    // Two-way bound to the email field.
     in-out property <string> email;
+    // Two-way bound to the password field.
     in-out property <string> password;
+    // Fired on the primary action.
     callback submit();
+    // Fired on the SSO button.
     callback sso();
 
     width: 340px;

registry/default/blocks/pricing.slint

@@ -7,7 +7,9 @@ import { Separator, SeparatorOrientation } from "../components/separator.slint";
 // Three-tier pricing block. `chosen` (0..2) highlights a plan; `pick(int)`
 // fires on a CTA. Plan copy is inline — edit freely once installed.
 export component Pricing inherits Rectangle {
+    // Two-way; index of the highlighted tier.
     in-out property <int> chosen: 1;
+    // Fired when a tier's CTA is pressed; argument is the tier index.
     callback pick(int);
 
     background: transparent;

registry/default/blocks/profile.slint

@@ -11,10 +11,15 @@ import { Separator, SeparatorOrientation } from "../components/separator.slint";
 // Save / Cancel. Built from Card + Avatar + Input + Textarea + Button. Bind the
 // fields and handle `save()` / `cancel()`.
 export component Profile inherits Rectangle {
+    // Two-way bound to the name field.
     in-out property <string> display-name: "Sofia Davis";
+    // Two-way bound to the email field.
     in-out property <string> email: "sofia@acme.dev";
+    // Two-way bound to the bio textarea.
     in-out property <string> bio: "Product designer. Building tools for makers.";
+    // Fired on Save changes.
     callback save();
+    // Fired on Cancel.
     callback cancel();
 
     background: transparent;

registry/default/blocks/settings.slint

@@ -9,11 +9,17 @@ import { Button, ButtonVariant } from "../components/button.slint";
 // Settings panel block — Tabs over a Card body (Account / Notifications).
 // Self-contained tab state; bind the fields + handle `save()`.
 export component Settings inherits Rectangle {
+    // Two-way; active tab (0 = Account, 1 = Notifications).
     in-out property <int> tab: 0;
+    // Two-way bound to the name field.
     in-out property <string> display-name;
+    // Two-way bound to the email field.
     in-out property <string> email;
+    // Two-way; product-news email toggle.
     in-out property <bool> notify-product: true;
+    // Two-way; security-alert email toggle.
     in-out property <bool> notify-security: true;
+    // Fired on the Save button.
     callback save();
 
     background: transparent;

registry/default/blocks/sign-in.slint

@@ -8,11 +8,17 @@ import { Button, ButtonVariant } from "../components/button.slint";
 // Sign-in card block — Card + Label + Input + Checkbox + Button.
 // Bind email/password and handle the submit / forgot / create callbacks.
 export component SignIn inherits Card {
+    // Two-way bound to the email field.
     in-out property <string> email;
+    // Two-way bound to the password field.
     in-out property <string> password;
+    // Two-way 'remember me' checkbox state.
     in-out property <bool> remember: true;
+    // Fired on the submit button.
     callback submit();
+    // Fired on the 'forgot password' link.
     callback forgot();
+    // Fired on the 'create account' link.
     callback create-account();
 
     width: 380px;

registry/default/blocks/stats.slint

@@ -11,12 +11,14 @@ export struct StatMetric { label: string, value: string, delta: string, up: bool
 export struct TrafficSource { label: string, percent: float, value: string }
 
 export component Stats inherits Rectangle {
+    // Top-row metric cards.
     in property <[StatMetric]> metrics: [
         { label: "Revenue",      value: "$ 42,580", delta: "+12.4%", up: true },
         { label: "Subscriptions", value: "2,340",   delta: "+8.1%",  up: true },
         { label: "Active now",   value: "1,284",    delta: "+3.1%",  up: true },
         { label: "Churn",        value: "1.8%",     delta: "−0.4%",  up: false },
     ];
+    // Traffic-by-source bars under the metrics.
     in property <[TrafficSource]> sources: [
         { label: "Direct",   percent: 48, value: "12,480" },
         { label: "Organic",  percent: 31, value: "8,060"  },