@zvndev/darkmown 0.10.0 → 0.11.0

package/site/pages/store.skin

@@ -0,0 +1,70 @@
+tokens
+  ink #171717
+  paper #faf8f3
+  panel #ffffff
+  line #dedbd3
+  accent #16645a
+  warm #a83f2a
+  radius 8px
+
+page
+  margin 0
+  font ui-serif, Georgia, Cambria, serif
+  color $ink
+  bg $paper
+  line-height 1.7
+
+main
+  max-width 820px
+  margin 0 auto
+  padding 3rem 2rem 5rem
+
+h1
+  font-size 3rem
+  line-height 1
+
+h2
+  margin-top 2.4rem
+  border-top 1px solid $line
+  padding-top 1.2rem
+
+a
+  color $accent
+
+button
+  border 1px solid $ink
+  bg $ink
+  color white
+  padding .72rem 1rem
+  margin .3rem .5rem .3rem 0
+  radius $radius
+  font inherit
+  cursor pointer
+
+button:hover
+  bg $accent
+  border-color $accent
+
+input
+  padding .7rem .9rem
+  border 1px solid $line
+  radius $radius
+  font inherit
+  bg $panel
+  width 100%
+  max-width 360px
+  margin 1rem 0
+
+#shop
+  border 1px solid $line
+  bg $panel
+  padding .4rem 1.4rem 1.4rem
+  margin 1.5rem 0
+  radius $radius
+
+.line
+  border 1px solid $line
+  bg $paper
+  padding .55rem 1.1rem
+  margin .45rem 0
+  radius $radius

package/site/pages/store.wd

@@ -0,0 +1,53 @@
+---
+title: Global store
+---
+
+@include /nav.wd
+
+<main>
+
+# Global store
+
+`:store` is durable, page-global state. It persists to `localStorage` under the
+`wd:store:` prefix, rehydrates on load, and syncs across tabs through the
+`storage` event — no backend, no wiring. Add `ephemeral` to opt a store out of
+persistence entirely.
+
+::: section #shop
+:store cart = []
+
+## A durable cart
+
+This cart is a `:store`, so it survives a full reload and mirrors into every open
+tab. Add a couple of items, refresh the page, and the count holds.
+
+Cart: { cart.length }
+
+:button "Add to cart" -> cart append {"id": "sticker", "name": "Sticker", "price": 4}
+:button "Reset cart" -> cart reset
+
+@loop cart into line
+::: card .line
+{ line.name } — ${ line.price }
+:::
+@empty
+The cart is empty. Add something, then reload — it stays.
+@endloop
+
+`Reset cart` runs `-> cart reset`, which restores the **declared** seed (`[]`),
+not the last persisted value — and writes that seed back to storage.
+:::
+
+## An ephemeral draft
+
+`:store draft = "" ephemeral` is in-memory only. It is bound two-way to the
+input and echoed below, but nothing reaches `localStorage`, so a reload wipes it
+clean.
+
+:store draft = "" ephemeral
+
+:bind draft placeholder="Type a draft note…"
+
+Draft says: **{ draft }**
+
+</main>

package/src/builder.js

@@ -66,21 +66,26 @@ export function buildSite(cwd = process.cwd()) {
 }
 
 /**
- * Strip JSDoc `/** ... *\/` blocks from the runtime before it ships.
- * The source keeps full type annotations (for `checkJs` + `.d.ts`), but the
- * browser never needs to download them — this keeps the shipped runtime lean
- * and the gzip budget honest (measured against what users actually receive).
- * Only `/** ... *\/` blocks are removed; code and string literals are untouched.
+ * Strip developer comments from the runtime before it ships. The source keeps
+ * full JSDoc type annotations (for `checkJs` + `.d.ts`) and explanatory comments
+ * so it stays readable; the browser downloads neither. This keeps the shipped
+ * runtime lean and the gzip budget honest (measured against what users receive),
+ * WITHOUT minifying — identifiers, structure, and whitespace are all preserved.
+ *
+ * Two passes, each conservative: `/** ... *\/` JSDoc blocks, then whole-line
+ * `//` comments (a line that is nothing but a comment). Trailing `//` after code
+ * and `//` inside strings/URLs are deliberately left untouched, so no string
+ * literal is ever harmed.
  * @param {string} source
  * @returns {string}
  */
 export function stripRuntimeComments(source) {
   return source
-    // Remove the JSDoc block text only — never the surrounding newlines, so an
-    // inline `/** @type {x} */ code` keeps its line and never glues onto a
-    // preceding `//` comment.
+    // JSDoc blocks — type annotations the browser never needs.
     .replace(/\/\*\*[\s\S]*?\*\//g, "")
-    // Drop the now blank/whitespace-only lines the removed blocks leave behind.
+    // Whole-line `//` comments — developer notes that don't belong in the download.
+    .replace(/^[ \t]*\/\/.*$/gm, "")
+    // Drop the now blank/whitespace-only lines the removals leave behind.
     .replace(/^[ \t]*\n/gm, "");
 }