@ankhorage/surface 9.3.3 → 9.4.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/surface
 
+## 9.4.1
+
+### Patch Changes
+
+- f9002c2: Update dependencies: `@ankhorage/contracts`.
+
+## 9.4.0
+
+### Minor Changes
+
+- 3d9d961: Publish the canonical `theme.setMode` capability for portable theme-mode invocation.
+
 ## 9.3.3
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/surface
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v9.3.3](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v9.4.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Cross-platform UI foundation for React Native and React Native Web. Provides theming, layout primitives, and core building blocks for modern apps.
 

package/dist/capabilities/index.d.ts

@@ -0,0 +1,23 @@
+export declare const CAPABILITIES: readonly [{
+    readonly id: "theme.setMode";
+    readonly owner: "@ankhorage/surface";
+    readonly access: readonly ["invoke"];
+    readonly binding: {
+        readonly kind: "action";
+        readonly bindableAs: readonly ["target"];
+    };
+    readonly input: {
+        readonly schema: {
+            readonly type: "object";
+            readonly required: readonly ["mode"];
+            readonly properties: {
+                readonly mode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["light", "dark"];
+                };
+            };
+            readonly additionalProperties: false;
+        };
+    };
+}];
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAuBiB,CAAC"}

package/dist/capabilities/index.js

@@ -0,0 +1,25 @@
+export const CAPABILITIES = [
+    {
+        id: 'theme.setMode',
+        owner: '@ankhorage/surface',
+        access: ['invoke'],
+        binding: {
+            kind: 'action',
+            bindableAs: ['target'],
+        },
+        input: {
+            schema: {
+                type: 'object',
+                required: ['mode'],
+                properties: {
+                    mode: {
+                        type: 'string',
+                        enum: ['light', 'dark'],
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,oBAAoB;QAC3B,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB;QACD,KAAK,EAAE;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,MAAM,CAAC;gBAClB,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;qBACxB;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;CACuC,CAAC","sourcesContent":["import type { Capability } from '@ankhorage/contracts/capabilities';\n\nexport const CAPABILITIES = [\n  {\n    id: 'theme.setMode',\n    owner: '@ankhorage/surface',\n    access: ['invoke'],\n    binding: {\n      kind: 'action',\n      bindableAs: ['target'],\n    },\n    input: {\n      schema: {\n        type: 'object',\n        required: ['mode'],\n        properties: {\n          mode: {\n            type: 'string',\n            enum: ['light', 'dark'],\n          },\n        },\n        additionalProperties: false,\n      },\n    },\n  },\n] as const satisfies readonly Capability[];\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/surface",
   "type": "module",
-  "version": "9.3.3",
+  "version": "9.4.1",
   "description": "Stable UI foundation for React Native and React Native Web.",
   "homepage": "https://github.com/ankhorage/surface#readme",
   "bugs": {
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@ankhorage/color-theory": "^0.3.1",
-    "@ankhorage/contracts": "^24.1.0",
+    "@ankhorage/contracts": "^24.2.0",
     "@ankhorage/utility": "^1.9.85",
     "@gorhom/bottom-sheet": "^5.2.14"
   },
@@ -78,6 +78,11 @@
       "import": "./dist/constants/surfaceColor.js",
       "default": "./dist/constants/surfaceColor.js"
     },
+    "./capabilities": {
+      "types": "./dist/capabilities/index.d.ts",
+      "import": "./dist/capabilities/index.js",
+      "default": "./dist/capabilities/index.js"
+    },
     "./theme": {
       "bun": "./src/features/theme/public.ts",
       "react-native": "./src/features/theme/public.ts",
@@ -107,8 +112,8 @@
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^2.1.17",
-    "@ankhorage/paradox": "^0.2.28",
+    "@ankhorage/devtools": "^2.2.2",
+    "@ankhorage/paradox": "^0.3.1",
     "@react-native-vector-icons/fontawesome": "^13.1.4",
     "@react-native-vector-icons/fontawesome5": "^13.1.4",
     "@react-native-vector-icons/fontawesome6": "^13.1.4",
@@ -131,5 +136,42 @@
     "react-native-worklets": "0.13.0",
     "typescript": "~6.0.3"
   },
-  "packageManager": "bun@1.4.2"
+  "packageManager": "bun@1.4.2",
+  "ankh": {
+    "category": "surface",
+    "provider": null,
+    "capabilities": [
+      {
+        "id": "theme.setMode",
+        "owner": "@ankhorage/surface",
+        "access": [
+          "invoke"
+        ],
+        "binding": {
+          "kind": "action",
+          "bindableAs": [
+            "target"
+          ]
+        },
+        "input": {
+          "schema": {
+            "type": "object",
+            "required": [
+              "mode"
+            ],
+            "properties": {
+              "mode": {
+                "type": "string",
+                "enum": [
+                  "light",
+                  "dark"
+                ]
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      }
+    ]
+  }
 }

package/src/capabilities/index.test.ts

@@ -0,0 +1,50 @@
+import { readFileSync } from 'node:fs';
+
+import { isCapability } from '@ankhorage/contracts/capabilities';
+import { expect, test } from 'bun:test';
+
+import { CAPABILITIES } from './index';
+
+const packageMetadata = (
+  JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')) as {
+    readonly ankh?: {
+      readonly capabilities?: unknown;
+      readonly category?: unknown;
+      readonly provider?: unknown;
+    };
+  }
+).ankh;
+
+test('publishes a valid and uniquely identified canonical Surface theme capability', () => {
+  expect(CAPABILITIES).toHaveLength(1);
+  expect(CAPABILITIES.every(isCapability)).toBe(true);
+  expect(new Set(CAPABILITIES.map((capability) => capability.id)).size).toBe(CAPABILITIES.length);
+  expect(CAPABILITIES).toEqual([
+    {
+      id: 'theme.setMode',
+      owner: '@ankhorage/surface',
+      access: ['invoke'],
+      binding: { kind: 'action', bindableAs: ['target'] },
+      input: {
+        schema: {
+          type: 'object',
+          required: ['mode'],
+          properties: { mode: { type: 'string', enum: ['light', 'dark'] } },
+          additionalProperties: false,
+        },
+      },
+    },
+  ]);
+});
+
+test('keeps Ankh package metadata identical to the canonical Surface catalog', () => {
+  expect(packageMetadata?.category).toBe('surface');
+  expect(packageMetadata?.provider).toBeNull();
+  expect(packageMetadata?.capabilities).toEqual(CAPABILITIES);
+});
+
+test('exports the catalog from the public capabilities subpath', async () => {
+  const capabilities = await import('@ankhorage/surface/capabilities');
+
+  expect(capabilities.CAPABILITIES).toEqual(CAPABILITIES);
+});

package/src/capabilities/index.ts

@@ -0,0 +1,26 @@
+import type { Capability } from '@ankhorage/contracts/capabilities';
+
+export const CAPABILITIES = [
+  {
+    id: 'theme.setMode',
+    owner: '@ankhorage/surface',
+    access: ['invoke'],
+    binding: {
+      kind: 'action',
+      bindableAs: ['target'],
+    },
+    input: {
+      schema: {
+        type: 'object',
+        required: ['mode'],
+        properties: {
+          mode: {
+            type: 'string',
+            enum: ['light', 'dark'],
+          },
+        },
+        additionalProperties: false,
+      },
+    },
+  },
+] as const satisfies readonly Capability[];

package/src/index.test.ts

@@ -16,6 +16,14 @@ const packageJson = JSON.parse(
   peerDependencies: Record<string, string>;
 };
 
+const capabilitiesExport = {
+  './capabilities': {
+    default: './dist/capabilities/index.js',
+    import: './dist/capabilities/index.js',
+    types: './dist/capabilities/index.d.ts',
+  },
+};
+
 const expectedFeatureRootExports = [
   "export { AppBar } from './features/app-bar/public';",
   "export { Badge } from './features/badge/public';",
@@ -137,6 +145,7 @@ describe('public package metadata contract', () => {
         import: './dist/constants/surfaceColor.js',
         types: './dist/constants/surfaceColor.d.ts',
       },
+      ...capabilitiesExport,
       './theme': {
         bun: './src/features/theme/public.ts',
         'react-native': './src/features/theme/public.ts',