paneltir 0.7.0 → 0.8.0

package/INSTALL.md

@@ -19,7 +19,7 @@ identity** — never another project's.
    npm install paneltir
 
    # or, without npm access, straight from the repository:
-   # npm install github:daifukus/paneltir#v0.7.0
+   # npm install github:daifukus/paneltir#v0.8.0
    ```
 
    (Use the tag you were given; never install without pinning a version.)
@@ -181,7 +181,7 @@ identity** — never another project's.
 
    ```bash
    npx paneltir version          # version, fingerprint, where it came from
-   npx paneltir check 0.7.0      # exits non-zero if that is not what is installed
+   npx paneltir check 0.8.0      # exits non-zero if that is not what is installed
    npx paneltir board            # read the board and say what is wrong with it
    ```
 

package/README.md

@@ -54,7 +54,7 @@ tag rather than a branch, so an unfinished push cannot reach a project:
 npm install paneltir
 
 # or, without npm access, straight from the repository:
-# npm install github:daifukus/paneltir#v0.7.0
+# npm install github:daifukus/paneltir#v0.8.0
 ```
 
 Installing from Git runs the `prepare` script, which builds `dist/`, so the

package/dist/index.d.ts

@@ -872,6 +872,14 @@ interface Preferences {
     seen?: string[];
     /** Ids of guide notes already dismissed. */
     guideDismissed?: string[];
+    /**
+     * Whether an update card is written as an order rather than a suggestion.
+     *
+     * It does not make anything automatic — the panel cannot run npm, and this
+     * changes `order` on the card it offers to write, nothing else. Off means
+     * the card asks; on means it tells.
+     */
+    updateAsOrder?: boolean;
 }
 interface PanelState {
     v: 2;
@@ -1117,6 +1125,19 @@ interface UiStrings {
     analysis: string;
     /** The Revisions tab. Short, because it sits beside Board and Analysis. */
     history: string;
+    updateTitle: string;
+    updateSubtitle: string;
+    updateCurrent: (version: string) => string;
+    updateAvailable: (version: string) => string;
+    updateUpToDate: string;
+    updateUnknown: string;
+    updateCreateCard: string;
+    updateCardExists: string;
+    updateAsOrder: string;
+    updateAsOrderHow: string;
+    notifUpdate: string;
+    updateCardTitle: (version: string) => string;
+    updateCardBody: (version: string) => string;
     cardDetail: string;
     panelSettings: string;
     title: string;
@@ -1419,6 +1440,14 @@ interface PanelAppProps {
     showLanguage?: boolean;
     /** The revision log: one entry per session, newest first. */
     showHistory?: boolean;
+    /**
+     * Ask the public npm registry whether a newer kit has been published.
+     *
+     * Opt-in, because it is a request leaving the reader's browser and that is
+     * the caller's decision rather than the kit's. Nothing is installed either
+     * way: the panel offers to write a card, and a session acts on it.
+     */
+    checkForUpdates?: boolean;
     /** Endpoint that commits the board back to the repository, when there is one. */
     saveEndpoint?: string;
     /**
@@ -1436,7 +1465,7 @@ interface PanelAppProps {
         fileCount: number;
     };
 }
-declare function PanelApp({ state: initialState, themes, defaultTheme, brand, decoration, className, footer, links, capabilities, extras, showLanguage, showHistory, saveEndpoint, marketplaceEndpoint, marketplaceReport, fingerprint, }: PanelAppProps): React.JSX.Element;
+declare function PanelApp({ state: initialState, themes, defaultTheme, brand, decoration, className, footer, links, capabilities, extras, showLanguage, showHistory, checkForUpdates, saveEndpoint, marketplaceEndpoint, marketplaceReport, fingerprint, }: PanelAppProps): React.JSX.Element;
 
 /**
  * Applies a board move to the flat card list.

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/version.ts
-var PANELTIR_VERSION = "0.7.0";
-var PANELTIR_FINGERPRINT = "sha256:406af8c690cfa9b2452360712afff3f3fe9605a7bb0aa834238e5187acfc37c0";
-var PANELTIR_FILE_COUNT = 151;
+var PANELTIR_VERSION = "0.8.0";
+var PANELTIR_FINGERPRINT = "sha256:a252ef2a015240e0e8463c0ebb0ef7a8af80ad7ade66f2c48e71657500d506d5";
+var PANELTIR_FILE_COUNT = 153;
 var paneltirBuild = {
   version: PANELTIR_VERSION,
   fingerprint: PANELTIR_FINGERPRINT,
@@ -1302,6 +1302,37 @@ function isCard(value) {
 // src/panel/PanelApp.tsx
 import React12, { useCallback as useCallback5, useEffect as useEffect9, useMemo as useMemo5, useState as useState9 } from "react";
 
+// src/panel/updates.ts
+var REGISTRY_URL = "https://registry.npmjs.org/paneltir/latest";
+function isNewer(candidate, current) {
+  const parts = (value) => value.trim().replace(/^v/, "").split(/[-+]/)[0].split(".").map((piece) => Number.parseInt(piece, 10));
+  const left = parts(candidate);
+  const right = parts(current);
+  if (left.some(Number.isNaN) || right.some(Number.isNaN)) return false;
+  for (let i = 0; i < 3; i += 1) {
+    const a = left[i] ?? 0;
+    const b = right[i] ?? 0;
+    if (a !== b) return a > b;
+  }
+  return false;
+}
+async function checkForUpdate(current, fetchImpl = fetch) {
+  try {
+    const response = await fetchImpl(REGISTRY_URL, { headers: { accept: "application/json" } });
+    if (!response.ok) return null;
+    const body = await response.json();
+    const latest = typeof body.version === "string" ? body.version : null;
+    if (!latest) return null;
+    return { current, latest, behind: isNewer(latest, current) };
+  } catch {
+    return null;
+  }
+}
+function updateCardId(version) {
+  const found = /\d+\.\d+\.\d+/.exec(version);
+  return `paneltir-update-${found ? found[0] : "unknown"}`;
+}
+
 // src/panel/themes.ts
 var PRESET_FORM = {
   midnight: THEME_FORMS.panel,
@@ -1356,6 +1387,19 @@ var UI = {
     board: "Board",
     analysis: "Analysis",
     history: "Revisions",
+    updateTitle: "The kit this panel runs on",
+    updateSubtitle: "What is installed, and what has been published since.",
+    updateCurrent: (version) => `Installed: v${version}`,
+    updateAvailable: (version) => `v${version} has been published.`,
+    updateUpToDate: "This is the newest published version.",
+    updateUnknown: "The registry could not be reached, so there is nothing to report either way.",
+    updateCreateCard: "Add a card asking for it",
+    updateCardExists: "The board already carries a card for this version.",
+    updateAsOrder: "Write it as an order, not a suggestion",
+    updateAsOrderHow: "This does not update anything on its own \u2014 the panel cannot run npm. It decides whether the card it writes asks for the update or instructs it.",
+    notifUpdate: "A newer Paneltir has been published",
+    updateCardTitle: (version) => `Update Paneltir to v${version}`,
+    updateCardBody: (version) => `Run \`npm install paneltir@${version}\` in this project, then check the panel still builds and renders. The version in use is reported by \`paneltirBuild\`, so it can be confirmed rather than assumed.`,
     cardDetail: "Card",
     panelSettings: "Panel settings",
     title: "Title",
@@ -1617,6 +1661,19 @@ var UI = {
     board: "Tablero",
     analysis: "An\xE1lisis",
     history: "Revisiones",
+    updateTitle: "El kit sobre el que corre este panel",
+    updateSubtitle: "Qu\xE9 hay instalado, y qu\xE9 se ha publicado desde entonces.",
+    updateCurrent: (version) => `Instalada: v${version}`,
+    updateAvailable: (version) => `Se ha publicado la v${version}.`,
+    updateUpToDate: "Esta es la versi\xF3n publicada m\xE1s reciente.",
+    updateUnknown: "No se pudo consultar el registro, as\xED que no hay nada que decir en ning\xFAn sentido.",
+    updateCreateCard: "A\xF1adir una tarjeta pidi\xE9ndolo",
+    updateCardExists: "El tablero ya lleva una tarjeta para esta versi\xF3n.",
+    updateAsOrder: "Escribirla como orden, no como sugerencia",
+    updateAsOrderHow: "Esto no actualiza nada por su cuenta \u2014 el panel no puede ejecutar npm. Decide si la tarjeta que escribe pide la actualizaci\xF3n o la manda.",
+    notifUpdate: "Se ha publicado un Paneltir m\xE1s nuevo",
+    updateCardTitle: (version) => `Actualizar Paneltir a la v${version}`,
+    updateCardBody: (version) => `Ejecuta \`npm install paneltir@${version}\` en este proyecto y comprueba que el panel sigue construy\xE9ndose y dibuj\xE1ndose. La versi\xF3n en uso la reporta \`paneltirBuild\`, as\xED que se puede confirmar en vez de darla por hecha.`,
     cardDetail: "Tarjeta",
     panelSettings: "Ajustes del panel",
     title: "T\xEDtulo",
@@ -2685,6 +2742,7 @@ function PanelApp({
   extras,
   showLanguage,
   showHistory,
+  checkForUpdates,
   saveEndpoint,
   marketplaceEndpoint,
   marketplaceReport,
@@ -2702,6 +2760,7 @@ function PanelApp({
   const [filter, setFilter] = useState9("all");
   const [openCardId, setOpenCardId] = useState9(null);
   const [settingsOpen, setSettingsOpen] = useState9(false);
+  const [update, setUpdate] = useState9(null);
   const [helpOpen, setHelpOpen] = useState9(false);
   const [setup, setSetup] = useState9(null);
   const [signOut, setSignOut] = useState9("idle");
@@ -2810,6 +2869,15 @@ function PanelApp({
         onOpen: () => setOpenCardId(card.id)
       });
     }
+    if (update?.behind && !state.cards.some((card) => card.id === updateCardId(update.latest))) {
+      items.push({
+        id: `paneltir-update:${update.latest}`,
+        tone: "info",
+        title: ui.notifUpdate,
+        detail: ui.updateAvailable(update.latest),
+        onOpen: () => setSettingsOpen(true)
+      });
+    }
     if (state.importedTheme?.refreshRequested) {
       items.push({
         id: `theme-refresh:${state.importedTheme.refreshRequested}`,
@@ -2889,6 +2957,23 @@ function PanelApp({
     },
     [state.areas]
   );
+  const addUpdateCard = useCallback5(() => {
+    if (!update?.behind) return;
+    const id = updateCardId(update.latest);
+    if (state.cards.some((card2) => card2.id === id)) return;
+    const card = {
+      ...emptyCard("next", state.areas[0]?.id ?? "general"),
+      id,
+      title: { en: UI.en.updateCardTitle(update.latest), es: UI.es.updateCardTitle(update.latest) },
+      body: { en: UI.en.updateCardBody(update.latest), es: UI.es.updateCardBody(update.latest) },
+      priority: "medium",
+      risk: "low",
+      owner: "claude",
+      order: state.preferences?.updateAsOrder === true
+    };
+    setState((current) => ({ ...current, updatedAt: today(), cards: [...current.cards, card] }));
+    setOpenCardId(id);
+  }, [update, state.cards, state.areas, state.preferences?.updateAsOrder]);
   const moveCard = useCallback5(
     (move) => {
       setState((current) => {
@@ -3008,6 +3093,16 @@ function PanelApp({
     setMarketAsked(true);
     loadMarketplace(false);
   }, [view, marketAsked, marketplaceEndpoint, loadMarketplace]);
+  useEffect9(() => {
+    if (!checkForUpdates || !fingerprint?.version) return;
+    let cancelled = false;
+    void checkForUpdate(fingerprint.version).then((status2) => {
+      if (!cancelled) setUpdate(status2);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [checkForUpdates, fingerprint?.version]);
   useEffect9(() => {
     if (!helpOpen || !saveEndpoint || setup) return;
     let cancelled = false;
@@ -3512,6 +3607,23 @@ function PanelApp({
           /* @__PURE__ */ jsx19("p", { className: "pt-marketplace__detail", children: ui.importedRefreshHow })
         ] })
       ] }),
+      checkForUpdates && fingerprint?.version && /* @__PURE__ */ jsxs17(DetailSection, { title: ui.updateTitle, subtitle: ui.updateSubtitle, children: [
+        /* @__PURE__ */ jsx19("p", { className: "pt-panel-text", children: ui.updateCurrent(fingerprint.version) }),
+        /* @__PURE__ */ jsx19("p", { className: "pt-panel-text", style: { marginTop: 8 }, children: !update ? ui.updateUnknown : update.behind ? ui.updateAvailable(update.latest) : ui.updateUpToDate }),
+        update?.behind && (state.cards.some((card) => card.id === updateCardId(update.latest)) ? /* @__PURE__ */ jsx19("p", { className: "pt-panel-text", style: { marginTop: 8 }, children: ui.updateCardExists }) : /* @__PURE__ */ jsx19("div", { className: "pt-panel-row", style: { marginTop: 12 }, children: /* @__PURE__ */ jsx19("button", { type: "button", className: "pt-btn", onClick: addUpdateCard, children: ui.updateCreateCard }) })),
+        /* @__PURE__ */ jsxs17("label", { className: "pt-panel-row", style: { marginTop: 12 }, children: [
+          /* @__PURE__ */ jsx19(
+            "input",
+            {
+              type: "checkbox",
+              checked: state.preferences?.updateAsOrder === true,
+              onChange: (event) => setPreference("updateAsOrder", event.target.checked)
+            }
+          ),
+          /* @__PURE__ */ jsx19("span", { className: "pt-panel-text", children: ui.updateAsOrder })
+        ] }),
+        /* @__PURE__ */ jsx19("p", { className: "pt-marketplace__detail", children: ui.updateAsOrderHow })
+      ] }),
       fingerprint && /* @__PURE__ */ jsxs17(DetailSection, { title: ui.fingerprint, subtitle: ui.fingerprintSubtitle, children: [
         /* @__PURE__ */ jsx19("p", { className: "pt-panel-mono", children: fingerprint.hash }),
         /* @__PURE__ */ jsx19("p", { className: "pt-panel-text", style: { marginTop: 8 }, children: ui.trackedFiles(fingerprint.fileCount, fingerprint.version) })

package/fingerprint.json

@@ -1,7 +1,7 @@
 {
   "name": "paneltir",
-  "version": "0.7.0",
-  "hash": "sha256:406af8c690cfa9b2452360712afff3f3fe9605a7bb0aa834238e5187acfc37c0",
-  "fileCount": 151,
-  "generatedAt": "2026-09-07T12:33:30.026Z"
+  "version": "0.8.0",
+  "hash": "sha256:a252ef2a015240e0e8463c0ebb0ef7a8af80ad7ade66f2c48e71657500d506d5",
+  "fileCount": 153,
+  "generatedAt": "2026-09-07T12:59:14.850Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paneltir",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A React UI kit for admin panels: page frame, a board with touch-ready drag and drop, detail sheets, and a whole panel in one component. Structure and behaviour are fixed; colour and brand belong to each project.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "DFKlabs (https://DFKlabs.com)",
@@ -64,7 +64,7 @@
     "check:boards": "node scripts/check-boards.mjs",
     "demo:install": "npm --prefix examples/demo ci",
     "demo:build": "npm --prefix examples/demo run build",
-    "verify": "npm run typecheck && npm run build && npm run icons:check && npm run seo:check && npm run test:auth && npm run test:marketplace && npm run test:init && npm run test:board && npm run check:boards && npm run check:docs && npm run check:package && npm run fingerprint:check",
+    "verify": "npm run typecheck && npm run build && npm run icons:check && npm run seo:check && npm run test:auth && npm run test:marketplace && npm run test:init && npm run test:board && npm run test:updates && npm run check:boards && npm run check:docs && npm run check:package && npm run fingerprint:check",
     "site:install": "npm --prefix site ci",
     "site:dev": "npm --prefix site run dev",
     "site:build": "npm --prefix site run build",
@@ -72,6 +72,7 @@
     "check:docs": "node scripts/check-docs.mjs",
     "check:package": "node scripts/check-package.mjs",
     "test:init": "node scripts/test-init.mjs",
+    "test:updates": "node scripts/test-updates.mjs",
     "test:board": "node scripts/test-board.mjs"
   },
   "peerDependencies": {