@vdaluz/astro-og-cards 1.1.2 → 1.1.3

package/README.md

@@ -63,7 +63,7 @@ import { generateCard } from '@vdaluz/astro-og-cards';
 const png = await generateCard(inlineStyledHtml); // Buffer, 1200x630 PNG
 ```
 
-`markup` must use **inline styles, not `<style>` blocks or CSS classes** - `satori-html` (the HTML-to-Satori adapter) only reads inline styles. A hand-designed card with `<style>` + classes needs manual translation to inline styles first; see `src/assets/fixtures/imperfectSystemsCard.ts` for a worked example (imperfectsystems.com's real default card, translated).
+`markup` must use **inline styles, not `<style>` blocks or CSS classes** - `satori-html` (the HTML-to-Satori adapter) only reads inline styles. A hand-designed card with `<style>` + classes needs manual translation to inline styles first; see `fixtures/imperfectSystemsCard.ts` for a worked example (imperfectsystems.com's real default card, translated).
 
 ### Example
 
@@ -77,7 +77,7 @@ Bundles a default static (non-variable) font, [Space Mono](https://github.com/go
 
 - **Use `sharp` for SVG->PNG, not `@resvg/resvg-js`.** resvg-js 2.6.2 (latest stable as of writing) native-panics (uncatchable Rust abort, not a JS exception) on Satori's `feDropShadow`/`feGaussianBlur` filter output - i.e. any `box-shadow` or `text-shadow` in the source markup. Confirmed via binary search against a real shadow-bearing design; independent of shadow color format (hex vs `rgba()`).
 - **Variable fonts fail to parse.** Satori's bundled font parser (`@shuding/opentype.js`) can't read variable-font files (e.g. macOS's system SF Mono, which has an `fvar` table). Always pass a static font weight, never a system font reference.
-- **The bundled default font is embedded as base64 in `src/lib/spaceMonoData.ts`, not read from a sibling `.ttf` file at runtime.** Confirmed via a real `astro build`: Vite/Rollup bundles this package's source into a new chunk file at a different physical location in the consumer's build output, so any `import.meta.url`-relative disk read breaks there (regardless of whether it's written as `new URL(...)` or a plain `path.join` - both are equally broken, since the problem is the module's *code* being relocated, not a specific path-construction pattern Vite's static analyzer happens to intercept). The raw `.ttf` files still live in `src/assets/fonts/` for provenance/license visibility and to regenerate the base64 if the font is ever updated; they aren't imported by any code path.
+- **The bundled default font is embedded as base64 in `src/lib/spaceMonoData.ts`, not read from a sibling `.ttf` file at runtime.** Confirmed via a real `astro build`: Vite/Rollup bundles this package's source into a new chunk file at a different physical location in the consumer's build output, so any `import.meta.url`-relative disk read breaks there (regardless of whether it's written as `new URL(...)` or a plain `path.join` - both are equally broken, since the problem is the module's *code* being relocated, not a specific path-construction pattern Vite's static analyzer happens to intercept). The raw `.ttf` files live in the repo's root-level `assets/fonts/` (kept for provenance/license visibility and to regenerate the base64 if the font is ever updated, but outside `src/` so the npm package doesn't publish them - they aren't imported by any code path). The OFL license text ships alongside the base64 module itself at `src/lib/OFL.txt`, since that module is the actual redistribution of the font data.
 - `satori-html` is stale (last published Dec 2022) but works correctly against the current Satori API as of this writing - the smoke test (`npm test`) is the tripwire for a future break.
 - **`satori-html` unconditionally trims every text node's value**, so a literal space in a text node right before an inline-styled `<span>` is silently dropped (and a non-breaking space doesn't survive either - JS `trim()` treats it as whitespace too). Give the following span an explicit `margin-left` (or the preceding element a `margin-right`) instead of relying on a whitespace character between elements.
 
@@ -85,6 +85,20 @@ Bundles a default static (non-variable) font, [Space Mono](https://github.com/go
 
 Issues welcome. PRs by discussion - open an issue first for anything beyond a typo or docs fix.
 
+### Releasing
+
+Maintainer-only. Releases are tag-triggered and published to npm via GitHub Actions (Trusted
+Publishing / OIDC, no token secret):
+
+1. Test before tagging: `npm pack`, install the tarball into a scratch Astro app (or a consumer
+   locally), `astro check && astro build`.
+2. Bump `version` in `package.json`, commit.
+3. Tag `vX.Y.Z` and push the tag. Pushing the tag runs `.github/workflows/publish.yml`, which
+   type-checks, tests, verifies the tag matches `package.json`'s version, and only then runs
+   `npm publish`.
+4. Confirm the version is live: `npm view @vdaluz/astro-og-cards version`. Consumers bump their
+   own semver pin once it's confirmed live - see this package's CHANGELOG.md for what changed.
+
 ## Consumers
 
 - [vdaluz.com](https://vdaluz.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vdaluz/astro-og-cards",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Build-time OG/social-card generation (satori + sharp) and meta-tag emission for Astro - proven in production on vdaluz.com and imperfectsystems.com.",
   "keywords": [
     "astro",
@@ -44,9 +44,9 @@
     "sharp": "^0.35.0"
   },
   "devDependencies": {
-    "@astrojs/check": "^0.9.9",
+    "@astrojs/check": "^0.9.10",
     "@types/node": "^26.1.1",
-    "astro": "^7.1.3",
+    "astro": "^7.2.4",
     "typescript": "^6.0.3"
   }
 }

package/src/lib/spaceMonoData.ts

@@ -1,4 +1,4 @@
-// Base64-encoded Space Mono (OFL-licensed, see ../assets/fonts/OFL.txt), embedded directly
+// Base64-encoded Space Mono (OFL-licensed, see ./OFL.txt), embedded directly
 // rather than read from a sibling file: Vite/Rollup bundles this module into a
 // different physical chunk location in the consumer's build output, so any
 // import.meta.url-relative disk read breaks regardless of how the path is

package/src/assets/fixtures/imperfectSystemsCard.ts

@@ -1,33 +0,0 @@
-/**
- * Inlined equivalent of imperfectsystems.com's real og-default.html
- * (src/assets/og/og-default.html in that repo) - satori-html requires inline
- * styles, not <style> blocks/classes, so this is hand-translated from the
- * original class-based design. Used as the smoke-test fixture because it's the
- * realistic worst case: nested flex, gradients, border-radius, and - critically -
- * both box-shadow and text-shadow, which is what caught the resvg-js crash during
- * this package's toolchain spike (see README's Known gotchas).
- */
-export const imperfectSystemsCard = `
-<div style="width:1200px;height:630px;display:flex;align-items:center;justify-content:center;background:#0a0a0a;font-family:'Space Mono';position:relative;">
-  <div style="position:absolute;inset:0;display:flex;background-image:radial-gradient(circle at 50% 40%, rgba(0,255,0,0.06), transparent 60%);"></div>
-  <div style="position:relative;width:960px;display:flex;flex-direction:column;background:#141414;border:1px solid #3a3a3a;border-radius:14px;box-shadow:0 30px 80px -20px rgba(0,0,0,0.8), 0 0 60px -20px rgba(0,255,0,0.25);overflow:hidden;">
-    <div style="display:flex;align-items:center;gap:9px;padding:16px 20px;border-bottom:1px solid #2a2a2a;background:#1a1a1a;">
-      <span style="display:flex;width:13px;height:13px;border-radius:50%;background:#ff5f56;"></span>
-      <span style="display:flex;width:13px;height:13px;border-radius:50%;background:#ffbd2e;"></span>
-      <span style="display:flex;width:13px;height:13px;border-radius:50%;background:#27c93f;"></span>
-      <span style="margin-left:12px;color:#9ca3af;font-size:17px;letter-spacing:0.02em;">imperfect-systems — zsh</span>
-    </div>
-    <div style="display:flex;flex-direction:column;padding:44px 48px 52px;">
-      <div style="color:#9ca3af;font-size:26px;line-height:1.9;letter-spacing:0.01em;">imperfect-systems ~ %</div>
-      <div style="display:flex;font-size:34px;line-height:1.8;color:#00ff00;text-shadow:0 0 10px rgba(0,255,0,0.55), 0 0 24px rgba(0,255,0,0.3);letter-spacing:0.005em;">
-        <span style="color:#80ff80;margin-right:14px;">$</span><span style="margin-right:14px;">./run</span><span style="color:#80ff80;">--software --games --music</span>
-      </div>
-      <div style="display:flex;margin-top:40px;justify-content:space-between;align-items:baseline;">
-        <div style="display:flex;font-size:28px;font-weight:700;color:#ededed;letter-spacing:0.04em;">
-          <span style="color:#00ff00;text-shadow:0 0 10px rgba(0,255,0,0.4);">Imperfect</span> Systems
-        </div>
-        <div style="color:#6b7280;font-size:20px;letter-spacing:0.04em;">imperfectsystems.com</div>
-      </div>
-    </div>
-  </div>
-</div>`;