secondbrain-py 0.2.1__py3-none-any.whl

brain/quartz_overrides/quartz/styles/brain/_callouts.scss

@@ -0,0 +1,180 @@
+// Brain callouts — Lane C of the 2026 commonplace-book redesign.
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_callouts.scss` by `brain vault
+// render --overlay` and pulled into the global SCSS via `custom.scss`'s
+// `@use "./brain/callouts"` line.
+//
+// Stock Quartz callouts (`quartz/styles/callouts.scss`) ship a
+// Material-style palette — saturated blue / cyan / orange / red over
+// white — that clashes hard with the cream-paper redesign. This file
+// repaints every Quartz callout type into the redesign palette, then
+// adds the editorial chrome the plan calls for: tinted background
+// (`color-mix`), a 3px left border in the type color, a small-caps
+// title bar, and a subtle `--shadow-sm` on the container.
+//
+// Callout types touched (the full Quartz set):
+//   note, info, abstract, tip, success, question, warning, danger,
+//   failure, bug, example, quote.
+//
+// Each gets its own `--callout-{type}` token at the top of `:root` /
+// `:root[saved-theme="dark"]` so the palette is auditable in one
+// place. The per-type rule below resolves `--type-color` from the
+// matching token, then layers the chrome on top.
+//
+// Strategy note — we don't try to fight stock Quartz on icon/glyph
+// markup (the SVG icon URIs in stock `callouts.scss` still apply via
+// `--callout-icon`). We only repaint colors, the title bar, and the
+// container.
+//
+// Tokens consumed (from `_tokens.scss`):
+//   * `--surface-1`     — base for the `color-mix` tinted bg
+//   * `--shadow-sm`     — container elevation
+//   * `--ink-0`         — body text inside callouts
+//   * `--accent-soft`/`--accent-strong` — ridden by `note` + `quote`
+//   * `--brain-tier-*`  — re-used so callouts and the graph share hues
+//   * `--callout-note / -info / -abstract / -tip / -success /
+//      -question / -warning / -danger / -failure / -bug / -example /
+//      -quote` — per-type hue palette (one per Quartz callout type),
+//      defined in `_tokens.scss` so cross-file consumers (`_code.scss`'s
+//      success-flash, future home/sidebar callouts) don't depend on
+//      this partial's load order.
+
+// ---------------------------------------------------------------------------
+// Type-color tokens are defined in `_tokens.scss` (light + dark blocks).
+//
+// Single source of truth — devtools-inspecting any callout surfaces the
+// full palette under `:root` alongside the rest of the redesign tokens,
+// and cross-file consumers (`_code.scss`'s success-flash, future
+// home/sidebar callouts) don't depend on this partial's load order.
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Container chrome — applied uniformly via the data-callout attribute
+// ---------------------------------------------------------------------------
+//
+// Stock callouts.scss writes `--color`, `--border`, `--bg` per type.
+// We override those vars to pull from our `--callout-{type}` tokens
+// instead, then add the `--shadow-sm` + `border-left: 3px solid` +
+// tinted bg via `color-mix`.
+//
+// Why mutate stock's `--color`/`--bg` rather than restyle every
+// selector: stock's `.callout-title { color: var(--color) }` (and
+// inner-`<p>` in title, and icon mask color) all read the same vars,
+// so swapping the var values cleanly retints the entire chrome with
+// one block. Less drift surface than re-targeting each child.
+
+.callout {
+  // brain: redesign chrome — the per-type `--color` set in the rules
+  // below picks the hue; this block applies the universal layout.
+  border: 0;
+  border-left: 3px solid var(--type-color, var(--callout-note));
+  border-radius: 6px;
+  // brain: tinted background via `color-mix`. 8% per the plan spec —
+  // visible enough to read as a tinted region, faint enough not to
+  // shout. Falls back to `--surface-1` cleanly when `color-mix` is
+  // unsupported (graceful degradation).
+  background: color-mix(in srgb, var(--type-color, var(--callout-note)) 8%, var(--surface-1));
+  box-shadow: var(--shadow-sm);
+  margin: 1.2rem 0;
+  padding: 0.4rem 1rem;
+  color: var(--ink-0);
+
+  // Override stock's `--color` so the title bar + icon mask track
+  // the redesigned hue. (`--bg` is irrelevant since we paint the
+  // background directly above; we still null it for cleanliness.)
+  --color: var(--type-color, var(--callout-note));
+  --bg: transparent;
+  --border: var(--type-color, var(--callout-note));
+}
+
+// Title bar — uppercase + tracking, type-color tint, tighter padding
+// than stock so the title sits close to the content rather than
+// floating mid-card.
+//
+// brain (Linear): replaced small-caps with uppercase + tracking.
+// Tech aesthetic doesn't have small caps; uppercase reads cleaner
+// against the indigo-violet accent.
+.callout-title {
+  padding: 0.6rem 0;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--type-color, var(--callout-note));
+
+  // The inner `<p>` Quartz wraps around the title text inherits the
+  // type color via stock's `.callout-title-inner > p { color: var(--color) }`.
+  // We re-pin to be explicit and inherit the uppercase treatment.
+  > .callout-title-inner > p {
+    color: inherit;
+    text-transform: inherit;
+    letter-spacing: inherit;
+    margin: 0;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Per-type rules — set --type-color, the chrome above does the rest
+// ---------------------------------------------------------------------------
+//
+// Stock callouts.scss uses the `&[data-callout="x"]` selector pattern
+// inside its top-level `.callout` block. Since this file is loaded
+// AFTER stock's via custom.scss's `@use` order (base → tokens →
+// typography → surface → atmosphere → motion → links → sidebar →
+// article → marginalia → callouts → code → home), we override at
+// equal specificity by using the same `&[data-callout="x"]` shape.
+
+.callout {
+  &[data-callout="note"] {
+    --type-color: var(--callout-note);
+  }
+  &[data-callout="info"],
+  &[data-callout="todo"] {
+    --type-color: var(--callout-info);
+  }
+  &[data-callout="abstract"],
+  &[data-callout="summary"],
+  &[data-callout="tldr"] {
+    --type-color: var(--callout-abstract);
+  }
+  &[data-callout="tip"],
+  &[data-callout="hint"],
+  &[data-callout="important"] {
+    --type-color: var(--callout-tip);
+  }
+  &[data-callout="success"],
+  &[data-callout="check"],
+  &[data-callout="done"] {
+    --type-color: var(--callout-success);
+  }
+  &[data-callout="question"],
+  &[data-callout="help"],
+  &[data-callout="faq"] {
+    --type-color: var(--callout-question);
+  }
+  &[data-callout="warning"],
+  &[data-callout="caution"],
+  &[data-callout="attention"] {
+    --type-color: var(--callout-warning);
+  }
+  &[data-callout="danger"],
+  &[data-callout="error"] {
+    --type-color: var(--callout-danger);
+  }
+  &[data-callout="failure"],
+  &[data-callout="fail"],
+  &[data-callout="missing"] {
+    --type-color: var(--callout-failure);
+  }
+  &[data-callout="bug"] {
+    --type-color: var(--callout-bug);
+  }
+  &[data-callout="example"] {
+    --type-color: var(--callout-example);
+  }
+  &[data-callout="quote"],
+  &[data-callout="cite"] {
+    --type-color: var(--callout-quote);
+  }
+}

brain/quartz_overrides/quartz/styles/brain/_cmdk.scss

@@ -0,0 +1,7 @@
+// Compatibility alias for the historical command-palette partial name.
+//
+// The Phase 5 handoff standardizes the file as `_command_palette.scss`;
+// this wrapper keeps older comments/tools that probe `_cmdk.scss` from
+// failing while the real styles live in the spec-named partial.
+
+@use "./command_palette";

brain/quartz_overrides/quartz/styles/brain/_code.scss

@@ -0,0 +1,208 @@
+// Brain code surface — Lane C of the 2026 commonplace-book redesign.
+//
+// This file is installed at
+// `<vault>/.quartz/quartz/styles/brain/_code.scss` by `brain vault
+// render --overlay` and pulled into the global SCSS via `custom.scss`'s
+// `@use "./brain/code"` line.
+//
+// Scope of this file:
+//
+//   * `<pre>` block surface — rounded `8px`, `--shadow-sm`, padding
+//     `1rem 1.2rem`, `--fs-sm` body. Background `--surface-2` in light,
+//     a deeper espresso in dark (the dark-mode token wiring is in
+//     `_tokens.scss`'s dark-mode `:root[saved-theme="dark"]` block —
+//     `--surface-2` becomes `#2a2418` there).
+//   * Inline `code` polish — Lane A's `_surface.scss` already paints
+//     the background; this file refines padding/radius/no-shrink so
+//     `code` snippets read at the surrounding text size.
+//   * Language label + copy button hover affordance — wires the
+//     `[data-language]` attribute Quartz's `Plugin.SyntaxHighlighting`
+//     stamps on `<pre>` into a CSS-only top-right pill, paired with
+//     a brain-themed copy button injected by `codeCopy.js`.
+//   * Hide stock Quartz `.clipboard-button` — Body.tsx ships a
+//     stock clipboard button that, if left alone, would render next
+//     to our brain-themed `.brain-code-copy`. Our button supersedes
+//     it; this file hides stock's via `display: none`.
+//
+// Tokens consumed (from `_tokens.scss`):
+//   * `--surface-1` / `--surface-2` — code surfaces
+//   * `--shadow-sm`                 — pre elevation
+//   * `--fs-sm`                     — pre font size
+//   * `--ink-1` / `--ink-2`         — label + button colors
+//   * `--rule`                      — button border
+//   * `--accent-soft`               — copy hover
+//   * `--motion-fast`/`--motion-easing` — transitions
+
+// ---------------------------------------------------------------------------
+// 1. <pre> block surface
+// ---------------------------------------------------------------------------
+//
+// Stock Quartz paints `pre { padding: 0 0.5rem; border-radius: 5px;
+// border: 1px solid var(--lightgray); }` (see base.scss). We override
+// to the redesign aesthetic: bigger radius, generous padding, soft
+// shadow, no border. Background pulls from the surface scale —
+// `--surface-2` is the third-tier paper surface in light, the espresso
+// `#2a2418` in dark (see `_tokens.scss`).
+
+article pre {
+  position: relative;
+  background: var(--surface-2);
+  border: 0;
+  border-radius: 8px;
+  box-shadow: var(--shadow-sm);
+  padding: 1rem 1.2rem;
+  font-size: var(--fs-sm);
+  // Stock Quartz keeps `<pre>` content as a single line in some
+  // mermaid contexts; cap with an explicit overflow rule so wide
+  // code scrolls horizontally rather than blowing out the column.
+  overflow-x: auto;
+  margin: 1.2rem 0;
+  // brain: line-height tuned for code reading. Stock leaves it at the
+  // article's `1.7`, which is far too loose for monospace.
+  line-height: 1.55;
+}
+
+// Reset the inner `<code>` so its padding doesn't double-pad inside
+// the pre. Stock Quartz adds `padding: 0.5rem 0` on `pre > code`;
+// keep that for line-number gutters but trim outer.
+article pre > code {
+  padding: 0;
+  background: none;
+  font-size: inherit;
+}
+
+// ---------------------------------------------------------------------------
+// 2. Inline `code` polish
+// ---------------------------------------------------------------------------
+//
+// Lane A's `_surface.scss` already writes `code:not(pre code) { background: var(--surface-2) }`.
+// This block refines the box: tighter padding, smaller radius, and
+// `font-size: 0.92em` so `code` snippets don't visibly shrink against
+// surrounding running serif text. The 0.92em is deliberate — pure
+// `1em` reads chunky against Newsreader's optical-sized body, while
+// the stock `0.9em` reads tiny.
+
+code:not(pre code) {
+  padding: 0.1rem 0.35rem;
+  border-radius: 3px;
+  font-size: 0.92em;
+  // Reset stock Quartz's `color: var(--dark)` so inline code rides the
+  // ink scale for theme consistency. Falls back to the body color
+  // otherwise.
+  color: var(--ink-0);
+}
+
+// ---------------------------------------------------------------------------
+// 3. Hide stock Quartz `.clipboard-button`
+// ---------------------------------------------------------------------------
+//
+// `Body.tsx` injects a stock clipboard button on every `<pre>`. Our
+// brain copy button (injected by `codeCopy.js`) supersedes it. Hiding
+// stock's avoids two-buttons-side-by-side. The stock script's click
+// behavior still functions if accessed programmatically; we only hide
+// the visual chrome.
+//
+// brain (Lane C audit fix 2026-05-02): scoped to `article pre
+// .clipboard-button`. The added selector chain (3,0,2 vs stock's
+// 0,1,0) wins on specificity without `!important`, and confines the
+// rule to article code blocks — popovers / mermaid diagrams / future
+// non-pre clipboard hooks won't be globally hidden.
+
+article pre .clipboard-button {
+  display: none;
+}
+
+// ---------------------------------------------------------------------------
+// 4. Brain copy button + language label hover area
+// ---------------------------------------------------------------------------
+//
+// Both the copy button and the language label live in the top-right
+// of the `<pre>`. Together they form a small chrome that fades in on
+// hover. Default: opacity 0; on `pre:hover` or `pre:focus-within`:
+// opacity 1. `focus-within` covers keyboard users tabbing into the
+// button.
+//
+// The language label is pure CSS, driven by `pre[data-language]`
+// (Quartz's `Plugin.SyntaxHighlighting` stamps the attribute). Falls
+// back gracefully when absent — the `::before` only renders when the
+// attribute is present, so untyped code blocks stay clean.
+
+article pre[data-language]::before {
+  content: attr(data-language);
+  position: absolute;
+  top: 0.5rem;
+  // brain: room for the 64px-wide copy button at the same right edge.
+  // The label sits to the LEFT of the button so they don't overlap.
+  right: 4.2rem;
+  font-family: var(--codeFont);
+  font-size: var(--fs-xs);
+  color: var(--ink-2);
+  // brain (Linear): code-style label — lowercase mono instead of
+  // small-caps. Reads as a tech tag, not an editorial caption.
+  text-transform: lowercase;
+  letter-spacing: 0.02em;
+  pointer-events: none;
+  opacity: 0;
+  transition: opacity var(--motion-fast) var(--motion-easing);
+}
+
+article pre:hover[data-language]::before,
+article pre:focus-within[data-language]::before {
+  opacity: 1;
+}
+
+// The injected copy button — class is `.brain-code-copy`, written
+// by `codeCopy.js`. ARIA label set there too. Visual rules here.
+.brain-code-copy {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.3rem;
+  padding: 0.2rem 0.55rem;
+  background: var(--surface-1);
+  color: var(--ink-1);
+  border: 1px solid var(--rule);
+  border-radius: 4px;
+  // brain (Linear): mono copy button — Geist Mono lowercase tracks
+  // the language label's tech tag treatment.
+  font-family: var(--codeFont);
+  font-size: var(--fs-xs);
+  text-transform: lowercase;
+  letter-spacing: 0.02em;
+  cursor: pointer;
+  opacity: 0;
+  transition:
+    opacity var(--motion-fast) var(--motion-easing),
+    background var(--motion-fast) var(--motion-easing),
+    color var(--motion-fast) var(--motion-easing);
+
+  &:hover {
+    background: var(--accent-soft);
+    color: var(--ink-0);
+  }
+
+  &:focus-visible {
+    outline: 2px solid var(--accent-strong);
+    outline-offset: 1px;
+    opacity: 1;
+  }
+
+  // brain: the "Copied" pulse swaps the label text via JS; the chip
+  // itself uses the success-callout color briefly. `--callout-success`
+  // is defined in `_tokens.scss` (loaded first via `custom.scss` order),
+  // so the var is always resolved here — no fallback hex needed.
+  &.is-copied {
+    background: color-mix(in srgb, var(--callout-success) 18%, var(--surface-1));
+    color: var(--callout-success);
+    border-color: var(--callout-success);
+    opacity: 1;
+  }
+}
+
+// Reveal on hover or keyboard focus on the surrounding pre.
+article pre:hover .brain-code-copy,
+article pre:focus-within .brain-code-copy {
+  opacity: 1;
+}