paneltir 0.10.1 → 0.11.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.10.1
+   # npm install github:daifukus/paneltir#v0.11.0
    ```
 
    (Use the tag you were given; never install without pinning a version.)
@@ -237,7 +237,7 @@ identity** — never another project's.
 
    ```bash
    npx paneltir version          # version, fingerprint, where it came from
-   npx paneltir check 0.10.1      # exits non-zero if that is not what is installed
+   npx paneltir check 0.11.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.10.1
+# npm install github:daifukus/paneltir#v0.11.0
 ```
 
 Installing from Git runs the `prepare` script, which builds `dist/`, so the

package/dist/index.d.ts

@@ -284,6 +284,14 @@ interface BoardColumnData<TCard extends BoardCardData = BoardCardData> {
      */
     hint?: string;
     cards: TCard[];
+    /**
+     * Drawn under the cards, inside the column's own scroll.
+     *
+     * It exists for what a column has to say about cards it is *not* showing —
+     * a done column hiding what was finished last month still owes the reader a
+     * line saying so, or the cards have not been hidden, they have been lost.
+     */
+    footer?: React.ReactNode;
 }
 interface BoardMoveResult {
     cardId: string;
@@ -1055,6 +1063,32 @@ declare function newId(): string;
 declare function today(): string;
 /** A card is created empty and named second — the same as tapping "+" on paper. */
 declare function emptyCard(column: string, area: string): Card;
+/**
+ * How long a finished card stays on the board before it becomes history.
+ *
+ * A done column only grows. It is the one column nothing ever removes from,
+ * so a board that is being worked turns into a wall of things already
+ * finished, and the three columns that need reading get a third of the screen
+ * between them. A week is the window in which "what did we ship" is still a
+ * live question; after that it is a record, and a record does not need to be
+ * in the way.
+ */
+declare const ARCHIVE_AFTER_DAYS = 7;
+/**
+ * Whether a finished card has been finished long enough to stop being drawn.
+ *
+ * Derived on every render and never written, which is the arrangement
+ * `boardFacts()` already uses: a flag stored on the card would be wrong the
+ * day after it was set, and setting it would mark the panel dirty for the
+ * passage of time. Here the answer simply becomes true on its own.
+ *
+ * **A card with no `completedAt` is never archived**, whatever column it sits
+ * in. It reached done without being stamped — a board edited by hand, or one
+ * from before the stamp existed — so its age is not known, and hiding a card
+ * whose age nobody knows is the same mistake as reporting a token missing
+ * because the check could not run. `unknown` is not `old`.
+ */
+declare function isArchived(card: Card, doneColumns: ReadonlySet<string>, now?: string, afterDays?: number): boolean;
 /**
  * Applies the column's own meaning to a card that just moved into it: a card
  * entering the working column is started, one reaching a done column is
@@ -1386,6 +1420,9 @@ interface UiStrings {
     needTokenEnables: string;
     needRepo: string;
     needRepoEnables: string;
+    archivedOne: string;
+    archivedMany: string;
+    archivedHide: string;
     needGate: string;
     needGateEnables: string;
     fixGate: string;
@@ -1847,4 +1884,4 @@ interface CardSheetProps {
 }
 declare function CardSheet({ card, state, lang, ui, onChange, onDelete, onClose }: CardSheetProps): React.JSX.Element | null;
 
-export { ANALYSIS_SECTIONS, AlertBanner, type AlertBannerProps, type Analysis, type AnalysisSection, AnalysisView, BOARD_VERSION, Board, type BoardCardData, type BoardCheck, type BoardColumnData, type BoardFacts, type BoardMoveResult, type BoardProblem, type BoardProps, type BoardTag, CAPABILITIES, type Capability, Card$1 as Card, type CardProps, CardSheet, type Check, type Choice, type ChoiceOption, type ColumnDef, type Competitor, type Constraint, CopyBlock, type CopyBlockLabels, type CopyBlockProps, type Counts, DashboardHeader, type DashboardHeaderProps, type DashboardThemeForm, DashboardThemeProvider, type DashboardThemeTokens, DetailSection, type DetailSectionProps, DetailSheet, type DetailSheetProps, FilterChip, type FilterChipProps, FilterChipRow, type GateReading, type GateStamp, type GateVerdict, type Goal, GuideNote, type GuideNoteProps, GuideTour, type GuideTourProps, type HealthFact, HealthPill, type HealthPillProps, HealthPillRow, type HealthStatus, INTENTS, INTENT_COPY, type ImportedTheme, type InstallState, type Intent, type IntentCopy, LANGS, LANG_LABELS, LEVELS, type Lang, type Level, MARKETPLACE_NAME, MARKETPLACE_URL, type Market, type MarketplaceReport, type MarketplaceTool, MarketplaceView, type Metric, type Note, NotificationBell, type NotificationBellProps, type NotificationLabels, type NotificationTone, OWNERS, type Owner, PANELTIR_FILE_COUNT, PANELTIR_FINGERPRINT, PANELTIR_TEMPLATE_HASH, PANELTIR_VERSION, PRESET_PANEL_THEMES, PanelApp, type PanelAppProps, type Card as PanelCard, type PanelNotification, type PanelState, type PanelTheme, type PanelThemes, type Preferences, type Reading, type Run, SetupGuide, type SetupGuideProps, type SetupRequirement, type SetupStatus, SetupWizard, type SetupWizardLabels, type SetupWizardProps, type Severity, StatTile, StatTileGrid, type StatTileProps, type Strategy, type Suggestion, type SuggestionStatus, THEME_FORMS, THEME_PRESETS, type Text, type ThemeFormName, type ThemePresetName, type Trend, UI, type UiStrings, type Weight, type WizardStep, applyMove, boardFacts, checkProgress, claimedWithoutStarting, claudeTheme, commandSnippet, countCards, cyberpunkTheme, decided, emptyCard, explainBoard, gateStatus, isCard, isFirstRun, ledgerForm, midnightTheme, moveCardInColumns, newId, offeredThemes, oldMoneyTheme, panelForm, paneltirBuild, paperForm, readBoard, readStoredLang, repositorySnippet, resetGuide, sparkPoints, stampForColumn, storeLang, text, today, trendOf, undecided, untranslated, useDashboardForm, useDashboardTheme, useDelegatedClick, useGuideNote, useMediaQuery, validateBoard, wizardStep, writeText };
+export { ANALYSIS_SECTIONS, ARCHIVE_AFTER_DAYS, AlertBanner, type AlertBannerProps, type Analysis, type AnalysisSection, AnalysisView, BOARD_VERSION, Board, type BoardCardData, type BoardCheck, type BoardColumnData, type BoardFacts, type BoardMoveResult, type BoardProblem, type BoardProps, type BoardTag, CAPABILITIES, type Capability, Card$1 as Card, type CardProps, CardSheet, type Check, type Choice, type ChoiceOption, type ColumnDef, type Competitor, type Constraint, CopyBlock, type CopyBlockLabels, type CopyBlockProps, type Counts, DashboardHeader, type DashboardHeaderProps, type DashboardThemeForm, DashboardThemeProvider, type DashboardThemeTokens, DetailSection, type DetailSectionProps, DetailSheet, type DetailSheetProps, FilterChip, type FilterChipProps, FilterChipRow, type GateReading, type GateStamp, type GateVerdict, type Goal, GuideNote, type GuideNoteProps, GuideTour, type GuideTourProps, type HealthFact, HealthPill, type HealthPillProps, HealthPillRow, type HealthStatus, INTENTS, INTENT_COPY, type ImportedTheme, type InstallState, type Intent, type IntentCopy, LANGS, LANG_LABELS, LEVELS, type Lang, type Level, MARKETPLACE_NAME, MARKETPLACE_URL, type Market, type MarketplaceReport, type MarketplaceTool, MarketplaceView, type Metric, type Note, NotificationBell, type NotificationBellProps, type NotificationLabels, type NotificationTone, OWNERS, type Owner, PANELTIR_FILE_COUNT, PANELTIR_FINGERPRINT, PANELTIR_TEMPLATE_HASH, PANELTIR_VERSION, PRESET_PANEL_THEMES, PanelApp, type PanelAppProps, type Card as PanelCard, type PanelNotification, type PanelState, type PanelTheme, type PanelThemes, type Preferences, type Reading, type Run, SetupGuide, type SetupGuideProps, type SetupRequirement, type SetupStatus, SetupWizard, type SetupWizardLabels, type SetupWizardProps, type Severity, StatTile, StatTileGrid, type StatTileProps, type Strategy, type Suggestion, type SuggestionStatus, THEME_FORMS, THEME_PRESETS, type Text, type ThemeFormName, type ThemePresetName, type Trend, UI, type UiStrings, type Weight, type WizardStep, applyMove, boardFacts, checkProgress, claimedWithoutStarting, claudeTheme, commandSnippet, countCards, cyberpunkTheme, decided, emptyCard, explainBoard, gateStatus, isArchived, isCard, isFirstRun, ledgerForm, midnightTheme, moveCardInColumns, newId, offeredThemes, oldMoneyTheme, panelForm, paneltirBuild, paperForm, readBoard, readStoredLang, repositorySnippet, resetGuide, sparkPoints, stampForColumn, storeLang, text, today, trendOf, undecided, untranslated, useDashboardForm, useDashboardTheme, useDelegatedClick, useGuideNote, useMediaQuery, validateBoard, wizardStep, writeText };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/version.ts
-var PANELTIR_VERSION = "0.10.1";
-var PANELTIR_FINGERPRINT = "sha256:b2d1daf120972ce3bfc54f3a9f09bccaddd6ceb306a65a1682b810012d85f33d";
+var PANELTIR_VERSION = "0.11.0";
+var PANELTIR_FINGERPRINT = "sha256:2739462e763939de1d1aeb8ab97779149c2ddb0ec2d2fb45644c4c45ef9dc9fa";
 var PANELTIR_FILE_COUNT = 163;
 var PANELTIR_TEMPLATE_HASH = "sha256:034ba27266408af4f2ba5793d9cefbe448b168570d6a0b87dfe698dfe639feb1";
 var paneltirBuild = {
@@ -306,7 +306,8 @@ function Column({ column, renderCard, onAddCard }) {
           renderCard(card, index, column.id)
         ] }, card.id);
       }),
-      dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === column.cards.length && /* @__PURE__ */ jsx8("div", { className: "pt-card-placeholder" })
+      dnd.isDragging && dnd.dropTarget?.columnId === column.id && dnd.dropTarget.index === column.cards.length && /* @__PURE__ */ jsx8("div", { className: "pt-card-placeholder" }),
+      column.footer ? /* @__PURE__ */ jsx8("div", { className: "pt-column__footer", children: column.footer }) : null
     ] })
   ] });
 }
@@ -1148,6 +1149,18 @@ function emptyCard(column, area) {
     completedAt: null
   };
 }
+var ARCHIVE_AFTER_DAYS = 7;
+function daysBefore(from, days) {
+  const at = /* @__PURE__ */ new Date(`${from}T00:00:00Z`);
+  at.setUTCDate(at.getUTCDate() - days);
+  return at.toISOString().slice(0, 10);
+}
+function isArchived(card, doneColumns, now = today(), afterDays = ARCHIVE_AFTER_DAYS) {
+  if (!doneColumns.has(card.column)) return false;
+  const finished = card.completedAt;
+  if (typeof finished !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(finished)) return false;
+  return finished < daysBefore(now, afterDays);
+}
 function stampForColumn(card, columns) {
   const column = columns.find((candidate) => candidate.id === card.column);
   if (!column) return card;
@@ -1615,6 +1628,9 @@ var UI = {
     needTokenEnables: "Lets Save commit the board back to the repository. Without it everything else works and Save fails.",
     needRepo: "The repository to write to",
     needRepoEnables: "Which repository the board is committed to. There is no default on purpose: writing to the wrong one is worse than not writing.",
+    archivedOne: "archived \u2014 finished over a week ago",
+    archivedMany: "archived \u2014 finished over a week ago",
+    archivedHide: "Hide them again",
     needGate: "The gate this project copied",
     needGateEnables: "The sign-in, the session and the write-back are files this project owns, copied once and never updated with the library. When one of them is older than the package, the panel does not look misconfigured \u2014 it looks broken.",
     fixGate: "The gate is older than the installed kit. See what changed before replacing anything:",
@@ -1939,6 +1955,9 @@ var UI = {
     needTokenEnables: "Permite que Guardar confirme el tablero en el repositorio. Sin \xE9l todo lo dem\xE1s funciona y Guardar falla.",
     needRepo: "El repositorio donde escribir",
     needRepoEnables: "En qu\xE9 repositorio se confirma el tablero. No hay valor por defecto a prop\xF3sito: escribir en el equivocado es peor que no escribir.",
+    archivedOne: "archivada \u2014 terminada hace m\xE1s de una semana",
+    archivedMany: "archivadas \u2014 terminadas hace m\xE1s de una semana",
+    archivedHide: "Volver a esconderlas",
     needGate: "La puerta que copi\xF3 este proyecto",
     needGateEnables: "El acceso, la sesi\xF3n y la escritura de vuelta son archivos de este proyecto, copiados una vez y que no se actualizan con la librer\xEDa. Cuando uno se queda m\xE1s viejo que el paquete, el panel no parece mal configurado: parece roto.",
     fixGate: "La puerta es m\xE1s vieja que el kit instalado. Mira qu\xE9 cambi\xF3 antes de reemplazar nada:",
@@ -3032,6 +3051,7 @@ function PanelApp({
   );
   const [state, setState] = useState10(initialState);
   const [filter, setFilter] = useState10("all");
+  const [showArchived, setShowArchived] = useState10(() => /* @__PURE__ */ new Set());
   const [openCardId, setOpenCardId] = useState10(null);
   const [settingsOpen, setSettingsOpen] = useState10(false);
   const [update, setUpdate] = useState10(null);
@@ -3155,13 +3175,31 @@ function PanelApp({
   );
   const visibleCards = useMemo5(() => state.cards.filter(matches), [state.cards, matches]);
   const boardColumns = useMemo5(
-    () => state.columns.map((column) => ({
-      id: column.id,
-      title: t(column.title),
-      hint: column.hint ? t(column.hint) : void 0,
-      cards: visibleCards.filter((card) => card.column === column.id)
-    })),
-    [state.columns, visibleCards, t]
+    () => state.columns.map((column) => {
+      const mine = visibleCards.filter((card) => card.column === column.id);
+      const archived = mine.filter((card) => isArchived(card, doneColumns));
+      const showing = showArchived.has(column.id) ? mine : mine.filter((card) => !archived.includes(card));
+      return {
+        id: column.id,
+        title: t(column.title),
+        hint: column.hint ? t(column.hint) : void 0,
+        cards: showing,
+        footer: archived.length ? /* @__PURE__ */ jsx20(
+          "button",
+          {
+            type: "button",
+            onClick: () => setShowArchived((current) => {
+              const next = new Set(current);
+              if (next.has(column.id)) next.delete(column.id);
+              else next.add(column.id);
+              return next;
+            }),
+            children: showArchived.has(column.id) ? ui.archivedHide : `${archived.length} ${archived.length === 1 ? ui.archivedOne : ui.archivedMany}`
+          }
+        ) : void 0
+      };
+    }),
+    [state.columns, visibleCards, doneColumns, showArchived, t, ui]
   );
   const notifications = useMemo5(() => {
     const items = [];
@@ -4263,6 +4301,7 @@ var CAPABILITIES = [
 ];
 export {
   ANALYSIS_SECTIONS,
+  ARCHIVE_AFTER_DAYS,
   AlertBanner,
   AnalysisView,
   BOARD_VERSION,
@@ -4316,6 +4355,7 @@ export {
   emptyCard,
   explainBoard,
   gateStatus,
+  isArchived,
   isCard,
   isFirstRun,
   ledgerForm,

package/dist/style.css

@@ -594,6 +594,28 @@
   background: var(--pt-color-panel);
   box-shadow: 0 10px 26px rgba(0, 0, 0, 0.45);
 }
+.pt-column__footer {
+  padding-top: var(--pt-space-sm);
+  border-top: var(--pt-border-width) solid var(--pt-color-line-faint);
+  font-size: 11.5px;
+  color: var(--pt-color-ink-faint);
+}
+.pt-column__footer button {
+  border: none;
+  background: none;
+  padding: 0;
+  font: inherit;
+  color: inherit;
+  cursor: pointer;
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+.pt-column__footer button:hover {
+  color: var(--pt-color-ink-dim);
+}
+.pt-column__list > * {
+  flex-shrink: 0;
+}
 
 /* src/components/DetailSheet/DetailSheet.css */
 .pt-sheet-backdrop {

package/fingerprint.json

@@ -1,8 +1,8 @@
 {
   "name": "paneltir",
-  "version": "0.10.1",
-  "hash": "sha256:b2d1daf120972ce3bfc54f3a9f09bccaddd6ceb306a65a1682b810012d85f33d",
+  "version": "0.11.0",
+  "hash": "sha256:2739462e763939de1d1aeb8ab97779149c2ddb0ec2d2fb45644c4c45ef9dc9fa",
   "fileCount": 163,
   "templateHash": "sha256:034ba27266408af4f2ba5793d9cefbe448b168570d6a0b87dfe698dfe639feb1",
-  "generatedAt": "2026-09-11T07:08:17.308Z"
+  "generatedAt": "2026-09-13T08:39:02.027Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paneltir",
-  "version": "0.10.1",
+  "version": "0.11.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)",
@@ -99,56 +99,28 @@
     "node": ">=20"
   },
   "paneltirRelease": {
-    "version": "0.10.1",
-    "date": "2026-09-11",
+    "version": "0.11.0",
+    "date": "2026-09-13",
     "entries": [
       {
-        "kind": "fix",
+        "kind": "feature",
         "text": {
-          "en": "Re-running `paneltir init` no longer tells the panel a stale gate is current. It stamped the new template over files it had not written, so a project that updated and re-ran init was told its gate was up to date when it was not.",
-          "es": "Re-ejecutar `paneltir init` ya no le dice al panel que una puerta vieja está al día. Sellaba la plantilla nueva sobre archivos que no había escrito, así que un proyecto que actualizaba y re-ejecutaba init recibía un «todo correcto» que no era cierto."
+          "en": "A card finished more than a week ago stops being drawn in its column. The column says how many it is holding and one tap shows them — nothing is hidden without being accounted for.",
+          "es": "Una tarjeta terminada hace más de una semana deja de dibujarse en su columna. La columna dice cuántas guarda y un toque las enseña — nada se esconde sin quedar contado."
         }
       },
       {
-        "kind": "fix",
+        "kind": "feature",
         "text": {
-          "en": "The save endpoint's own board check had drifted to a shallow one that accepted a board with no areas, an unknown intent, an unknown area and any version at all. All three copies of that check are now held to the same verdict.",
-          "es": "La comprobación del tablero en el endpoint de guardado había derivado a una superficial que aceptaba un tablero sin áreas, un intent desconocido, un área desconocida y cualquier versión. Las tres copias de esa comprobación se sujetan ahora al mismo veredicto."
-        }
-      },
-      {
-        "kind": "fix",
-        "text": {
-          "en": "`paneltir run` appends to the end of the revisions log instead of the front, so a new pass reads as the newest and not the oldest — and accepts `--cards a,b` and `--by you`, the spaced form its own usage line prints.",
-          "es": "`paneltir run` añade al final del registro de revisiones en vez de al principio, así una pasada nueva se lee como la más reciente y no como la más antigua — y acepta `--cards a,b` y `--by you`, la forma con espacio que imprime su propio uso."
-        }
-      },
-      {
-        "kind": "fix",
-        "text": {
-          "en": "A board naming a theme that only exists on Object's prototype — `constructor`, `toString` — no longer resolves as a theme and draws the panel in the browser's default colours.",
-          "es": "Un tablero que nombra un tema que sólo existe en el prototipo de Object — `constructor`, `toString` — ya no se resuelve como tema ni dibuja el panel con los colores por defecto del navegador."
-        }
-      },
-      {
-        "kind": "fix",
-        "text": {
-          "en": "Saving no longer breaks permanently once a board reaches two hundred revisions. The limit was refused on the write path and applied nowhere; it is bounded where the log is appended instead.",
-          "es": "Guardar ya no se rompe para siempre cuando un tablero llega a doscientas revisiones. El límite se rechazaba al escribir y no se aplicaba en ningún sitio; ahora se acota donde se añade al registro."
-        }
-      },
-      {
-        "kind": "fix",
-        "text": {
-          "en": "The copied gate's row in the setup list no longer parks the walkthrough on a step its one action cannot clear, nor makes every other step report that the panel could not reach its own server.",
-          "es": "La fila de la puerta copiada en la lista de configuración ya no deja el asistente atascado en un paso que su única acción no puede resolver, ni hace que el resto de pasos digan que el panel no pudo alcanzar su propio servidor."
+          "en": "A board column can carry a footer, drawn inside its own scroll so it takes no height from the cards.",
+          "es": "Una columna del tablero puede llevar un pie, dibujado dentro de su propio scroll para que no le quite alto a las tarjetas."
         }
       },
       {
         "kind": "chore",
         "text": {
-          "en": "Two checks that could stop checking were closed: a travelling document that cannot be read is now a failure rather than a pass, and no gate file may read the environment at module scope — where no error can be caught.",
-          "es": "Se cerraron dos comprobaciones que podían dejar de comprobar: un documento que viaja y no se puede leer ahora falla en vez de pasar, y ningún archivo de la puerta puede leer el entorno a nivel de módulo, donde ningún error se puede capturar."
+          "en": "A card in a scrolling column can never shrink below its own content, so a title can never be cut in half.",
+          "es": "Una tarjeta en una columna con scroll no puede encogerse por debajo de su contenido, así que un título no puede quedar cortado por la mitad."
         }
       }
     ]