@realitycollective/service-framework-react 1.0.0-preview.1

package/Examples/App.tsx

@@ -0,0 +1,38 @@
+import React from "react";
+import {
+  BaseService,
+  createServiceProfile,
+  createServiceToken
+} from "@realitycollective/service-framework";
+import {
+  ServiceFrameworkProvider,
+  useService
+} from "@realitycollective/service-framework-react";
+
+const STATUS_TOKEN = createServiceToken<StatusService>("StatusService");
+
+class StatusService extends BaseService {
+  get message(): string {
+    return "React service framework ready";
+  }
+}
+
+function StatusPanel(): React.JSX.Element {
+  const service = useService(STATUS_TOKEN);
+  return <p>{service.message}</p>;
+}
+
+export function App(): React.JSX.Element {
+  return (
+    <ServiceFrameworkProvider
+      profile={createServiceProfile("react-example", [
+        {
+          token: STATUS_TOKEN,
+          useFactory: (context) => new StatusService(context)
+        }
+      ])}
+    >
+      <StatusPanel />
+    </ServiceFrameworkProvider>
+  );
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reality Collective
+
+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/dist/index.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+import type { IEnvironmentDescriptor, IScheduler, IService, ServiceProfile } from "@realitycollective/service-framework";
+import { ServiceManager, ServiceToken } from "@realitycollective/service-framework";
+export interface ServiceFrameworkProviderProps {
+    readonly children?: React.ReactNode;
+    readonly manager?: ServiceManager;
+    readonly profile?: ServiceProfile;
+    readonly autoStart?: boolean;
+    readonly scheduler?: IScheduler;
+    readonly environment?: IEnvironmentDescriptor;
+}
+export declare function ServiceFrameworkProvider({ children, manager, profile, autoStart, scheduler, environment }: ServiceFrameworkProviderProps): React.JSX.Element;
+export declare function useServiceManager(): ServiceManager;
+export declare function useService<TService extends IService>(token: ServiceToken<TService>, name?: string): TService;
+export declare function useServices<TService extends IService>(token: ServiceToken<TService>): readonly TService[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EACV,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,cAAc,EACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEpF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC;CAC/C;AAID,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAgB,EAChB,SAAS,EACT,WAAW,EACZ,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuBnD;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAQlD;AAED,wBAAgB,UAAU,CAAC,QAAQ,SAAS,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAE5G;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAS,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,SAAS,QAAQ,EAAE,CAEzG"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/* v8 ignore file */
+import { createContext, useContext, useMemo } from "react";
+import { ServiceManager } from "@realitycollective/service-framework";
+const ServiceFrameworkContext = createContext(null);
+export function ServiceFrameworkProvider({ children, manager, profile, autoStart = true, scheduler, environment }) {
+    const resolvedManager = useMemo(() => {
+        const instance = manager ?? new ServiceManager({
+            ...(scheduler ? { scheduler } : {}),
+            ...(environment ? { environment } : {})
+        });
+        if (profile && !instance.isInitialized) {
+            instance.initializeProfile(profile);
+        }
+        if (autoStart && !instance.isStarted) {
+            instance.start();
+        }
+        return instance;
+    }, [autoStart, environment, manager, profile, scheduler]);
+    return (_jsx(ServiceFrameworkContext.Provider, { value: resolvedManager, children: children }));
+}
+export function useServiceManager() {
+    const manager = useContext(ServiceFrameworkContext);
+    if (!manager) {
+        throw new Error("ServiceFrameworkProvider is required before calling useServiceManager.");
+    }
+    return manager;
+}
+export function useService(token, name) {
+    return useServiceManager().resolve(token, name);
+}
+export function useServices(token) {
+    return useServiceManager().resolveAll(token);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAOlE,OAAO,EAAE,cAAc,EAAgB,MAAM,sCAAsC,CAAC;AAWpF,MAAM,uBAAuB,GAAG,aAAa,CAAwB,IAAI,CAAC,CAAC;AAE3E,MAAM,UAAU,wBAAwB,CAAC,EACvC,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,GAAG,IAAI,EAChB,SAAS,EACT,WAAW,EACmB;IAC9B,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;QACnC,MAAM,QAAQ,GAAG,OAAO,IAAI,IAAI,cAAc,CAAC;YAC7C,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC;QAEH,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YACvC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACrC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAE1D,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,eAAe,YACrD,QAAQ,GACwB,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAEpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAA4B,KAA6B,EAAE,IAAa;IAChG,OAAO,iBAAiB,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAA4B,KAA6B;IAClF,OAAO,iBAAiB,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@realitycollective/service-framework-react",
+  "version": "1.0.0-preview.1",
+  "description": "React bindings for the Reality Collective TypeScript Service Framework.",
+  "author": "Reality Collective",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "Examples"
+  ],
+  "keywords": [
+    "service-framework",
+    "react",
+    "hooks",
+    "realitycollective",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/realitycollective/com.realitycollective.service-framework.ts.git"
+  },
+  "homepage": "https://github.com/realitycollective/com.realitycollective.service-framework.ts#readme",
+  "bugs": {
+    "url": "https://github.com/realitycollective/com.realitycollective.service-framework.ts/issues"
+  },
+  "dependencies": {
+    "@realitycollective/service-framework": "file:../service-framework"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}