@savvy-web/bundler 2.1.30 → 2.2.0

package/README.md

@@ -326,7 +326,7 @@ That gives you `readonly __PACKAGE_VERSION__?: string` on `NodeJS.ProcessEnv`
 - **Build targets** — `dev` for local linking, `prod` for a resolved publishable manifest (which also emits an API Extractor api-model) and `exe` for SEA binaries, on disjoint `dist/dev` and `dist/prod` output paths for clean caching.
 - **Bundled declarations** — per-module JavaScript with a single rolled-up `.d.ts` per public entry, so re-exported types stay reachable through your published export subpaths.
 - **Ambient type exports** — a types-only `exports` entry backed by a hand-authored `.d.ts` (a bare string or `{ types }`) is copied verbatim into every target dir with its manifest pointer rewritten to a key-derived path, no custom `transform` or post-build copy needed; the declaration must be self-contained and may not be mixed with a runtime source.
-- **Shared tsconfig base** — extend `@savvy-web/bundler/ecma.json` for the ESNext/NodeNext/strict settings the build expects.
+- **Shared tsconfig base** — extend `@savvy-web/bundler/tsconfig/ecma.json` for the ESNext/NodeNext/strict settings the build expects.
 - **Manifest resolution** — `catalog:` and `workspace:` specifiers are resolved against the workspace for the published target, and preserved for the linked dev target.
 - **Multi-target publishing** — a `publishConfig.targets` map publishes one package to several registries or under several names; `--target prod` builds the distinct byte variants and writes a `targets.json` binding for the release step.
 - **Executable binaries** — an `exe` config compiles SEA binaries from a bin entry via `@tsdown/exe`, inferring the platform from the package's `os`/`cpu` when targets are omitted.

package/assets/LICENSE-Inter.txt

@@ -0,0 +1,92 @@
+Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION AND CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/index.d.ts

@@ -1,4 +1,4 @@
-import { AmbientDtsEntry, BuildFormat, BuildPlatform, BuildReport, BuildTargetGroupsOptions, CssOptions, ExeConfig, GenerateMetaOptions, Json, JsxConfig, LooseFiles, MetaOptions, MetaResult, NextVersions, PublishTargets, RenderedOutput, RunExeBuildOptions, TargetGroupRef, TargetResolution, TsconfigJsx, defaultManifestTransform, extractAmbientDts } from "@savvy-web/tsdown-plugins";
+import { AmbientDtsEntry, BuildFormat, BuildPlatform, BuildReport, BuildTargetGroupsOptions, CssOptions, ExeConfig, GenerateMetaOptions, Json, JsxConfig, LooseFiles, MetaOptions, MetaResult, NextVersions, OgImageInfo, PublishTargets, RenderedOutput, RunExeBuildOptions, TargetGroupRef, TargetResolution, TsconfigJsx, TsdoctorMetaOptions, defaultManifestTransform, extractAmbientDts } from "@savvy-web/tsdown-plugins";
 import { Plugin, Plugin as Plugin$1 } from "rolldown";
 //#region src/config.d.ts
 /** @public */
@@ -284,5 +284,5 @@ declare function runBuild(config: BuildConfig, options: RunOptions): Promise<voi
  */
 declare function build(input?: BuildConfigInput, overrides?: Partial<RunOptions>): Promise<void>;
 //#endregion
-export { type AmbientDtsEntry, type BuildConfig, type BuildConfigInput, type BuildEntryOverride, type OutputConfig, type ParsedArgs, type Plugin, type RunOptions, build, defaultManifestTransform, defineBuild, extractAmbientDts, parseArgs, runBuild };
+export { type AmbientDtsEntry, type BuildConfig, type BuildConfigInput, type BuildEntryOverride, type OgImageInfo, type OutputConfig, type ParsedArgs, type Plugin, type RunOptions, type TsdoctorMetaOptions, build, defaultManifestTransform, defineBuild, extractAmbientDts, parseArgs, runBuild };
 //# sourceMappingURL=index.d.ts.map

package/og.d.ts

@@ -0,0 +1,39 @@
+import { OgImageInfo } from "@savvy-web/tsdown-plugins";
+//#region src/og.d.ts
+/**
+ * Colors for the default Open Graph card.
+ *
+ * @public
+ */
+interface SatoriOgOptions {
+  /** The project-name accent (CSS color). */
+  readonly accent?: string | undefined;
+  readonly background?: string | undefined;
+  readonly foreground?: string | undefined;
+}
+/**
+ * Build-time Open Graph image renderers for `meta.tsdoctor.openGraph.generate`.
+ *
+ * @remarks
+ * `satori()` returns the default card: project name, package name and version, tagline,
+ * 1200×630 PNG, rendered through the optional peers `satori` and `@resvg/resvg-js`. The peers
+ * load lazily on first render, so a build that does not generate an image never needs them.
+ *
+ * @example
+ * ```ts
+ * import { defineBuild } from "@savvy-web/bundler";
+ * import { ogImage } from "@savvy-web/bundler/og";
+ *
+ * export default defineBuild({
+ *   meta: { tsdoctor: { tagline: "Every shape", openGraph: { generate: ogImage.satori() } } },
+ * });
+ * ```
+ *
+ * @public
+ */
+declare const ogImage: {
+  satori(options?: SatoriOgOptions): (info: OgImageInfo) => Promise<Uint8Array>;
+};
+//#endregion
+export { SatoriOgOptions, ogImage };
+//# sourceMappingURL=og.d.ts.map

package/og.js

@@ -0,0 +1,129 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+
+//#region src/og.ts
+/**
+* The bundled Inter SemiBold face (SIL OFL 1.1; see `assets/LICENSE-Inter.txt`). Resolved
+* relative to THIS module: the built `og.js` sits beside `assets/` at the package root, while the
+* source `src/og.ts` reaches it through `public/`, so both candidates are tried.
+*/
+const FONT_CANDIDATES = [new URL("./assets/Inter-SemiBold.ttf", import.meta.url), new URL("../public/assets/Inter-SemiBold.ttf", import.meta.url)];
+function fontPath() {
+	for (const candidate of FONT_CANDIDATES) {
+		const path = fileURLToPath(candidate);
+		if (existsSync(path)) return path;
+	}
+	throw new Error("ogImage.satori() could not locate its bundled font assets/Inter-SemiBold.ttf");
+}
+async function loadRenderers() {
+	try {
+		const [{ default: satori }, { Resvg }] = await Promise.all([import("satori"), import("@resvg/resvg-js")]);
+		return {
+			satori,
+			Resvg
+		};
+	} catch (cause) {
+		throw new Error("ogImage.satori() needs the optional peers satori and @resvg/resvg-js; install both to generate Open Graph images", { cause });
+	}
+}
+function card(info, colors) {
+	const text = (style, children) => ({
+		type: "div",
+		props: {
+			style,
+			children
+		}
+	});
+	return {
+		type: "div",
+		props: {
+			style: {
+				display: "flex",
+				flexDirection: "column",
+				justifyContent: "space-between",
+				width: "100%",
+				height: "100%",
+				padding: 64,
+				background: colors.background,
+				color: colors.foreground,
+				fontFamily: "Inter"
+			},
+			children: [
+				text({
+					fontSize: 32,
+					color: colors.accent
+				}, info.project?.name ?? ""),
+				{
+					type: "div",
+					props: {
+						style: {
+							display: "flex",
+							flexDirection: "column",
+							gap: 16
+						},
+						children: [text({
+							fontSize: 72,
+							fontWeight: 600
+						}, info.name), text({
+							fontSize: 36,
+							opacity: .8
+						}, info.tagline ?? info.description ?? "")]
+					}
+				},
+				text({
+					fontSize: 28,
+					opacity: .7
+				}, `${info.packageName}@${info.version}`)
+			]
+		}
+	};
+}
+/**
+* Build-time Open Graph image renderers for `meta.tsdoctor.openGraph.generate`.
+*
+* @remarks
+* `satori()` returns the default card: project name, package name and version, tagline,
+* 1200×630 PNG, rendered through the optional peers `satori` and `@resvg/resvg-js`. The peers
+* load lazily on first render, so a build that does not generate an image never needs them.
+*
+* @example
+* ```ts
+* import { defineBuild } from "@savvy-web/bundler";
+* import { ogImage } from "@savvy-web/bundler/og";
+*
+* export default defineBuild({
+*   meta: { tsdoctor: { tagline: "Every shape", openGraph: { generate: ogImage.satori() } } },
+* });
+* ```
+*
+* @public
+*/
+const ogImage = { satori(options = {}) {
+	const colors = {
+		accent: options.accent ?? "#38bdf8",
+		background: options.background ?? "#0f172a",
+		foreground: options.foreground ?? "#f8fafc"
+	};
+	return async (info) => {
+		const { satori, Resvg } = await loadRenderers();
+		const font = await readFile(fontPath());
+		const svg = await satori(card(info, colors), {
+			width: 1200,
+			height: 630,
+			fonts: [{
+				name: "Inter",
+				data: font,
+				weight: 600,
+				style: "normal"
+			}]
+		});
+		return new Uint8Array(new Resvg(svg, { fitTo: {
+			mode: "width",
+			value: 1200
+		} }).render().asPng());
+	};
+} };
+
+//#endregion
+export { ogImage };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/bundler",
-	"version": "2.1.30",
+	"version": "2.2.0",
 	"private": false,
 	"description": "Zero-config tsdown-based bundler for Silk Suite TypeScript packages",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/bundler",
@@ -28,22 +28,29 @@
 		"./env": {
 			"types": "./env.d.ts"
 		},
+		"./og": {
+			"types": "./og.d.ts",
+			"import": "./og.js",
+			"default": "./og.js"
+		},
 		"./tsconfig/ecma.json": "./tsconfig/ecma.json",
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@savvy-web/tsdown-plugins": "2.5.11",
+		"@savvy-web/tsdown-plugins": "2.6.0",
 		"@tsdown/exe": "^0.22.14",
 		"effect": "4.0.0-rc.109",
 		"rolldown": "^1.2.6",
 		"tsdown": "^0.22.14"
 	},
 	"peerDependencies": {
+		"@resvg/resvg-js": "^2.6.2",
 		"@types/node": "^26.4.0",
 		"@types/react": "^19.2.0",
 		"@types/react-dom": "^19.2.0",
 		"react": "^19.2.0",
 		"react-dom": "^19.2.0",
+		"satori": "^0.33.4",
 		"typescript": "^7.0.0"
 	},
 	"peerDependenciesMeta": {
@@ -58,6 +65,12 @@
 		},
 		"react-dom": {
 			"optional": true
+		},
+		"@resvg/resvg-js": {
+			"optional": true
+		},
+		"satori": {
+			"optional": true
 		}
 	}
 }

package/run.js

@@ -277,6 +277,7 @@ async function runBuild(config, options) {
 				meta: config.meta ?? {},
 				collector,
 				ci,
+				...resolution !== void 0 ? { targets: resolution.targets } : {},
 				...options.generateMeta !== void 0 ? { generateMeta: options.generateMeta } : {},
 				...options.resolveNextVersions !== void 0 ? { resolveNextVersions: options.resolveNextVersions } : {}
 			});