@grimoire-rs/indexer 0.4.3 → 0.5.0

package/dist/renderer/astro/styles/tokens.css

@@ -98,11 +98,46 @@
     --grim-text-xl: 1.5rem;
     --grim-text-2xl: 1.6rem;
 
-    /* ---- Radius ---------------------------------------------------- */
-    --grim-radius-sm: 4px;
-    --grim-radius-md: 6px;
-    --grim-radius-lg: 8px;
-    --grim-radius-xl: 10px;
+    /* ---- Radius ----------------------------------------------------
+       Four steps named for the job each one does, all derived from one
+       knob, plus `pill`, which is not.
+
+       `--grim-radius-base` IS the round-or-square decision, and it is the
+       one primitive in this sheet. It exists because the four steps below
+       share a raw value — the condition under which a primitive tier stops
+       being an indirection with nothing behind it. Ship square by setting
+       it to `0px`; `4px` restores the rounding this renderer had through
+       `0.4.x`, and every step keeps its ratio at any setting.
+
+         base     the knob. 0px is square, 4px is the old look
+         code     an inline run of code
+         inset    a control INSIDE another control — a menu item, an icon
+                  button, the logo tile, the key hint in the search field
+         control  a control or a popover: the search field, the install
+                  bar, the sort pair, the view toggle, every menu panel
+         surface  a content surface: a package card, the package list, the
+                  detail page's panels
+         pill     anything whose shape is its category — chips, badges,
+                  the version marker
+
+       `pill` is deliberately off the knob. A chip is a pill because that
+       shape says "toggleable tag"; squaring it turns it into a button, so
+       it is a constant rather than a step on the scale.
+
+       The four steps stay overridable one by one — a full redeclaration
+       beats the derivation — so a consumer wanting square surfaces and
+       rounded controls sets `--grim-radius-control` and ignores the knob.
+
+       Pick by matching the job, never by eyeballing the corner: the same
+       radius on a shorter box reads as more curve, so two surfaces that
+       look different are usually the same step, and two that look alike
+       are not necessarily. A corner that is genuinely wrong beside another
+       is almost always two surfaces of one job wearing different steps. */
+    --grim-radius-base: 0px;
+    --grim-radius-code: calc(1 * var(--grim-radius-base));
+    --grim-radius-inset: calc(1.5 * var(--grim-radius-base));
+    --grim-radius-control: calc(2 * var(--grim-radius-base));
+    --grim-radius-surface: calc(2.5 * var(--grim-radius-base));
     --grim-radius-pill: 999px;
 
     /* ---- Border ----------------------------------------------------

package/dist/renderer/index.d.ts

@@ -28,6 +28,64 @@ export declare class RenderInputError extends Error {
 export declare const ASTRO_SRC_DIR: string;
 /** Default `public/` layer; holds the fallback favicon. */
 export declare const DEFAULT_PUBLIC_DIR: string;
+/**
+ * This package's own version, named in every C-004 overlay log line so a
+ * theme author can tell which release the file they replaced came from.
+ *
+ * Read from disk rather than imported, so `rootDir: src` stays intact.
+ * `../../package.json` reaches the package root from `src/renderer/` and
+ * `dist/renderer/` alike — both sit exactly two directories under it, the
+ * same hop `packageVersion()` makes in `src/cli/main.ts`. Deliberately a
+ * second copy of those four lines rather than an import: `main.ts` is the
+ * commander entry point and it already imports this module, so reaching the
+ * other way would close a cycle and drag the CLI into every render.
+ */
+export declare function indexerVersion(): string;
+/**
+ * Directory in the index repo whose contents are laid over the renderer's
+ * own Astro sources — the structural half of the theming contract, where
+ * `customCss` is the CSS half.
+ *
+ * A file here either adds one (`theme/pages/setup.astro` becomes `/setup/`)
+ * or replaces the shipped file of the same path. What that costs is stated
+ * in the docs, not enforced here: page routes and the `@grim/*` specifier
+ * are contract, component paths and props are not yet.
+ */
+export declare const THEME_DIR = "theme";
+/**
+ * Theme-relative paths `overlayTheme` refuses to copy, no matter what an
+ * index repo puts under `theme/`.
+ *
+ * `lib` is the renderer's own helper tree (`astro/lib/*`, reached from a
+ * page or component through `@grim/lib/...`) — letting a theme silently
+ * replace one of those changes behaviour for every importer, not just the
+ * overridden path, with no doc describing it. `content.config.ts` is
+ * Astro's single content-collection entrypoint; a themed one would have to
+ * reproduce the `./enrich` glob loader `stage` already wires up, and one
+ * that gets it wrong breaks every collection at once with no traceable
+ * cause. This list is decided once, here, before the first consumer exists
+ * — narrowing it later breaks whoever already overrode a path that becomes
+ * newly excluded, so it is not loosened or tightened per bug report.
+ *
+ * Every entry means one thing: *this root-relative path, and everything
+ * under it*. One rule, so a third entry works the day it is added and
+ * cannot silently do nothing — which is exactly what a list read
+ * positionally (`[0]` a directory, `[1]` a basename) would have done. It
+ * also settles `content.config.ts` at the **root only**: the deny exists
+ * because Astro resolves exactly one content-collection entrypoint there,
+ * and `components/content.config.ts` carries no such meaning.
+ *
+ * Entries are lowercase because the comparison is. APFS and NTFS are
+ * case-insensitive, so `theme/LIB/data.ts` names the same file to the
+ * filesystem that serves it, and CI is `ubuntu-latest` only — it can never
+ * catch a case bypass, which is why the check has to be right rather than
+ * tested into shape.
+ *
+ * Not a security boundary, and no doc may call it one: `fs.cp` does not
+ * dereference symlinks, so `theme/lib -> ../../..` is copied through as a
+ * live symlink whatever this list says. It is a compatibility guard.
+ */
+export declare const OVERLAY_DENY: readonly ["lib", "content.config.ts"];
 /** Render the catalog site from `<outDir>/all.json` into `outDir`. */
 export declare function buildSite(opts: BuildSiteOptions): Promise<void>;
 /**

package/dist/renderer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAa9D,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,+DAA+D;AAC/D,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AA4BD,mEAAmE;AACnE,eAAO,MAAM,aAAa,QAA2B,CAAC;AACtD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,QAA4B,CAAC;AAuU5D,sEAAsE;AACtE,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BrE;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CA2BtE;AAED,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/renderer/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAa5E,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,+DAA+D;AAC/D,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AA4BD,mEAAmE;AACnE,eAAO,MAAM,aAAa,QAA2B,CAAC;AACtD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,QAA4B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,YAAY,uCAAwC,CAAC;AAsoBlE,sEAAsE;AACtE,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCrE;AAqKD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CtE;AAED,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}