@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.0

package/dist/graph/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Graph Resolver Types
+ *
+ * Types for Microsoft Graph data resolution
+ *
+ * @module @pwfabric/runtime/graph/types
+ */
+/**
+ * Graph resource type
+ */
+export type GraphResource = 'me' | 'users' | 'groups' | 'sites' | 'drives' | 'teams' | 'channels' | 'messages' | 'events' | 'contacts';
+/**
+ * Graph query definition
+ */
+export interface GraphQuery {
+    readonly resource: GraphResource | string;
+    readonly id?: string;
+    readonly select?: readonly string[];
+    readonly expand?: readonly string[];
+    readonly filter?: string;
+    readonly orderBy?: string;
+    readonly top?: number;
+    readonly skip?: number;
+}
+/**
+ * Graph batch request
+ */
+export interface GraphBatchRequest {
+    readonly id: string;
+    readonly method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    readonly url: string;
+    readonly body?: unknown;
+    readonly headers?: Record<string, string>;
+    readonly dependsOn?: readonly string[];
+}
+/**
+ * Graph response
+ */
+export interface GraphResponse<T = unknown> {
+    readonly value?: T;
+    readonly '@odata.context'?: string;
+    readonly '@odata.count'?: number;
+    readonly '@odata.nextLink'?: string;
+}
+/**
+ * Graph collection response
+ */
+export interface GraphCollectionResponse<T> extends GraphResponse<T[]> {
+    readonly value: T[];
+}
+/**
+ * Graph batch response
+ */
+export interface GraphBatchResponse {
+    readonly responses: readonly GraphBatchResponseItem[];
+}
+/**
+ * Graph batch response item
+ */
+export interface GraphBatchResponseItem {
+    readonly id: string;
+    readonly status: number;
+    readonly headers?: Record<string, string>;
+    readonly body?: unknown;
+}
+/**
+ * Graph query result
+ */
+export type GraphResult<T> = {
+    readonly success: true;
+    readonly data: T;
+    readonly nextLink?: string;
+} | {
+    readonly success: false;
+    readonly error: GraphError;
+};
+/**
+ * Graph error
+ */
+export interface GraphError {
+    readonly type: 'network_error' | 'auth_error' | 'not_found' | 'forbidden' | 'rate_limited' | 'server_error';
+    readonly message: string;
+    readonly code?: string;
+    readonly statusCode?: number;
+    readonly cause?: unknown;
+}
+/**
+ * Graph user
+ */
+export interface GraphUser {
+    readonly id: string;
+    readonly displayName?: string;
+    readonly mail?: string;
+    readonly userPrincipalName?: string;
+    readonly jobTitle?: string;
+    readonly department?: string;
+    readonly officeLocation?: string;
+}
+/**
+ * Graph group
+ */
+export interface GraphGroup {
+    readonly id: string;
+    readonly displayName?: string;
+    readonly description?: string;
+    readonly mail?: string;
+    readonly groupTypes?: readonly string[];
+}
+/**
+ * Graph drive item
+ */
+export interface GraphDriveItem {
+    readonly id: string;
+    readonly name: string;
+    readonly webUrl?: string;
+    readonly size?: number;
+    readonly createdDateTime?: string;
+    readonly lastModifiedDateTime?: string;
+    readonly folder?: {
+        childCount: number;
+    };
+    readonly file?: {
+        mimeType: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/graph/types.d.ts.map

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

package/dist/graph/types.js

@@ -0,0 +1,9 @@
+/**
+ * Graph Resolver Types
+ *
+ * Types for Microsoft Graph data resolution
+ *
+ * @module @pwfabric/runtime/graph/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/hooks/useInstalledAtoms.d.ts

@@ -0,0 +1,97 @@
+/**
+ * useInstalledAtoms — runtime hook for tenant-scoped pack atom registry
+ *
+ * Reads the host's installed-atoms endpoint, `GET /api/pwpacks/runtime/atoms?kind=...`,
+ * and returns a `Map<atomId, InstalledAtomDescriptor>` plus loading/error
+ * state. The dynamic-artifact provider plugs this into the existing
+ * `BlockModuleLoader.import(bundleUrl)` flow.
+ *
+ * Surface atoms are NOT served by this hook — surfaces use the receipt
+ * fork model. Only `block` + `capability` kinds.
+ *
+ * @module @pwfabric/runtime/hooks/useInstalledAtoms
+ */
+export type InstalledAtomKind = 'block' | 'capability';
+/**
+ * AI-readable knowledge for an atom, mirrored from the canonical
+ * `AtomManifestKnowledge` contract. Re-declared here so
+ * runtime consumers don't have to import the schema package just to read
+ * the descriptor; the shape is stable.
+ */
+export interface InstalledAtomKnowledge {
+    readonly purpose: string;
+    readonly useCases: readonly string[];
+    readonly composesWith: readonly string[];
+    readonly antiPatterns: readonly string[];
+}
+export interface InstalledAtomDescriptor {
+    readonly atomId: string;
+    readonly kind: InstalledAtomKind;
+    readonly bundleUrl: string | null;
+    readonly bundleHash: string | null;
+    readonly contentHash: string | null;
+    readonly sourceListingId: string | null;
+    readonly installedAt: string;
+    /**
+     * The installed atom's manifest payload. Includes the 4-field `knowledge`
+     * block plus catalogue metadata (category, name, description, tags). May be
+     * `null` for installs whose pack carried no manifest.json.
+     */
+    readonly manifest: AtomManifestPayload | null;
+}
+export interface AtomBlockDefinitionMetadata {
+    readonly props: readonly Record<string, unknown>[];
+    readonly defaultProps: Readonly<Record<string, unknown>>;
+    readonly canHaveChildren: boolean;
+    readonly allowedParents?: readonly string[];
+    readonly allowedChildren?: readonly string[];
+}
+export interface AtomManifestPayload {
+    readonly id?: string;
+    readonly kind?: InstalledAtomKind;
+    readonly version?: string;
+    readonly name?: string;
+    readonly state?: string;
+    readonly category?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly knowledge?: InstalledAtomKnowledge;
+    /**
+     * per-block authoring metadata mirrored from the
+     * pwpack manifest. Present on block atoms whose manifest carries a
+     * `definition` block; absent for capabilities and legacy installs.
+     */
+    readonly definition?: AtomBlockDefinitionMetadata;
+}
+export interface InstalledAtomsState {
+    readonly atoms: ReadonlyMap<string, InstalledAtomDescriptor>;
+    readonly loading: boolean;
+    readonly error: Error | null;
+}
+/**
+ * Optional fetcher override. Defaults to `window.fetch` against
+ * `/api/pwpacks/runtime/atoms`. Tests inject a stub; SSR may inject a
+ * server-side direct DB resolver.
+ */
+export type InstalledAtomsFetcher = (worldId: string, kind: InstalledAtomKind) => Promise<readonly InstalledAtomDescriptor[]>;
+/**
+ * Build the InstalledAtomsState from a fetcher result. Exported so unit
+ * tests can validate the pure reducer logic without mounting React.
+ */
+export declare function reduceFetchedAtoms(descriptors: readonly InstalledAtomDescriptor[]): InstalledAtomsState;
+/**
+ * Build the InstalledAtomsState for a fetch failure.
+ */
+export declare function reduceFetchError(error: Error): InstalledAtomsState;
+/**
+ * The initial loading state — atoms empty, loading true, no error.
+ */
+export declare const INITIAL_INSTALLED_ATOMS_STATE: InstalledAtomsState;
+/**
+ * Resolve the active workspace atoms for a tenant by kind. Returns a
+ * `Map<atomId, InstalledAtomDescriptor>` plus loading + error state. The
+ * map is empty until the first fetch settles; consumers should fall back
+ * to a static registry (e.g. `defaultBlockComponents`) while loading.
+ */
+export declare function useInstalledAtoms(worldId: string, kind: InstalledAtomKind, fetcher?: InstalledAtomsFetcher): InstalledAtomsState;
+//# sourceMappingURL=useInstalledAtoms.d.ts.map

package/dist/hooks/useInstalledAtoms.d.ts.map

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

package/dist/hooks/useInstalledAtoms.js

@@ -0,0 +1,92 @@
+/**
+ * useInstalledAtoms — runtime hook for tenant-scoped pack atom registry
+ *
+ * Reads the host's installed-atoms endpoint, `GET /api/pwpacks/runtime/atoms?kind=...`,
+ * and returns a `Map<atomId, InstalledAtomDescriptor>` plus loading/error
+ * state. The dynamic-artifact provider plugs this into the existing
+ * `BlockModuleLoader.import(bundleUrl)` flow.
+ *
+ * Surface atoms are NOT served by this hook — surfaces use the receipt
+ * fork model. Only `block` + `capability` kinds.
+ *
+ * @module @pwfabric/runtime/hooks/useInstalledAtoms
+ */
+import { useEffect, useState } from 'react';
+async function defaultFetcher(_tenantId, kind) {
+    const res = await fetch(`/api/pwpacks/runtime/atoms?kind=${encodeURIComponent(kind)}`, {
+        credentials: 'include',
+    });
+    if (!res.ok) {
+        throw new Error(`useInstalledAtoms: fetch failed (${res.status})`);
+    }
+    const body = (await res.json());
+    return body.data;
+}
+// ============================================================
+// PURE STATE REDUCER (testable without React)
+// ============================================================
+/**
+ * Build the InstalledAtomsState from a fetcher result. Exported so unit
+ * tests can validate the pure reducer logic without mounting React.
+ */
+export function reduceFetchedAtoms(descriptors) {
+    const map = new Map();
+    for (const d of descriptors) {
+        map.set(d.atomId, d);
+    }
+    return { atoms: map, loading: false, error: null };
+}
+/**
+ * Build the InstalledAtomsState for a fetch failure.
+ */
+export function reduceFetchError(error) {
+    return { atoms: new Map(), loading: false, error };
+}
+/**
+ * The initial loading state — atoms empty, loading true, no error.
+ */
+export const INITIAL_INSTALLED_ATOMS_STATE = Object.freeze({
+    atoms: new Map(),
+    loading: true,
+    error: null,
+});
+// ============================================================
+// HOOK
+// ============================================================
+/**
+ * Resolve the active workspace atoms for a tenant by kind. Returns a
+ * `Map<atomId, InstalledAtomDescriptor>` plus loading + error state. The
+ * map is empty until the first fetch settles; consumers should fall back
+ * to a static registry (e.g. `defaultBlockComponents`) while loading.
+ */
+export function useInstalledAtoms(worldId, kind, fetcher = defaultFetcher) {
+    const [state, setState] = useState({
+        atoms: new Map(),
+        loading: true,
+        error: null,
+    });
+    useEffect(() => {
+        let cancelled = false;
+        setState((prev) => ({ ...prev, loading: true, error: null }));
+        fetcher(worldId, kind)
+            .then((descriptors) => {
+            if (cancelled)
+                return;
+            const map = new Map();
+            for (const d of descriptors) {
+                map.set(d.atomId, d);
+            }
+            setState({ atoms: map, loading: false, error: null });
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            setState({ atoms: new Map(), loading: false, error: err });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [worldId, kind, fetcher]);
+    return state;
+}
+//# sourceMappingURL=useInstalledAtoms.js.map

package/dist/hooks/useInstalledAtoms.js.map

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

package/dist/i18n/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * i18n Capability Module
+ *
+ * Locale resolution, translation, pluralization, and formatting
+ *
+ * Exports:
+ * - Types: LocaleId, LocaleDefinition, TranslationCatalog, I18nCapability, etc.
+ * - Implementations: DefaultI18nCapability
+ * - Factory functions: createI18nCapability
+ *
+ * @module @pwfabric/runtime/i18n
+ */
+export type { LocaleId, LocaleDefinition, TranslationCatalog, PluralCategory, PluralRuleFunction, NumberFormatOptions, DateFormatOptions, I18nCapability, } from './types.js';
+export type { I18nOptions, MissingKeyHandler } from './translator.js';
+export { DefaultI18nCapability, createI18nCapability } from './translator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAA;AAGnB,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/i18n/index.js

@@ -0,0 +1,14 @@
+/**
+ * i18n Capability Module
+ *
+ * Locale resolution, translation, pluralization, and formatting
+ *
+ * Exports:
+ * - Types: LocaleId, LocaleDefinition, TranslationCatalog, I18nCapability, etc.
+ * - Implementations: DefaultI18nCapability
+ * - Factory functions: createI18nCapability
+ *
+ * @module @pwfabric/runtime/i18n
+ */
+export { DefaultI18nCapability, createI18nCapability } from './translator.js';
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/i18n/translator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * i18n Capability Implementation
+ *
+ * Locale resolution, ICU-style string interpolation,
+ * pluralization, and number/date formatting
+ *
+ * @module @pwfabric/runtime/i18n/translator
+ */
+import type { I18nCapability, LocaleId, LocaleDefinition, TranslationCatalog, NumberFormatOptions, DateFormatOptions } from './types.js';
+/**
+ * Default i18n capability implementation
+ */
+export declare class DefaultI18nCapability implements I18nCapability {
+    private readonly locales;
+    private readonly catalogs;
+    private currentLocale;
+    private readonly defaultLocale;
+    private readonly missingKeyHandler;
+    constructor(options?: I18nOptions);
+    addLocale(locale: LocaleDefinition): void;
+    loadTranslations(localeId: LocaleId, catalog: TranslationCatalog): void;
+    resolveLocale(preferred: readonly LocaleId[]): LocaleId;
+    setLocale(localeId: LocaleId): void;
+    getLocale(): LocaleId;
+    getLocaleIds(): readonly LocaleId[];
+    translate(key: string, values?: Readonly<Record<string, unknown>>): string;
+    t(key: string, values?: Readonly<Record<string, unknown>>): string;
+    formatNumber(value: number, options?: NumberFormatOptions): string;
+    formatDate(value: Date | number, options?: DateFormatOptions): string;
+    hasTranslation(key: string): boolean;
+    clear(): void;
+    private lookupKey;
+    /**
+     * Interpolate ICU-style message patterns
+     *
+     * Supports:
+     * - Simple: "Hello, {name}!"
+     * - Plural: "{count, plural, one {# item} other {# items}}"
+     * - Select: "{gender, select, male {He} female {She} other {They}}"
+     */
+    private interpolate;
+    /**
+     * Extract a brace-balanced block starting at position `start`
+     * Returns the content between the outer braces and the end index
+     */
+    private extractBraceBlock;
+    /**
+     * Resolve a single interpolation block (content between outer braces)
+     */
+    private resolveBlock;
+    private resolvePlural;
+    private resolveSelect;
+    /**
+     * Parse ICU option blocks like: "one {# item} other {# items}"
+     * Handles nested braces correctly using a brace-depth parser.
+     */
+    private parseICUOptions;
+    private getPluralCategory;
+}
+/**
+ * i18n construction options
+ */
+export interface I18nOptions {
+    /** Default locale to use */
+    readonly defaultLocale?: LocaleId;
+    /** Handler for missing translation keys */
+    readonly onMissingKey?: MissingKeyHandler;
+}
+/**
+ * Handler called when a translation key is not found
+ */
+export type MissingKeyHandler = (key: string, locale: LocaleId) => string;
+/**
+ * Create an i18n capability instance
+ */
+export declare function createI18nCapability(options?: I18nOptions): I18nCapability;
+//# sourceMappingURL=translator.d.ts.map

package/dist/i18n/translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAElB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAMnB;;GAEG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;gBAEzC,OAAO,CAAC,EAAE,WAAW;IAMjC,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIzC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAYvE,aAAa,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IA+BvD,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAInC,SAAS,IAAI,QAAQ;IAIrB,YAAY,IAAI,SAAS,QAAQ,EAAE;IAInC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM;IAc1E,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM;IAIlE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM;IAqBlE,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM;IAuBrE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpC,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,SAAS;IAwBjB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,aAAa;IAYrB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,iBAAiB;CAa1B;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAA;IAEjC,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,KAAK,MAAM,CAAA;AAazE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAE1E"}