@webstir-io/webstir-frontend 0.1.40 → 0.1.41

package/dist/utils/fs.d.ts

@@ -1,11 +1,12 @@
-import fs from 'fs-extra';
-export declare function ensureDir(path: string): Promise<void>;
-export declare function emptyDir(path: string): Promise<void>;
-export declare function remove(path: string): Promise<void>;
+import type { Stats } from 'node:fs';
+export declare function ensureDir(targetPath: string): Promise<void>;
+export declare function emptyDir(targetPath: string): Promise<void>;
+export declare function remove(targetPath: string): Promise<void>;
 export declare function copy(source: string, destination: string): Promise<void>;
-export declare function pathExists(path: string): Promise<boolean>;
-export declare function stat(path: string): Promise<fs.Stats>;
-export declare function readJson<T>(path: string): Promise<T | null>;
-export declare function writeJson(path: string, data: unknown): Promise<void>;
-export declare function readFile(path: string): Promise<string>;
-export declare function writeFile(path: string, contents: string): Promise<void>;
+export declare function pathExists(targetPath: string): Promise<boolean>;
+export declare function stat(targetPath: string): Promise<Stats>;
+export declare function readJson<T>(targetPath: string): Promise<T | null>;
+export declare function writeJson(targetPath: string, data: unknown): Promise<void>;
+export declare function readFile(targetPath: string): Promise<string>;
+export declare function readBinaryFile(targetPath: string): Promise<Uint8Array>;
+export declare function writeFile(targetPath: string, contents: string): Promise<void>;

package/dist/utils/fs.js

@@ -1,25 +1,49 @@
-import fs from 'fs-extra';
-export async function ensureDir(path) {
-    await fs.ensureDir(path);
+import path from 'node:path';
+import { lstat, mkdir, readdir, rm, stat as statFs } from 'node:fs/promises';
+function getBunRuntime() {
+    const runtime = globalThis;
+    if (typeof runtime.Bun?.file === 'function' && typeof runtime.Bun?.write === 'function') {
+        return runtime.Bun;
+    }
+    throw new Error('[webstir-frontend] Bun runtime is required for package-level IO.');
+}
+export async function ensureDir(targetPath) {
+    await mkdir(targetPath, { recursive: true });
 }
-export async function emptyDir(path) {
-    await fs.emptyDir(path);
+export async function emptyDir(targetPath) {
+    await rm(targetPath, { recursive: true, force: true });
+    await mkdir(targetPath, { recursive: true });
 }
-export async function remove(path) {
-    await fs.remove(path);
+export async function remove(targetPath) {
+    await rm(targetPath, { recursive: true, force: true });
 }
 export async function copy(source, destination) {
-    await fs.copy(source, destination, { overwrite: true, errorOnExist: false });
+    const sourceInfo = await lstat(source);
+    if (sourceInfo.isDirectory()) {
+        await ensureDir(destination);
+        const entries = await readdir(source, { withFileTypes: true });
+        await Promise.all(entries.map((entry) => copy(path.join(source, entry.name), path.join(destination, entry.name))));
+        return;
+    }
+    await ensureDir(path.dirname(destination));
+    const bun = getBunRuntime();
+    await bun.write(destination, bun.file(source));
 }
-export async function pathExists(path) {
-    return fs.pathExists(path);
+export async function pathExists(targetPath) {
+    try {
+        await statFs(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
-export async function stat(path) {
-    return fs.stat(path);
+export async function stat(targetPath) {
+    return await statFs(targetPath);
 }
-export async function readJson(path) {
+export async function readJson(targetPath) {
     try {
-        return await fs.readJson(path);
+        return JSON.parse(await readFile(targetPath));
     }
     catch (error) {
         if (error.code === 'ENOENT') {
@@ -28,12 +52,16 @@ export async function readJson(path) {
         throw error;
     }
 }
-export async function writeJson(path, data) {
-    await fs.writeJson(path, data, { spaces: 2 });
+export async function writeJson(targetPath, data) {
+    await writeFile(targetPath, JSON.stringify(data, undefined, 2));
+}
+export async function readFile(targetPath) {
+    return await getBunRuntime().file(targetPath).text();
 }
-export async function readFile(path) {
-    return fs.readFile(path, 'utf8');
+export async function readBinaryFile(targetPath) {
+    return new Uint8Array(await getBunRuntime().file(targetPath).arrayBuffer());
 }
-export async function writeFile(path, contents) {
-    await fs.outputFile(path, contents, 'utf8');
+export async function writeFile(targetPath, contents) {
+    await ensureDir(path.dirname(targetPath));
+    await getBunRuntime().write(targetPath, contents);
 }

package/dist/utils/glob.d.ts

@@ -0,0 +1,8 @@
+export interface GlobScanOptions {
+    readonly cwd: string;
+    readonly absolute?: boolean;
+    readonly dot?: boolean;
+    readonly onlyFiles?: boolean;
+}
+export declare function scanGlob(pattern: string, options: GlobScanOptions): Promise<string[]>;
+export declare function scanDirectories(pattern: string, options: Omit<GlobScanOptions, 'onlyFiles'>): Promise<string[]>;

package/dist/utils/glob.js

@@ -0,0 +1,21 @@
+import path from 'node:path';
+import { stat } from './fs.js';
+export async function scanGlob(pattern, options) {
+    const glob = new Bun.Glob(pattern);
+    const matches = await Array.fromAsync(glob.scan(options));
+    matches.sort((a, b) => a.localeCompare(b));
+    return matches;
+}
+export async function scanDirectories(pattern, options) {
+    const matches = await scanGlob(pattern, { ...options, onlyFiles: false });
+    const directories = await Promise.all(matches.map(async (match) => {
+        const absolutePath = options.absolute || path.isAbsolute(match) ? match : path.join(options.cwd, match);
+        const info = await stat(absolutePath).catch(() => null);
+        if (!info?.isDirectory()) {
+            return null;
+        }
+        const normalized = match.replace(/[\\/]+$/, '');
+        return normalized.length > 0 ? normalized : null;
+    }));
+    return directories.filter((value) => value !== null);
+}

package/dist/utils/hash.js

@@ -1,5 +1,4 @@
-import { createHash } from 'node:crypto';
 export function hashContent(content, length = 8) {
-    const hash = createHash('sha256').update(content).digest('hex');
+    const hash = new Bun.CryptoHasher('sha256').update(content).digest('hex');
     return hash.slice(0, length);
 }

package/dist/utils/pagePaths.js

@@ -27,8 +27,8 @@ export function resolvePageHtmlDir(pagesRoot, pageName, useRootIndex) {
 }
 function joinUrl(...segments) {
     const cleaned = segments
-        .map(segment => trimSlashes(segment))
-        .filter(segment => segment.length > 0);
+        .map((segment) => trimSlashes(segment))
+        .filter((segment) => segment.length > 0);
     return `/${cleaned.join('/')}`;
 }
 function trimSlashes(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webstir-io/webstir-frontend",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "description": "Frontend build and publish tooling for Webstir workspaces.",
   "type": "module",
   "main": "dist/index.js",
@@ -21,6 +21,11 @@
       "import": "./dist/builders/index.js",
       "default": "./dist/builders/index.js"
     },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    },
     "./cli": {
       "import": "./dist/cli.js",
       "default": "./dist/cli.js"
@@ -33,9 +38,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist",
-    "test": "node -e \"const { spawnSync } = require('node:child_process'); const glob = require('glob'); const files = glob.sync('tests/**/*.test.js'); if (!files.length) { console.error('No frontend test files found'); process.exit(1); } const env = { ...process.env, BASELINE_BROWSER_MAPPING_IGNORE_OLD_DATA: 'true', BROWSERSLIST_IGNORE_OLD_DATA: 'true' }; const result = spawnSync(process.execPath, ['--test', ...files], { stdio: 'inherit', env }); process.exit(result.status ?? 1);\"",
-    "prepare": "npm run build",
-    "smoke": "npm run build && node scripts/smoke.mjs",
+    "test": "tsc -p tsconfig.json && BASELINE_BROWSER_MAPPING_IGNORE_OLD_DATA=true BROWSERSLIST_IGNORE_OLD_DATA=true bun test tests",
     "release": "bash scripts/publish.sh"
   },
   "files": [
@@ -43,16 +46,20 @@
     "src",
     "scripts",
     "tests",
-    "tsconfig.json",
-    "package-lock.json"
+    "tsconfig.json"
   ],
   "engines": {
-    "node": ">=20.18.1"
+    "bun": ">=1.3.11"
   },
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/webstir-io/webstir-frontend"
+    "url": "git+https://github.com/webstir-io/webstir.git",
+    "directory": "packages/tooling/webstir-frontend"
+  },
+  "homepage": "https://github.com/webstir-io/webstir/tree/main/packages/tooling/webstir-frontend#readme",
+  "bugs": {
+    "url": "https://github.com/webstir-io/webstir/issues"
   },
   "keywords": [
     "webstir",
@@ -65,14 +72,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@webstir-io/module-contract": "^0.1.13",
+    "@webstir-io/module-contract": "^0.1.16",
     "autoprefixer": "^10.4.18",
     "cheerio": "^1.0.0-rc.12",
     "commander": "^12.1.0",
     "csso": "^5.0.5",
+    "domhandler": "^5.0.3",
     "esbuild": "^0.25.10",
-    "fs-extra": "^11.2.0",
-    "glob": "^10.4.1",
     "highlight.js": "^11.11.1",
     "html-minifier-terser": "^7.2.0",
     "marked": "^12.0.2",
@@ -82,11 +88,10 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/bun": "^1.3.11",
     "@types/csso": "^5.0.4",
-    "@types/fs-extra": "^11.0.4",
-    "@types/glob": "^8.1.0",
     "@types/html-minifier-terser": "^7.0.2",
-    "@types/node": "^20.11.25",
+    "@types/node": "^25.5.0",
     "typescript": "^5.7.2"
   }
 }

package/scripts/publish.sh

@@ -2,100 +2,8 @@
 
 set -euo pipefail
 
-usage() {
-  cat <<'EOF'
-Usage: scripts/publish.sh <patch|minor|major|x.y.z> [--no-push]
-
-Examples:
-  scripts/publish.sh patch
-  scripts/publish.sh 0.1.0
-
-The script requires a clean git worktree and npm publish access to
-@webstir-io. Publishing is handled by GitHub Actions via npm trusted
-publishing (OIDC) after the version tag is pushed.
-
-By default, the script pushes the version bump commit and tag. To skip pushing,
-pass --no-push or set PUBLISH_NO_PUSH=1.
-EOF
-  exit 1
-}
-
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+MONOREPO_ROOT="$(git -C "$ROOT_DIR" rev-parse --show-toplevel)"
 
-main() {
-  if [[ $# -lt 1 ]]; then
-    echo "error: version bump argument missing" >&2
-    usage
-  fi
-
-  local bump="$1"; shift || true
-  local no_push="false"
-
-  while [[ $# -gt 0 ]]; do
-    case "$1" in
-      --no-push)
-        no_push="true"
-        ;;
-      *)
-        echo "error: unknown option '$1'" >&2
-        usage
-        ;;
-    esac
-    shift || true
-  done
-
-  if [[ ! $bump =~ ^(patch|minor|major)$ && ! $bump =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-    echo "error: invalid bump '$bump'" >&2
-    usage
-  fi
-
-  ensure_clean_git
-
-  cd "$ROOT_DIR"
-
-  echo "› npm version $bump"
-  npm version "$bump" -m "v%s"
-
-  echo "› npm install --package-lock-only"
-  npm install --package-lock-only
-
-  echo "› npm run clean"
-  npm run clean
-
-  echo "› npm run build"
-  npm run build
-
-  echo "› npm test"
-  npm test
-
-  echo "› npm run smoke"
-  npm run smoke
-
-  echo "› Skipping direct npm publish; pushing commit+tag will trigger the release workflow."
-
-  if [[ "$no_push" == "true" || "${PUBLISH_NO_PUSH:-}" =~ ^([Yy][Ee][Ss]|[Yy]|1|true)$ ]]; then
-    echo "› Skipping git push (no-push)."
-    echo "  To publish upstream later, run: git push && git push --tags"
-    return 0
-  fi
-
-  echo "› git push"
-  git push
-  echo "› git push --tags"
-  git push --tags
-}
-
-ensure_clean_git() {
-  cd "$ROOT_DIR"
-  if ! git diff --quiet --ignore-submodules HEAD; then
-    echo "error: git worktree has uncommitted changes" >&2
-    exit 1
-  fi
-  if ! git diff --quiet --cached --ignore-submodules; then
-    echo "error: git index has staged changes" >&2
-    exit 1
-  fi
-}
-
-main "$@"
+exec bun "$MONOREPO_ROOT/tools/release-package.mjs" --package-dir "$ROOT_DIR" "$@"

package/scripts/update-contract.sh

@@ -22,6 +22,8 @@ EOF
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+MONOREPO_ROOT="$(git -C "$ROOT_DIR" rev-parse --show-toplevel)"
+PACKAGE_NAME="$(node -p "require('./package.json').name" 2>/dev/null)"
 
 has_script() {
   local script_name="$1"
@@ -83,34 +85,34 @@ main() {
   echo "› Setting @webstir-io/module-contract to $spec"
   npm pkg set "dependencies.@webstir-io/module-contract=$spec"
 
-  echo "› npm install (refresh lockfile)"
+  echo "› bun install (refresh workspace lockfile)"
   if [[ "$fast" == "true" ]]; then
-    npm install --package-lock-only --no-audit --no-fund --ignore-scripts
+    bun install --cwd "$MONOREPO_ROOT" --filter "$PACKAGE_NAME" --lockfile-only
   else
-    npm install --no-audit --no-fund
+    bun install --cwd "$MONOREPO_ROOT" --filter "$PACKAGE_NAME"
   fi
 
   local frontend_ver
   frontend_ver="$(node -p "require('./package.json').version" 2>/dev/null || echo 'unknown')"
   local installed_contract
-  installed_contract="$(npm ls @webstir-io/module-contract --json 2>/dev/null | node -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{try{const j=JSON.parse(d);const v=(j.dependencies&&j.dependencies['@webstir-io/module-contract']&&j.dependencies['@webstir-io/module-contract'].version)||'';console.log(v||'unknown')}catch{console.log('unknown')}})")"
+  installed_contract="$(node -p "try { require('@webstir-io/module-contract/package.json').version } catch { 'unknown' }" 2>/dev/null || echo 'unknown')"
   echo "› Frontend package: @webstir-io/webstir-frontend@${frontend_ver}"
   echo "› Contract installed: @webstir-io/module-contract@${installed_contract}"
 
   if [[ "$fast" != "true" ]]; then
     if has_script build; then
-      echo "› npm run build"
-      npm run build
+      echo "› bun run build"
+      bun run build
     fi
 
     if has_script test; then
-      echo "› npm test"
-      npm test
+      echo "› bun run test"
+      bun run test
     fi
 
     if has_script smoke; then
-      echo "› npm run smoke"
-      npm run smoke
+      echo "› bun run smoke"
+      bun run smoke
     fi
   fi
 

package/src/assets/assetManifest.ts

@@ -2,50 +2,60 @@ import path from 'node:path';
 import { readJson, writeJson, ensureDir } from '../utils/fs.js';
 
 export interface PageAssetManifest {
-    js?: string;
-    css?: string;
+  js?: string;
+  css?: string;
 }
 
 export interface AssetManifest {
-    pages: Record<string, PageAssetManifest>;
-    shared?: SharedAssets;
+  pages: Record<string, PageAssetManifest>;
+  shared?: SharedAssets;
 }
 
 export interface SharedAssets {
-    css?: string;
-    js?: string;
+  css?: string;
+  js?: string;
 }
 
 const MANIFEST_FILENAME = 'manifest.json';
 
-export async function updatePageManifest(directory: string, pageName: string, updater: (value: PageAssetManifest) => void): Promise<void> {
-    const manifestPath = path.join(directory, MANIFEST_FILENAME);
-    await ensureDir(directory);
-    const manifest = (await readJson<AssetManifest>(manifestPath)) ?? { pages: {} };
-    const pageManifest: PageAssetManifest = manifest.pages[pageName] ?? {};
-    updater(pageManifest);
-    manifest.pages[pageName] = pageManifest;
-    await writeJson(manifestPath, manifest);
+export async function updatePageManifest(
+  directory: string,
+  pageName: string,
+  updater: (value: PageAssetManifest) => void,
+): Promise<void> {
+  const manifestPath = path.join(directory, MANIFEST_FILENAME);
+  await ensureDir(directory);
+  const manifest = (await readJson<AssetManifest>(manifestPath)) ?? { pages: {} };
+  const pageManifest: PageAssetManifest = manifest.pages[pageName] ?? {};
+  updater(pageManifest);
+  manifest.pages[pageName] = pageManifest;
+  await writeJson(manifestPath, manifest);
 }
 
-export async function readPageManifest(directory: string, pageName: string): Promise<PageAssetManifest> {
-    const manifestPath = path.join(directory, MANIFEST_FILENAME);
-    const manifest = (await readJson<AssetManifest>(manifestPath)) ?? { pages: {} };
-    return manifest.pages[pageName] ?? {};
+export async function readPageManifest(
+  directory: string,
+  pageName: string,
+): Promise<PageAssetManifest> {
+  const manifestPath = path.join(directory, MANIFEST_FILENAME);
+  const manifest = (await readJson<AssetManifest>(manifestPath)) ?? { pages: {} };
+  return manifest.pages[pageName] ?? {};
 }
 
-export async function updateSharedAssets(directory: string, updater: (value: SharedAssets) => void): Promise<void> {
-    const manifestPath = path.join(directory, MANIFEST_FILENAME);
-    await ensureDir(directory);
-    const manifest = (await readJson<AssetManifest>(manifestPath)) ?? { pages: {} };
-    const shared: SharedAssets = manifest.shared ?? {};
-    updater(shared);
-    manifest.shared = shared;
-    await writeJson(manifestPath, manifest);
+export async function updateSharedAssets(
+  directory: string,
+  updater: (value: SharedAssets) => void,
+): Promise<void> {
+  const manifestPath = path.join(directory, MANIFEST_FILENAME);
+  await ensureDir(directory);
+  const manifest = (await readJson<AssetManifest>(manifestPath)) ?? { pages: {} };
+  const shared: SharedAssets = manifest.shared ?? {};
+  updater(shared);
+  manifest.shared = shared;
+  await writeJson(manifestPath, manifest);
 }
 
 export async function readSharedAssets(directory: string): Promise<SharedAssets | null> {
-    const manifestPath = path.join(directory, MANIFEST_FILENAME);
-    const manifest = await readJson<AssetManifest>(manifestPath);
-    return manifest?.shared ?? null;
+  const manifestPath = path.join(directory, MANIFEST_FILENAME);
+  const manifest = await readJson<AssetManifest>(manifestPath);
+  return manifest?.shared ?? null;
 }