@lovrozagar/flare 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lovro Žagar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# Flare
+
+Solid meta-framework. Server-driven, NDJSON streaming, `renderToStream`.
+
+```ts
+import { createPage } from "@lovrozagar/flare/page";
+import { createRouter } from "@lovrozagar/flare/router";
+import { flare } from "@lovrozagar/flare/plugins";
+```
+
+See the repo root README for layout, develop commands, and the consumer proof.

package/package.json

@@ -0,0 +1,146 @@
+{
+	"name": "@lovrozagar/flare",
+	"version": "0.1.0",
+	"description": "Solid meta-framework. Server-driven, NDJSON streaming, renderToStream.",
+	"keywords": [
+		"flare",
+		"meta-framework",
+		"ndjson",
+		"solid",
+		"solidjs",
+		"ssr",
+		"streaming",
+		"vite"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/lovrozagar/flare"
+	},
+	"files": [
+		"src",
+		"scripts"
+	],
+	"type": "module",
+	"sideEffects": false,
+	"exports": {
+		".": "./src/route-builder/index.ts",
+		"./await": "./src/await.ts",
+		"./broadcast": "./src/broadcast/index.ts",
+		"./client": "./src/client/index.ts",
+		"./client-only": "./src/create-client-only-fn.ts",
+		"./codegen": "./src/codegen/index.ts",
+		"./direction": "./src/direction.ts",
+		"./errors": "./src/errors/index.ts",
+		"./fonts": "./src/fonts/index.ts",
+		"./fonts/*": "./src/fonts/*.ts",
+		"./form": "./src/form/index.tsx",
+		"./generators": "./src/generators/index.ts",
+		"./hydrate": "./src/hydrate/index.tsx",
+		"./i18n": "./src/i18n/index.ts",
+		"./image": "./src/image.ts",
+		"./intercept-outlet": "./src/intercept-outlet.ts",
+		"./isomorphic": "./src/create-isomorphic-fn.ts",
+		"./layout": "./src/create-layout.ts",
+		"./lazy": "./src/lazy/index.tsx",
+		"./link": "./src/link/index.tsx",
+		"./locale": "./src/locale.ts",
+		"./middleware": "./src/middleware/index.ts",
+		"./middleware/api-proxy": "./src/middleware/builtins/api-proxy.ts",
+		"./middleware/cdn-proxy": "./src/middleware/builtins/cdn-proxy.ts",
+		"./middleware/i18n": "./src/middleware/builtins/i18n.ts",
+		"./middleware/keepalive": "./src/middleware/builtins/keepalive.ts",
+		"./middleware/markdown-negotiation": "./src/middleware/builtins/markdown-negotiation.ts",
+		"./middleware/static-assets": "./src/middleware/builtins/static-assets.ts",
+		"./mount": "./src/mount/index.ts",
+		"./navigation-progress": "./src/navigation-progress.ts",
+		"./outlet": "./src/outlet/index.tsx",
+		"./page": "./src/create-page.ts",
+		"./path-segment": "./src/create-path-segment.ts",
+		"./plugins": "./src/plugins/index.ts",
+		"./prerender": "./src/prerender/index.ts",
+		"./query-client": "./src/create-query-client-getter.ts",
+		"./reset-css": "./src/reset-css.ts",
+		"./revalidation": "./src/revalidation/index.ts",
+		"./rewrite": "./src/rewrite/index.ts",
+		"./root-layout": "./src/create-root-layout.ts",
+		"./router": "./src/router.ts",
+		"./search-engine": "./src/search-engine/index.ts",
+		"./security": "./src/security/index.ts",
+		"./server": "./src/server/index.ts",
+		"./server-context": {
+			"workerd": "./src/server-context/index.ts",
+			"node": "./src/server-context/index.ts",
+			"browser": "./src/server-context/browser.ts",
+			"default": "./src/server-context/index.ts"
+		},
+		"./server-fn": "./src/server-fn/index.ts",
+		"./server-fn-query": "./src/server-fn-query.ts",
+		"./server-only": "./src/create-server-only-fn.ts",
+		"./sitemap": "./src/sitemap/index.ts",
+		"./store": "./src/store/index.ts",
+		"./store-filesystem": "./src/store/filesystem.ts",
+		"./styles": "./src/styles/index.ts",
+		"./suspense-query": "./src/use-suspense-query.ts",
+		"./testing": "./src/testing.ts",
+		"./theme": "./src/theme.ts",
+		"./tracing": "./src/tracing/index.ts",
+		"./validation": "./src/validation/index.ts",
+		"./view-transition-css": "./src/view-transition-css.ts",
+		"./virtual-types": "./src/plugins/virtual.d.ts"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"bench": "vitest bench",
+		"fonts:generate": "bun run scripts/populate-fonts.ts",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"type:check": "tsc --noEmit -p tsconfig.src.json",
+		"type:check:tests": "NODE_OPTIONS='--max-old-space-size=4096' tsc --noEmit"
+	},
+	"devDependencies": {
+		"@babel/parser": "catalog:",
+		"@capsizecss/metrics": "catalog:",
+		"@formatjs/intl-localematcher": "catalog:",
+		"@solidjs/testing-library": "catalog:",
+		"@tanstack/query-broadcast-client-experimental": "5.101.2",
+		"@tanstack/solid-query": "catalog:",
+		"@types/negotiator": "catalog:",
+		"isbot": "catalog:",
+		"jsdom": "catalog:",
+		"magic-string": "catalog:",
+		"negotiator": "catalog:",
+		"node-html-markdown": "catalog:",
+		"oxc-parser": "catalog:",
+		"oxc-resolver": "catalog:",
+		"sharp": "catalog:",
+		"solid-js": "catalog:",
+		"typescript": "catalog:",
+		"vite": "catalog:",
+		"vite-plugin-solid": "catalog:",
+		"vitest": "catalog:"
+	},
+	"peerDependencies": {
+		"@babel/parser": ">=8.0.0",
+		"@formatjs/intl-localematcher": ">=0.6.0",
+		"@tanstack/query-broadcast-client-experimental": ">=5.0.0",
+		"@tanstack/solid-query": ">=5.0.0",
+		"isbot": ">=5.0.0",
+		"magic-string": ">=0.30.0",
+		"negotiator": ">=1.0.0",
+		"node-html-markdown": ">=1.3.0",
+		"oxc-parser": ">=0.139.0",
+		"oxc-resolver": ">=11.23.0",
+		"sharp": ">=0.33.0",
+		"solid-js": ">=1.9.0",
+		"vite": ">=8.0.0",
+		"vite-plugin-solid": ">=2.0.0"
+	},
+	"peerDependenciesMeta": {
+		"node-html-markdown": {
+			"optional": true
+		}
+	}
+}

package/scripts/download-fonts.ts

@@ -0,0 +1,136 @@
+/**
+ * Downloads woff2 font files from CDN URLs listed in font-urls.gen.json.
+ *
+ * Usage:
+ *   bun run scripts/download-fonts.ts <outdir>
+ *   bun run scripts/download-fonts.ts ../../flare-e2e/public
+ *   bun run scripts/download-fonts.ts ../../flare-e2e/public --latin-only
+ *   bun run scripts/download-fonts.ts ../../flare-e2e/public --force
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+
+const BATCH_SIZE = 10;
+
+interface CliArgs {
+	force: boolean;
+	latinOnly: boolean;
+	outDir: string;
+}
+
+function parseArgs(): CliArgs {
+	const args = process.argv.slice(2);
+	const flags = new Set(args.filter((a) => a.startsWith("--")));
+	const positional = args.filter((a) => !a.startsWith("--"));
+
+	const outDir = positional[0];
+	if (!outDir) {
+		console.error("Usage: bun run scripts/download-fonts.ts <outdir> [--latin-only] [--force]");
+		process.exit(1);
+	}
+
+	return {
+		force: flags.has("--force"),
+		latinOnly: flags.has("--latin-only"),
+		outDir: resolve(outDir),
+	};
+}
+
+async function downloadBatch(
+	entries: Array<[localPath: string, cdnUrl: string]>,
+	outDir: string,
+	force: boolean,
+): Promise<{ downloaded: number; skipped: number; failed: number }> {
+	let downloaded = 0;
+	let skipped = 0;
+	let failed = 0;
+
+	const results = await Promise.allSettled(
+		entries.map(async ([localPath, cdnUrl]) => {
+			const dest = join(outDir, localPath);
+
+			if (!force && existsSync(dest)) {
+				skipped++;
+				return;
+			}
+
+			const dir = dirname(dest);
+			if (!existsSync(dir)) {
+				mkdirSync(dir, { recursive: true });
+			}
+
+			const res = await fetch(cdnUrl);
+			if (!res.ok) {
+				console.error(`  FAIL ${localPath} (${res.status})`);
+				failed++;
+				return;
+			}
+
+			const buffer = await res.arrayBuffer();
+			writeFileSync(dest, Buffer.from(buffer));
+			downloaded++;
+		}),
+	);
+
+	for (const result of results) {
+		if (result.status === "rejected") {
+			console.error(`  ERROR: ${result.reason}`);
+			failed++;
+		}
+	}
+
+	return { downloaded, failed, skipped };
+}
+
+async function main(): Promise<void> {
+	const { force, latinOnly, outDir } = parseArgs();
+
+	const urlMapPath = join(import.meta.dirname ?? ".", "..", "src", "fonts", "font-urls.gen.json");
+	if (!existsSync(urlMapPath)) {
+		console.error(`font-urls.gen.json not found at ${urlMapPath}`);
+		console.error("Run scripts/populate-fonts.ts first to generate it.");
+		process.exit(1);
+	}
+
+	const raw = readFileSync(urlMapPath, "utf-8");
+	const urlMap = JSON.parse(raw) as Record<string, string>;
+
+	let entries = Object.entries(urlMap);
+
+	if (latinOnly) {
+		entries = entries.filter(([localPath]) => {
+			const fileName = localPath.split("/").pop() ?? "";
+			return fileName.startsWith("latin-") || fileName === "latin.woff2";
+		});
+	}
+
+	const total = entries.length;
+	console.log(`Downloading ${total} woff2 files to ${outDir}`);
+	if (latinOnly) console.log("  (latin-only mode)");
+	if (force) console.log("  (force re-download)");
+
+	let totalDownloaded = 0;
+	let totalSkipped = 0;
+	let totalFailed = 0;
+
+	for (let i = 0; i < entries.length; i += BATCH_SIZE) {
+		const batch = entries.slice(i, i + BATCH_SIZE);
+		const batchEnd = Math.min(i + BATCH_SIZE, total);
+		process.stdout.write(`  [${batchEnd}/${total}] `);
+
+		const { downloaded, failed, skipped } = await downloadBatch(batch, outDir, force);
+		totalDownloaded += downloaded;
+		totalSkipped += skipped;
+		totalFailed += failed;
+
+		console.log(`+${downloaded} downloaded, ${skipped} skipped, ${failed} failed`);
+	}
+
+	console.log(`\nDone: ${totalDownloaded} downloaded, ${totalSkipped} skipped, ${totalFailed} failed`);
+
+	if (totalFailed > 0) {
+		process.exit(1);
+	}
+}
+
+main().catch(console.error);