tinymoon 0.2.0__tar.gz → 0.3.0__tar.gz

{tinymoon-0.2.0/.rlsbl/bases → tinymoon-0.3.0}/.github/workflows/publish.yml

@@ -184,9 +184,19 @@ jobs:
       - name: Scan source for secrets
         run: |
           gitleaks dir .
-      - uses: goreleaser/goreleaser-action@v7
-        with:
-          version: ~> v2
-          args: release --clean
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      # tinymoon's Go module is a library (embed.FS + http.Handler) -- there
+      # is no main package, so goreleaser has nothing to build. For a Go
+      # library the pushed tag IS the publish: the module proxy serves it
+      # straight from git. This step primes proxy.golang.org and hard-fails
+      # if the tagged version does not resolve. Like the gate job, it assumes
+      # the run is at the tag ref (release trigger or dispatch at the tag).
+      - name: Verify module on the Go proxy
+        run: |
+          set -euo pipefail
+          mod="$(go list -m)"
+          ver="$GITHUB_REF_NAME"
+          dir="$(mktemp -d)"
+          cd "$dir"
+          go mod init proxyprime
+          GOPROXY=https://proxy.golang.org go mod download "${mod}@${ver}"
+          echo "Go proxy serves ${mod}@${ver}"

tinymoon-0.3.0/.rlsbl/changes/0.3.0.jsonl

@@ -0,0 +1,2 @@
+{"id":"18c1d65de3b9d2de86a890bcf7074862b328946e3385930b","commits":["c6a33774c6adba04fc032378956edf906b18c20d"],"user_facing":false}
+{"id":"18c1e67b4ce0af025424ac641be147a984cd844ae78a2fd3","commits":["acaf60b814a213bd132770c2143b33919740f9b0","e4dc2294b4194c08ee5dc8da7d1b2a7351dc1900","fecd63801e77e57eae3cb6b2aea82d797fd7f351"],"user_facing":true,"description":"mountShell gains an onRoute(routeKey, sub) callback and a refreshCurrent() helper; toast errors can be mirrored via setToastErrorHook().","type":"feature"}

tinymoon-0.3.0/.rlsbl/changes/0.3.0.md

@@ -0,0 +1,7 @@
+## 0.3.0
+
+Shell routing hooks (onRoute, refreshCurrent) and a toast error hook for log mirroring.
+
+### Features
+
+- mountShell gains an onRoute(routeKey, sub) callback and a refreshCurrent() helper; toast errors can be mirrored via setToastErrorHook().

tinymoon-0.3.0/.rlsbl/releases/v0.3.0.toml

@@ -0,0 +1,12 @@
+# Version bump type: patch, minor, major, hotfix, or prerelease
+bump = "minor"
+# Short description of this release (required)
+description = "Shell routing hooks (onRoute, refreshCurrent) and a toast error hook for log mirroring."
+# Optional context explaining why these changes were made
+context = ""
+# Pre-release identifier: alpha, beta, rc, or stable
+# preid = ""
+# Set to true to generate a blog post for this release
+# blog = false
+include = ["npm", "pypi", "go"]
+exclude = []

{tinymoon-0.2.0 → tinymoon-0.3.0}/.strictcli/schema.json

@@ -48,7 +48,7 @@
   },
   "project_id": "tinymoon",
   "name": "tinymoon",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "help": "Tooling for the tinymoon web framework. Ships the conformance checker that enforces the framework's non-negotiables (no external URLs, no native browser controls, no title= attributes, no rounded corners, no off-token colors) as hard errors.",
   "commands": {
     "check": {

{tinymoon-0.2.0 → tinymoon-0.3.0}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 # Changelog
 
+## 0.3.0
+
+Shell routing hooks (onRoute, refreshCurrent) and a toast error hook for log mirroring.
+
+### Features
+
+- mountShell gains an onRoute(routeKey, sub) callback and a refreshCurrent() helper; toast errors can be mirrored via setToastErrorHook().
+
 ## 0.2.0
 
 The framework lands: design tokens, base styles, app shell, and UI primitives as zero-build vanilla CSS and ES modules; embeddable Go module; conformance checker CLI.

{tinymoon-0.2.0 → tinymoon-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinymoon
-Version: 0.2.0
+Version: 0.3.0
 Summary: Zero-dependency vanilla JS/CSS UI framework (placeholder release)
 Project-URL: Homepage, https://github.com/smm-h/tinymoon
 Project-URL: Repository, https://github.com/smm-h/tinymoon
@@ -52,7 +52,9 @@ const shell = mountShell({
 });
 ```
 
-Consumer apps can extend the built-in icon set with `registerIcons({name: svgString})` — colliding with an existing icon name is a hard error, never a silent overwrite.
+`mountShell` also accepts an optional `onRoute(routeKey, sub)` callback fired after every route is handled (including the initial one), and the returned shell exposes `refreshCurrent()` to re-run the current view's `refresh()` in place.
+
+Consumer apps can extend the built-in icon set with `registerIcons({name: svgString})` — colliding with an existing icon name is a hard error, never a silent overwrite. Error toasts can be mirrored into a log with `setToastErrorHook(fn)` — the hook receives each error toast's message, and registering a second hook is a hard error.
 
 Views are plain objects following the contract `{root, built, build(), refresh(), setSub?}` — the [gallery](gallery/) is a complete working app and documents every token, primitive, and extension point (serve the repo root with a static server and open `/gallery/`).
 

{tinymoon-0.2.0 → tinymoon-0.3.0}/README.md

@@ -31,7 +31,9 @@ const shell = mountShell({
 });
 ```
 
-Consumer apps can extend the built-in icon set with `registerIcons({name: svgString})` — colliding with an existing icon name is a hard error, never a silent overwrite.
+`mountShell` also accepts an optional `onRoute(routeKey, sub)` callback fired after every route is handled (including the initial one), and the returned shell exposes `refreshCurrent()` to re-run the current view's `refresh()` in place.
+
+Consumer apps can extend the built-in icon set with `registerIcons({name: svgString})` — colliding with an existing icon name is a hard error, never a silent overwrite. Error toasts can be mirrored into a log with `setToastErrorHook(fn)` — the hook receives each error toast's message, and registering a second hook is a hard error.
 
 Views are plain objects following the contract `{root, built, build(), refresh(), setSub?}` — the [gallery](gallery/) is a complete working app and documents every token, primitive, and extension point (serve the repo root with a static server and open `/gallery/`).
 

tinymoon-0.3.0/VERSION

@@ -0,0 +1 @@
+0.3.0

{tinymoon-0.2.0 → tinymoon-0.3.0}/assets/js/index.js

@@ -7,7 +7,7 @@ export { api, post } from "./net.js";
 export { fmtTime } from "./format.js";
 export { renderMiniMd } from "./markdown.js";
 export { ensureTooltip, hideTip } from "./tooltip.js";
-export { toast } from "./toast.js";
+export { toast, setToastErrorHook } from "./toast.js";
 export { openModal } from "./modal.js";
 export { Select } from "./select.js";
 export { registerCtx, registerCtxFooter, showCtxMenu, hideCtxMenu } from "./ctxmenu.js";

{tinymoon-0.2.0 → tinymoon-0.3.0}/assets/js/shell.js

@@ -1,7 +1,8 @@
 // tinymoon — app shell: builds the sidebar/nav/topbar/content frame, mounts
 // the framework overlay roots, and runs the hash router.
 //
-// mountShell(config) → {navigate(route), setBusy(msg), setTitle(title, sub)}
+// mountShell(config) → {navigate(route), setBusy(msg), setTitle(title, sub),
+// refreshCurrent()}
 //
 // config (required unless marked optional):
 //   root           — container element the shell frame is appended to
@@ -18,6 +19,11 @@
 //                    into #tm-topbar-actions
 //   footer?        — {height, node}: sets --footer-h and appends node to
 //                    the body. Without it --footer-h stays 0.
+//   onRoute?       — fn(routeKey, sub): called after the router finishes
+//                    handling a route (view built, setSub applied, refresh
+//                    run, title set), including the initial route during
+//                    mount. routeKey is the resolved route key (post
+//                    legacy-redirect); sub is the deep-link tail or null.
 //
 // View contract: {root, built, build(), refresh(), setSub?(sub)}. The router
 // creates each view's section element (section.view) inside #tm-content and
@@ -43,7 +49,7 @@ function ensureRoot(id) {
 }
 
 export function mountShell(config) {
-  const { root, brand, routes, defaultRoute, legacyRoutes, topbarActions, footer } = config || {};
+  const { root, brand, routes, defaultRoute, legacyRoutes, topbarActions, footer, onRoute } = config || {};
   need(root && root.appendChild, "root element is required");
   need(brand && brand.name && brand.logoHTML, "brand {name, logoHTML} is required");
   need(routes && Object.keys(routes).length, "routes is required");
@@ -183,6 +189,8 @@ export function mountShell(config) {
       content.scrollTop = 0;
     }
     view.refresh();
+    // Last, so routing state is fully consistent when the hook observes it.
+    if (onRoute) onRoute(name, sub || null);
   }
 
   window.addEventListener("hashchange", route);
@@ -192,5 +200,12 @@ export function mountShell(config) {
     navigate(r) { location.hash = "#/" + r; },
     setBusy,
     setTitle,
+    // Re-run the current view's refresh() in place: no rebuild, no entry
+    // animation. No-op before the first route or if the view isn't built.
+    refreshCurrent() {
+      if (!currentRoute) return;
+      const view = routes[currentRoute].view();
+      if (view.built) view.refresh();
+    },
   };
 }

{tinymoon-0.2.0 → tinymoon-0.3.0}/assets/js/toast.js

@@ -14,6 +14,16 @@ function toastRoot() {
   return root;
 }
 
+let errorHook = null;
+
+// setToastErrorHook(fn): register a module-level hook invoked as fn(message)
+// whenever an error toast is shown — e.g. to mirror errors into a log.
+// Registering a second hook is a hard error, never a silent overwrite.
+export function setToastErrorHook(fn) {
+  if (errorHook) throw new Error("setToastErrorHook: a hook is already registered");
+  errorHook = fn;
+}
+
 // toast(msg, kind, opts): kind "err" turns the toast red and keeps it on
 // screen longer. opts.duration (ms) overrides the lifetime. Every toast
 // carries a copy icon for its message text. The mount point is created
@@ -31,4 +41,7 @@ export function toast(msg, kind, opts) {
     // must stay shorter than this removal delay.
     setTimeout(() => t.remove(), 200);
   }, life);
+  // After the toast is on screen (and its removal is scheduled, so a
+  // throwing hook can't strand it). Hook exceptions propagate.
+  if (kind === "err" && errorHook) errorHook(msg);
 }

{tinymoon-0.2.0 → tinymoon-0.3.0}/gallery/gallery.js

@@ -8,7 +8,7 @@
 
 import {
   $$, el, icon,
-  toast, openModal, Select, openPopover,
+  toast, setToastErrorHook, openModal, Select, openPopover,
   registerCtx, registerCtxFooter,
   toggleWidget, segmented, copyButton, kebabButton,
   createSettings, cssVar,
@@ -448,6 +448,10 @@ registerCtxFooter(() => [
   { label: "Toggle theme", icon: "sun", action: () => settings.set("theme", settings.get("theme") === "dark" ? "light" : "dark") },
 ]);
 
+// toast error hook (extension point): mirror error toasts into the console
+// log — visible when pressing "Error toast" on the Widgets page.
+setToastErrorHook((msg) => console.error("[gallery] error toast: " + msg));
+
 // verbose demo setting: narrate setting changes
 window.addEventListener("tm:setting", (e) => {
   if (settings.get("verbose") || e.detail.key === "verbose") {
@@ -487,11 +491,13 @@ Consumer apps extend tinymoon through explicit seams, never by patching internal
 
 - **Routes** — \`mountShell({routes})\`: each key maps to a title, an icon, and a view factory. \`hidden: true\` keeps a route out of the sidebar but routable.
 - **Legacy routes** — \`legacyRoutes: {old: "new"}\` redirects stale bookmarks, tails included.
+- **Route hook** — \`onRoute: (routeKey, sub) => …\` fires after the router finishes handling a route (view built, \`setSub\` applied, \`refresh()\` run, title set), including the initial route; \`routeKey\` is the resolved key after legacy redirects and \`sub\` is the deep-link tail or \`null\`. The shell object returned by \`mountShell\` also exposes \`refreshCurrent()\`, which re-runs the current view's \`refresh()\` in place — no rebuild, no entry animation.
 - **Topbar actions** — \`topbarActions\`: prebuilt nodes or \`{icon, tip, onClick}\` specs rendered right of the busy indicator.
 - **Footer slot** — \`footer: {height, node}\` pins an app-owned bar to the bottom; the shell sets \`--footer-h\` so the frame, toasts, tooltips, selects, and popovers all clear it.
 - **Context menus** — \`registerCtx(key, provider)\` serves right-clicks on \`[data-ctx]\` regions; \`registerCtxFooter(fn)\` appends app-global items to every menu.
 - **Settings schema** — \`createSettings({storageKey, defaults})\`: the defaults object is the schema; unknown keys are hard errors.
 - **Icons** — \`registerIcons({name: svgString})\` merges consumer icons into the built-in set; a name collision with an existing icon is a hard error, never a silent overwrite.
+- **Toast error hook** — \`setToastErrorHook(fn)\` mirrors every error toast's message into your hook (e.g. a log); registering a second hook is a hard error, never a silent overwrite. This gallery mirrors error toasts to the browser console — press the **Error toast** button on the Widgets page with the console open.
 
 ### Custom components {#custom-components}
 

{tinymoon-0.2.0 → tinymoon-0.3.0}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tinymoon",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zero-dependency vanilla JS/CSS UI framework",
   "license": "MIT",
   "type": "module",

{tinymoon-0.2.0 → tinymoon-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tinymoon"
-version = "0.2.0"
+version = "0.3.0"
 description = "Zero-dependency vanilla JS/CSS UI framework (placeholder release)"
 readme = "README.md"
 requires-python = ">=3.11"

{tinymoon-0.2.0 → tinymoon-0.3.0}/tinymoon/__init__.py

@@ -7,7 +7,7 @@ fonts) inside the wheel and exposes their location via assets_path().
 from importlib import resources
 from pathlib import Path
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 
 def assets_path() -> Path:

{tinymoon-0.2.0 → tinymoon-0.3.0}/uv.lock

@@ -74,7 +74,7 @@ wheels = [
 
 [[package]]
 name = "tinymoon"
-version = "0.2.0"
+version = "0.3.0"
 source = { editable = "." }
 dependencies = [
     { name = "strictcli" },

tinymoon-0.2.0/VERSION

@@ -1 +0,0 @@
-0.2.0