René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Feature]: Promote `storybook` to Stable — settle the helper surface","articleBody":"**Pre-flight checklist**\n- [x] I searched existing issues and did not find a duplicate request.\n- [x] I explained the problem or use case, not just the desired API.\n\n**Problem or use case**\n`storybook` is **Beta** (it's not in the issue form's area dropdown, so this is filed under \"other\"). It's a helper-only entry point — `storyHtml`, `when`, plus the 1.14.0 additions `classMap`, `styleMap`, `ifDefined`, `repeat`, and `unsafeHtml` — and those template helpers are one minor old. Teams writing stories against these helpers need a frozen surface, and `unsafeHtml` in particular needs its security contract pinned down given bQuery's secure-by-default stance.\n\n**Proposed solution**\nFreeze the `storybook` helper API for one cycle, document each helper (especially the safety boundary of `unsafeHtml` and how it interacts with the security module's sanitizer), and add coverage for the template helpers' output. Exit criteria: frozen surface, documented helpers with `unsafeHtml` security guidance, tested rendering output.\n\n**Possible API or UX shape**\n```ts\nimport { storyHtml, classMap, ifDefined, repeat } from \"@bquery/bquery/storybook\";\n\nexport const Default = storyHtml`\n  \u003cmy-card class=${classMap({ active: true })} title=${ifDefined(title)}\u003e\n    ${repeat(items, i =\u003e i.id, i =\u003e storyHtml`\u003cli\u003e${i.label}\u003c/li\u003e`)}\n  \u003c/my-card\u003e\n`;\n```\n\n**Alternatives considered**\nLeaving it Beta as a \"minor helper module\" — but it's part of the stated road-to-stable for all modules, and its `unsafeHtml` helper has a security dimension that warrants a pinned contract. Folding it into `testing` — different purpose (authoring stories vs. assertions), so keep it separate.\n\n**Relevant area**\n`other`\n\n**Additional context**\nFiled as `other` because `storybook` is absent from the area dropdown — flag to maintainers whether the dropdown should add a `storybook` option. The `unsafeHtml` boundary should be defined in terms of the existing security/sanitizer module.\n","author":{"url":"https://github.com/JosunLP","@type":"Person","name":"JosunLP"},"datePublished":"2026-06-26T21:25:56.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/148/bQuery/issues/148"}