@flighthq/textshaper 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/textshaper`. The `@f
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/textshaper@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/textshaper)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/textshaper@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/textshaper)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/textShaper.d.ts

@@ -1,5 +1,7 @@
-import type { TextFormat, TextShaperBackend } from '@flighthq/types/contract';
+import type { BackendOperationExplanation, TextFormat, TextShaperBackend, TextShaperOperation } from '@flighthq/types/contract';
+export declare function explainTextShaperOperation(operation: TextShaperOperation): BackendOperationExplanation;
 export declare function getTextShaperBackend(): TextShaperBackend | null;
+export declare function hasTextShaperOperation(operation: TextShaperOperation): boolean;
 export declare function measureText(text: string, format: Readonly<TextFormat>): number;
 export declare function setTextShaperBackend(backend: TextShaperBackend | null): void;
 //# sourceMappingURL=textShaper.d.ts.map

package/dist/textShaper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textShaper.d.ts","sourceRoot":"","sources":["../src/textShaper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAW9E,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAG9E;AAKD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAG5E"}
+{"version":3,"file":"textShaper.d.ts","sourceRoot":"","sources":["../src/textShaper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAelC,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,mBAAmB,GAAG,2BAA2B,CAKtG;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AAID,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAE9E;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAG9E;AAKD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAG5E"}

package/dist/textShaper.js

@@ -6,9 +6,24 @@ import { _textShaperBackendHook } from './_textShaperHooks';
 // historical measure-provider, which was null until a renderer registered one — callers fall back to
 // leaving text unmeasured until a backend exists. A future @flighthq/textshaper-harfbuzz registers
 // the same way.
+// Which layer implements `operation`. This capability is a SINGLE NULLABLE SLOT — there is no host layer
+// and no sentinel — so the two honest answers are `'custom'` (a backend is installed and provides it) and
+// `'none'` (no backend is installed at all). Reporting `'sentinel'` here would name a fall-through object
+// that does not exist, and inventing a host layer would describe a precedence this package does not have.
+export function explainTextShaperOperation(operation) {
+    if (_backend !== null && typeof _backend[operation] === 'function') {
+        return { implemented: true, layer: 'custom', operation };
+    }
+    return { implemented: false, layer: 'none', operation };
+}
 export function getTextShaperBackend() {
     return _backend;
 }
+// Whether an installed backend implements `operation`. False when nothing is installed, which for this
+// capability is also what the getter reports by returning null.
+export function hasTextShaperOperation(operation) {
+    return explainTextShaperOperation(operation).implemented;
+}
 // Measures `text` in `format` to its horizontal advance, in pixels, via the active backend. Returns
 // the sentinel -1 when no backend is registered (expected before setup), so callers can distinguish
 // "unmeasurable" from a real zero-width advance.

package/dist/textShaper.js.map

@@ -1 +1 @@
-{"version":3,"file":"textShaper.js","sourceRoot":"","sources":["../src/textShaper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,4FAA4F;AAC5F,oGAAoG;AACpG,+EAA+E;AAC/E,oGAAoG;AACpG,qGAAqG;AACrG,mGAAmG;AACnG,gBAAgB;AAChB,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oGAAoG;AACpG,oGAAoG;AACpG,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAA4B;IACpE,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,+FAA+F;AAC/F,iGAAiG;AACjG,6BAA6B;AAC7B,MAAM,UAAU,oBAAoB,CAAC,OAAiC;IACpE,QAAQ,GAAG,OAAO,CAAC;IACnB,sBAAsB,EAAE,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,QAAQ,GAA6B,IAAI,CAAC"}
+{"version":3,"file":"textShaper.js","sourceRoot":"","sources":["../src/textShaper.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,4FAA4F;AAC5F,oGAAoG;AACpG,+EAA+E;AAC/E,oGAAoG;AACpG,qGAAqG;AACrG,mGAAmG;AACnG,gBAAgB;AAChB,yGAAyG;AACzG,0GAA0G;AAC1G,0GAA0G;AAC1G,0GAA0G;AAC1G,MAAM,UAAU,0BAA0B,CAAC,SAA8B;IACvE,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,CAAC,SAAS,CAAC,KAAK,UAAU,EAAE,CAAC;QACnE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,uGAAuG;AACvG,gEAAgE;AAChE,MAAM,UAAU,sBAAsB,CAAC,SAA8B;IACnE,OAAO,0BAA0B,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC;AAC3D,CAAC;AAED,oGAAoG;AACpG,oGAAoG;AACpG,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAA4B;IACpE,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,+FAA+F;AAC/F,iGAAiG;AACjG,6BAA6B;AAC7B,MAAM,UAAU,oBAAoB,CAAC,OAAiC;IACpE,QAAQ,GAAG,OAAO,CAAC;IACnB,sBAAsB,EAAE,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,QAAQ,GAA6B,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/textshaper",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,9 +38,9 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/log": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/signals": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/log": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/signals": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/textShaper.test.ts

@@ -1,17 +1,77 @@
-import type { TextShaperBackend } from '@flighthq/types/contract';
+import type { TextShaperBackend, TextShaperOperation } from '@flighthq/types/contract';
 
-import { getTextShaperBackend, measureText, setTextShaperBackend } from './textShaper';
+import {
+  explainTextShaperOperation,
+  getTextShaperBackend,
+  hasTextShaperOperation,
+  measureText,
+  setTextShaperBackend,
+} from './textShaper';
 
 afterEach(() => {
   setTextShaperBackend(null);
 });
 
+describe('explainTextShaperOperation', () => {
+  afterEach(() => {
+    setTextShaperBackend(null);
+  });
+
+  // ★ With nothing installed, the getter returns null,
+  // so a query resolving through the getter would report every operation implemented. It must not.
+  it('reports none and no implementation when nothing is installed', () => {
+    setTextShaperBackend(null);
+    for (const operation of OPTIONAL_OPERATIONS) {
+      expect(explainTextShaperOperation(operation)).toEqual({ implemented: false, layer: 'none', operation });
+    }
+  });
+
+  it('reports a custom backend as implementing only what it provides', () => {
+    setTextShaperBackend(partialBackend());
+    for (const operation of OPTIONAL_OPERATIONS) {
+      expect(hasTextShaperOperation(operation)).toBe(false);
+    }
+    expect(explainTextShaperOperation(OPTIONAL_OPERATIONS[0]).layer).toBe('none');
+  });
+
+  it('reports an operation the backend does provide', () => {
+    const operation = OPTIONAL_OPERATIONS[0];
+    setTextShaperBackend({ ...partialBackend(), [operation]: () => undefined } as TextShaperBackend);
+    expect(explainTextShaperOperation(operation)).toEqual({ implemented: true, layer: 'custom', operation });
+  });
+});
+
 describe('getTextShaperBackend', () => {
   it('returns null before a backend is set', () => {
     expect(getTextShaperBackend()).toBeNull();
   });
 });
 
+describe('hasTextShaperOperation', () => {
+  afterEach(() => {
+    setTextShaperBackend(null);
+  });
+
+  it('agrees with explainTextShaperOperation for every optional operation', () => {
+    setTextShaperBackend(partialBackend());
+    for (const operation of OPTIONAL_OPERATIONS) {
+      expect(hasTextShaperOperation(operation)).toBe(explainTextShaperOperation(operation).implemented);
+    }
+  });
+});
+
+// Per-operation availability for TextShaperBackend. The operations below are the ones the interface declares
+// OPTIONAL, so a host that omits them is compliant rather than broken — that is the absence-of-an-export
+// ruling, and this is the query that makes it observable.
+const OPTIONAL_OPERATIONS: readonly TextShaperOperation[] = [
+  'getCodePointForGlyph',
+  'getFontMetrics',
+  'getGlyphExtents',
+  'getGlyphIndexForCodePoint',
+  'getGlyphName',
+  'shapeRun',
+];
+
 describe('measureText', () => {
   it('returns -1 when no backend is registered', () => {
     expect(measureText('hello', {})).toBe(-1);
@@ -40,3 +100,10 @@ describe('setTextShaperBackend', () => {
     expect(getTextShaperBackend()).toBe(second);
   });
 });
+
+// A host implementing only the REQUIRED members — partial support declared by absence.
+function partialBackend(): TextShaperBackend {
+  return {
+    measureText: (() => undefined) as never,
+  } as TextShaperBackend;
+}