@flighthq/host-web 0.4.0-next.1836.147ae1e

package/dist/contract.d.ts

@@ -0,0 +1,3 @@
+export * from './webCursor';
+export * from './webGlyphRasterizer';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,3 @@
+export * from './webCursor';
+export * from './webGlyphRasterizer';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createWebCursorBackend } from './webCursor';
+export { createWebGlyphRasterizerBackend, enableHostWebGlyphRasterizer } from './webGlyphRasterizer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createWebCursorBackend } from './webCursor';
+export { createWebGlyphRasterizerBackend, enableHostWebGlyphRasterizer } from './webGlyphRasterizer';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/webCursor.d.ts

@@ -0,0 +1,3 @@
+import type { CursorBackend } from '@flighthq/types/contract';
+export declare function createWebCursorBackend(element: HTMLElement): CursorBackend;
+//# sourceMappingURL=webCursor.d.ts.map

package/dist/webCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webCursor.d.ts","sourceRoot":"","sources":["../src/webCursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEtE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAM1E"}

package/dist/webCursor.js

@@ -0,0 +1,8 @@
+export function createWebCursorBackend(element) {
+    return {
+        setCursor(cursor) {
+            element.style.cursor = cursor ?? '';
+        },
+    };
+}
+//# sourceMappingURL=webCursor.js.map

package/dist/webCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webCursor.js","sourceRoot":"","sources":["../src/webCursor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACzD,OAAO;QACL,SAAS,CAAC,MAAqB;YAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/webGlyphRasterizer.d.ts

@@ -0,0 +1,5 @@
+import type { GlyphRasterizerBackend } from '@flighthq/types/contract';
+export declare function createWebGlyphRasterizerBackend(): GlyphRasterizerBackend;
+export declare function enableHostWebGlyphRasterizer(): void;
+export declare function resetHostWebGlyphRasterizerForTest(): void;
+//# sourceMappingURL=webGlyphRasterizer.d.ts.map

package/dist/webGlyphRasterizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webGlyphRasterizer.d.ts","sourceRoot":"","sources":["../src/webGlyphRasterizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,+BAA+B,IAAI,sBAAsB,CAkBxE;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAMnD;AAsFD,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/dist/webGlyphRasterizer.js

@@ -0,0 +1,122 @@
+import { installGlyphRasterizerHostBackend } from '@flighthq/glyphatlas/contract';
+export function createWebGlyphRasterizerBackend() {
+    return {
+        measureMetrics(options) {
+            const context = _acquireGlyphRasterContext();
+            if (context === null)
+                return null;
+            _applyGlyphRasterFont(context, options);
+            const metrics = context.measureText('Hg');
+            const ascent = metrics.fontBoundingBoxAscent;
+            const descent = metrics.fontBoundingBoxDescent;
+            if (!(ascent > 0) || !(descent >= 0))
+                return null;
+            return { ascent, descent, lineGap: 0 };
+        },
+        rasterize(codepoint, options) {
+            const context = _acquireGlyphRasterContext();
+            if (context === null)
+                return null;
+            return _rasterizeGlyphOnContext(context, codepoint, options);
+        },
+    };
+}
+// Probes the runtime environment for a 2D canvas context. The enabler calls this once at
+// enable time to decide viability — the backend itself re-acquires on every call, but the
+// viability signal is locked at enable time so explain reports a stable answer.
+export function enableHostWebGlyphRasterizer() {
+    if (_enabled)
+        return;
+    _enabled = true;
+    const viable = _probeGlyphRasterizerViability();
+    const backend = viable ? createWebGlyphRasterizerBackend() : _unavailableBackend;
+    installGlyphRasterizerHostBackend(backend, viable);
+}
+function _acquireGlyphRasterContext() {
+    try {
+        if (typeof OffscreenCanvas !== 'undefined') {
+            const context = new OffscreenCanvas(1, 1).getContext('2d');
+            if (context !== null)
+                return context;
+        }
+        if (typeof document !== 'undefined' && typeof document.createElement === 'function') {
+            const context = document.createElement('canvas').getContext('2d');
+            if (context !== null)
+                return context;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function _applyGlyphRasterFont(context, options) {
+    const fontStyle = options.fontStyle ?? 'normal';
+    const fontWeight = options.fontWeight ?? 'normal';
+    context.font = `${fontStyle} ${fontWeight} ${options.fontSize}px ${options.fontFamily}`;
+}
+function _probeGlyphRasterizerViability() {
+    try {
+        if (typeof OffscreenCanvas !== 'undefined') {
+            const context = new OffscreenCanvas(1, 1).getContext('2d');
+            if (context !== null)
+                return true;
+        }
+        if (typeof document !== 'undefined' && typeof document.createElement === 'function') {
+            const context = document.createElement('canvas').getContext('2d');
+            if (context !== null)
+                return true;
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+}
+function _rasterizeGlyphOnContext(context, codepoint, options) {
+    const text = String.fromCodePoint(codepoint);
+    _applyGlyphRasterFont(context, options);
+    context.textBaseline = 'alphabetic';
+    context.textAlign = 'left';
+    const metrics = context.measureText(text);
+    const advance = metrics.width;
+    const left = metrics.actualBoundingBoxLeft ?? 0;
+    const right = metrics.actualBoundingBoxRight ?? advance;
+    const ascent = metrics.actualBoundingBoxAscent ?? options.fontSize;
+    const descent = metrics.actualBoundingBoxDescent ?? 0;
+    const guard = 1;
+    const width = Math.max(0, Math.ceil(left + right)) + guard * 2;
+    const height = Math.max(0, Math.ceil(ascent + descent)) + guard * 2;
+    if (width <= guard * 2 || height <= guard * 2)
+        return null;
+    const canvas = context.canvas;
+    canvas.width = width;
+    canvas.height = height;
+    _applyGlyphRasterFont(context, options);
+    context.textBaseline = 'alphabetic';
+    context.textAlign = 'left';
+    context.clearRect(0, 0, width, height);
+    context.fillStyle = '#ffffff';
+    context.fillText(text, guard + left, guard + ascent);
+    const image = context.getImageData(0, 0, width, height);
+    return {
+        advance,
+        bearingX: -left,
+        bearingY: ascent,
+        height,
+        pixels: new Uint8ClampedArray(image.data),
+        width,
+    };
+}
+export function resetHostWebGlyphRasterizerForTest() {
+    _enabled = false;
+}
+let _enabled = false;
+// Installed when the environment lacks OffscreenCanvas/document/2D-context. A real object (not
+// null) so get returns it and explain reports layer:host + viability:runtime-api-unavailable.
+const _unavailableBackend = {
+    rasterize() {
+        return null;
+    },
+};
+//# sourceMappingURL=webGlyphRasterizer.js.map

package/dist/webGlyphRasterizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webGlyphRasterizer.js","sourceRoot":"","sources":["../src/webGlyphRasterizer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@flighthq/host-web",
+  "version": "0.4.0-next.1836.147ae1e",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/host-web"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/glyphatlas": "0.4.0-next.1836.147ae1e",
+    "@flighthq/types": "0.4.0-next.1836.147ae1e"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Web host backend: installs browser-specific implementations of Flight capability seams (Canvas glyph rasterizer, DOM cursor)",
+  "sideEffects": false
+}

package/src/evidence.test.ts

@@ -0,0 +1,154 @@
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+import type { OutputChunk, RollupOutput } from 'rollup';
+import { build } from 'vite';
+import { describe, expect, it } from 'vitest';
+import { gzipSync } from 'zlib';
+
+const ROOT = resolve(__dirname, '../../..');
+const EVIDENCE_DIR = resolve(__dirname, '../evidence');
+const FIXTURES = ['control', 'capability', 'cursor', 'glyph', 'both'] as const;
+
+type FixtureName = (typeof FIXTURES)[number];
+
+interface FixtureResult {
+  modules: string[];
+  rawBytes: number;
+  gzipBytes: number;
+  code: string;
+}
+
+function resolveWorkspaceAliases(): Record<string, string> {
+  const packagesDir = resolve(ROOT, 'packages');
+  const alias: Record<string, string> = {};
+  const entries = require('fs').readdirSync(packagesDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const pkgJsonPath = resolve(packagesDir, entry.name, 'package.json');
+    if (!existsSync(pkgJsonPath)) continue;
+    const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+    if (typeof pkgJson.name === 'string') {
+      alias[pkgJson.name] = resolve(packagesDir, entry.name, 'src');
+    }
+  }
+  return alias;
+}
+
+async function buildFixture(name: FixtureName): Promise<FixtureResult> {
+  const entry = resolve(EVIDENCE_DIR, `${name}.ts`);
+  const alias = resolveWorkspaceAliases();
+
+  const result = (await build({
+    configFile: false,
+    root: EVIDENCE_DIR,
+    logLevel: 'silent',
+    resolve: { alias },
+    build: {
+      write: false,
+      minify: false,
+      target: 'esnext',
+      sourcemap: false,
+      rollupOptions: {
+        input: entry,
+        output: { format: 'es' },
+      },
+    },
+  })) as RollupOutput;
+
+  const chunks = result.output.filter((o): o is OutputChunk => o.type === 'chunk');
+  const mainChunk = chunks.find((c) => c.isEntry) ?? chunks[0];
+  const allModules = new Set<string>();
+  for (const chunk of chunks) {
+    for (const id of Object.keys(chunk.modules)) {
+      allModules.add(id);
+    }
+  }
+
+  const code = mainChunk.code;
+  const rawBytes = Buffer.byteLength(code, 'utf-8');
+  const gzipBytes = gzipSync(code).byteLength;
+
+  return {
+    code,
+    gzipBytes,
+    modules: [...allModules].map((id) => id.replace(ROOT + '/', '')),
+    rawBytes,
+  };
+}
+
+function sourceModules(modules: string[]): string[] {
+  return modules.filter((m) => !m.includes('/evidence/'));
+}
+
+function hasHostWebModule(modules: string[]): boolean {
+  return sourceModules(modules).some((m) => m.includes('packages/host-web/'));
+}
+
+function hasGlyphModule(modules: string[]): boolean {
+  return sourceModules(modules).some((m) => m.includes('webGlyphRasterizer'));
+}
+
+function hasCursorModule(modules: string[]): boolean {
+  return sourceModules(modules).some((m) => m.includes('webCursor'));
+}
+
+describe('evidence: tree-shaking isolation', () => {
+  const results = new Map<FixtureName, FixtureResult>();
+
+  async function getFixture(name: FixtureName): Promise<FixtureResult> {
+    let result = results.get(name);
+    if (result === undefined) {
+      result = await buildFixture(name);
+      results.set(name, result);
+    }
+    return result;
+  }
+
+  it('control fixture contains zero host-web modules', async () => {
+    const { modules } = await getFixture('control');
+    expect(hasHostWebModule(modules)).toBe(false);
+  });
+
+  it('capability fixture contains zero host-web modules', async () => {
+    const { modules } = await getFixture('capability');
+    expect(hasHostWebModule(modules)).toBe(false);
+  });
+
+  it('cursor fixture excludes glyph rasterizer modules', async () => {
+    const { modules } = await getFixture('cursor');
+    expect(hasHostWebModule(modules)).toBe(true);
+    expect(hasGlyphModule(modules)).toBe(false);
+  });
+
+  it('glyph fixture excludes cursor modules', async () => {
+    const { modules } = await getFixture('glyph');
+    expect(hasHostWebModule(modules)).toBe(true);
+    expect(hasCursorModule(modules)).toBe(false);
+  });
+
+  it('both module set is within the union of cursor and glyph', async () => {
+    const [cursorResult, glyphResult, bothResult] = await Promise.all([
+      getFixture('cursor'),
+      getFixture('glyph'),
+      getFixture('both'),
+    ]);
+    const union = new Set([...sourceModules(cursorResult.modules), ...sourceModules(glyphResult.modules)]);
+    const outsideUnion = sourceModules(bothResult.modules).filter((m) => !union.has(m));
+    expect(outsideUnion).toEqual([]);
+  });
+
+  it('reports control-normalized sizes', async () => {
+    const control = await getFixture('control');
+    const names: FixtureName[] = ['capability', 'cursor', 'glyph', 'both'];
+    for (const name of names) {
+      const fixture = await getFixture(name);
+      const rawDelta = fixture.rawBytes - control.rawBytes;
+      const gzipDelta = fixture.gzipBytes - control.gzipBytes;
+      console.log(
+        `${name}: raw=${fixture.rawBytes} (${rawDelta >= 0 ? '+' : ''}${rawDelta}), ` +
+          `gzip=${fixture.gzipBytes} (${gzipDelta >= 0 ? '+' : ''}${gzipDelta})`,
+      );
+    }
+    console.log(`control: raw=${control.rawBytes}, gzip=${control.gzipBytes}`);
+  });
+});

package/src/webCursor.test.ts

@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest';
+
+import { createWebCursorBackend } from './webCursor';
+
+describe('createWebCursorBackend', () => {
+  it('sets element.style.cursor to the given cursor value', () => {
+    const element = document.createElement('div');
+    const backend = createWebCursorBackend(element);
+    backend.setCursor('pointer');
+    expect(element.style.cursor).toBe('pointer');
+  });
+
+  it('clears element.style.cursor when given null', () => {
+    const element = document.createElement('div');
+    const backend = createWebCursorBackend(element);
+    backend.setCursor('pointer');
+    backend.setCursor(null);
+    expect(element.style.cursor).toBe('');
+  });
+
+  it('constructs without a DOM side effect', () => {
+    const element = document.createElement('div');
+    createWebCursorBackend(element);
+    expect(element.style.cursor).toBe('');
+  });
+});

package/src/webGlyphRasterizer.test.ts

@@ -0,0 +1,105 @@
+import {
+  explainGlyphRasterizerBackend,
+  getGlyphRasterizerBackend,
+  installGlyphRasterizerHostBackend,
+  resetGlyphRasterizerBackendForTest,
+} from '@flighthq/glyphatlas/contract';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import {
+  createWebGlyphRasterizerBackend,
+  enableHostWebGlyphRasterizer,
+  resetHostWebGlyphRasterizerForTest,
+} from './webGlyphRasterizer';
+
+describe('createWebGlyphRasterizerBackend', () => {
+  afterEach(resetGlyphRasterizerBackendForTest);
+
+  it('constructs a backend with rasterize and measureMetrics', () => {
+    const backend = createWebGlyphRasterizerBackend();
+    expect(backend.rasterize).toBeTypeOf('function');
+    expect(backend.measureMetrics).toBeTypeOf('function');
+  });
+
+  it('rasterize returns null when no canvas context is available', () => {
+    const backend = createWebGlyphRasterizerBackend();
+    const saved = HTMLCanvasElement.prototype.getContext;
+    HTMLCanvasElement.prototype.getContext = (() => null) as typeof HTMLCanvasElement.prototype.getContext;
+    try {
+      expect(backend.rasterize(65, { fontFamily: 'x', fontSize: 16 })).toBeNull();
+    } finally {
+      HTMLCanvasElement.prototype.getContext = saved;
+    }
+  });
+});
+
+describe('enableHostWebGlyphRasterizer', () => {
+  afterEach(() => {
+    resetGlyphRasterizerBackendForTest();
+    resetHostWebGlyphRasterizerForTest();
+    vi.restoreAllMocks();
+  });
+
+  it('installs a host backend so get returns a non-sentinel', () => {
+    enableHostWebGlyphRasterizer();
+    const backend = getGlyphRasterizerBackend();
+    expect(backend).not.toBe(null);
+    expect(explainGlyphRasterizerBackend().layer).toBe('host');
+  });
+
+  it('is idempotent — second call preserves provider identity and allocates nothing', () => {
+    enableHostWebGlyphRasterizer();
+    const first = getGlyphRasterizerBackend();
+    enableHostWebGlyphRasterizer();
+    const second = getGlyphRasterizerBackend();
+    expect(first).toBe(second);
+  });
+
+  it('reports available when the canvas API is present', () => {
+    enableHostWebGlyphRasterizer();
+    expect(explainGlyphRasterizerBackend()).toEqual({ layer: 'host', viability: 'available' });
+  });
+
+  it('reports runtime-api-unavailable when no canvas context can be acquired', () => {
+    const saved = HTMLCanvasElement.prototype.getContext;
+    HTMLCanvasElement.prototype.getContext = (() => null) as typeof HTMLCanvasElement.prototype.getContext;
+    try {
+      enableHostWebGlyphRasterizer();
+    } finally {
+      HTMLCanvasElement.prototype.getContext = saved;
+    }
+    expect(explainGlyphRasterizerBackend()).toEqual({ layer: 'host', viability: 'runtime-api-unavailable' });
+  });
+
+  it('installs a real backend object even when runtime API is unavailable', () => {
+    const saved = HTMLCanvasElement.prototype.getContext;
+    HTMLCanvasElement.prototype.getContext = (() => null) as typeof HTMLCanvasElement.prototype.getContext;
+    try {
+      enableHostWebGlyphRasterizer();
+    } finally {
+      HTMLCanvasElement.prototype.getContext = saved;
+    }
+    const backend = getGlyphRasterizerBackend();
+    expect(backend.rasterize).toBeTypeOf('function');
+    expect(backend.rasterize(65, { fontFamily: 'x', fontSize: 16 })).toBeNull();
+  });
+
+  it('does not conflict with a prior install of the same backend via direct install', () => {
+    enableHostWebGlyphRasterizer();
+    const backend = getGlyphRasterizerBackend();
+    installGlyphRasterizerHostBackend(backend, true);
+    expect(explainGlyphRasterizerBackend().viability).not.toBe('provider-conflict');
+  });
+});
+
+describe('resetHostWebGlyphRasterizerForTest', () => {
+  afterEach(resetGlyphRasterizerBackendForTest);
+
+  it('clears the enabler flag so a subsequent enable re-installs', () => {
+    enableHostWebGlyphRasterizer();
+    resetHostWebGlyphRasterizerForTest();
+    resetGlyphRasterizerBackendForTest();
+    enableHostWebGlyphRasterizer();
+    expect(explainGlyphRasterizerBackend().layer).toBe('host');
+  });
+});