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

package/dist/cache/memory.d.ts

@@ -0,0 +1,33 @@
+/**
+ * In-Memory Cache
+ *
+ * In-memory cache implementation
+ *
+ * @module @pwfabric/runtime/cache/memory
+ */
+import type { CacheProvider, CacheStats, CacheConfig } from './types.js';
+/**
+ * In-memory cache implementation with LRU eviction
+ */
+export declare class InMemoryCache implements CacheProvider {
+    private readonly cache;
+    private readonly config;
+    private hits;
+    private misses;
+    constructor(config?: CacheConfig);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    stats(): CacheStats;
+    private evict;
+    private evictLru;
+    private evictLfu;
+    private evictFifo;
+}
+/**
+ * Create an in-memory cache
+ */
+export declare function createMemoryCache(config?: CacheConfig): CacheProvider;
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/cache/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAc,WAAW,EAAE,MAAM,YAAY,CAAA;AAMpF;;GAEG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;gBAEN,MAAM,GAAE,WAAgB;IAQ9B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA6B3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAalC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,KAAK,IAAI,UAAU;IASnB,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,SAAS;CAIlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAErE"}

package/dist/cache/memory.js

@@ -0,0 +1,138 @@
+/**
+ * In-Memory Cache
+ *
+ * In-memory cache implementation
+ *
+ * @module @pwfabric/runtime/cache/memory
+ */
+// ============================================================
+// IN-MEMORY CACHE
+// ============================================================
+/**
+ * In-memory cache implementation with LRU eviction
+ */
+export class InMemoryCache {
+    cache = new Map();
+    config;
+    hits = 0;
+    misses = 0;
+    constructor(config = {}) {
+        this.config = {
+            maxSize: config.maxSize ?? 1000,
+            defaultTtl: config.defaultTtl ?? 300000, // 5 minutes
+            evictionPolicy: config.evictionPolicy ?? 'lru',
+        };
+    }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return undefined;
+        }
+        // Check expiration
+        if (entry.expiresAt && entry.expiresAt < Date.now()) {
+            this.cache.delete(key);
+            this.misses++;
+            return undefined;
+        }
+        // Update hit count and move to end for LRU
+        this.hits++;
+        const updated = {
+            ...entry,
+            hits: entry.hits + 1,
+        };
+        // LRU: delete and re-add to move to end
+        this.cache.delete(key);
+        this.cache.set(key, updated);
+        return entry.value;
+    }
+    async set(key, value, ttl) {
+        // Evict if at max size
+        if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+            this.evict();
+        }
+        const entry = {
+            value,
+            createdAt: Date.now(),
+            hits: 0,
+        };
+        // Only set expiresAt if TTL is specified
+        if (ttl !== undefined) {
+            ;
+            entry.expiresAt = Date.now() + ttl;
+        }
+        this.cache.set(key, entry);
+    }
+    async delete(key) {
+        return this.cache.delete(key);
+    }
+    async has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        // Check expiration
+        if (entry.expiresAt && entry.expiresAt < Date.now()) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    async clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    stats() {
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            size: this.cache.size,
+            maxSize: this.config.maxSize,
+        };
+    }
+    evict() {
+        switch (this.config.evictionPolicy) {
+            case 'lru':
+                this.evictLru();
+                break;
+            case 'lfu':
+                this.evictLfu();
+                break;
+            case 'fifo':
+                this.evictFifo();
+                break;
+        }
+    }
+    evictLru() {
+        // Map maintains insertion order, first item is LRU
+        const firstKey = this.cache.keys().next().value;
+        if (firstKey) {
+            this.cache.delete(firstKey);
+        }
+    }
+    evictLfu() {
+        // Find entry with lowest hit count
+        let minHits = Infinity;
+        let minKey;
+        for (const [key, entry] of this.cache) {
+            if (entry.hits < minHits) {
+                minHits = entry.hits;
+                minKey = key;
+            }
+        }
+        if (minKey) {
+            this.cache.delete(minKey);
+        }
+    }
+    evictFifo() {
+        // Same as LRU for Map since it maintains insertion order
+        this.evictLru();
+    }
+}
+/**
+ * Create an in-memory cache
+ */
+export function createMemoryCache(config) {
+    return new InMemoryCache(config);
+}
+//# sourceMappingURL=memory.js.map

package/dist/cache/memory.js.map

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

package/dist/cache/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Cache Types
+ *
+ * Caching system types
+ *
+ * @module @pwfabric/runtime/cache/types
+ */
+/**
+ * Cache provider interface
+ */
+export interface CacheProvider {
+    /**
+     * Get a value from cache
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * Set a value in cache
+     */
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a value from cache
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if a key exists
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    stats(): CacheStats;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    readonly hits: number;
+    readonly misses: number;
+    readonly size: number;
+    readonly maxSize?: number;
+}
+/**
+ * Cache entry with metadata
+ */
+export interface CacheEntry<T> {
+    readonly value: T;
+    readonly createdAt: number;
+    readonly expiresAt?: number;
+    readonly hits: number;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    readonly maxSize?: number;
+    readonly defaultTtl?: number;
+    readonly evictionPolicy?: 'lru' | 'lfu' | 'fifo';
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAE3C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAErC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAElC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtB;;OAEG;IACH,KAAK,IAAI,UAAU,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;CACjD"}

package/dist/cache/types.js

@@ -0,0 +1,9 @@
+/**
+ * Cache Types
+ *
+ * Caching system types
+ *
+ * @module @pwfabric/runtime/cache/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

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

package/dist/capability/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Capability Module — Canonical 4-Capability Registry
+ *
+ * ## Single Source of Truth
+ *
+ * `platform-capabilities.ts` is the canonical source for all platform
+ * capabilities. Everything below is derived from `platformCapabilities`
+ * or re-exported from siblings. Add/remove a capability there — this file
+ * and all consumers stay in sync automatically.
+ *
+ * ## Canonical Count: 4
+ *
+ * - platform/persistence (data + state, merger)
+ * - platform/entities (schema-driven entity CRUD; canonical form write path)
+ * - platform/navigation (renamed from routing)
+ * - platform/interaction (event-driven rules, replaces behaviors)
+ *
+ * ## Removed (historical)
+ *
+ * - platform/auth — phantom capability
+ * - ai/content, ai/style, ai/compose, ai/spawn — facade layer
+ * - platform/analytics, platform/seo, platform/i18n — Tier 3 deferred
+ * - platform/routing — renamed to platform/navigation
+ * - platform/input — hard cutover; form writes via platform/entities
+ *
+ * @module @pwfabric/runtime/capability
+ */
+export { persistenceCapability, entitiesCapability, navigationCapability, interactionCapability, platformCapabilities, registerPlatformCapabilities, } from './platform-capabilities.js';
+/**
+ * Canonical capability IDs — derived from the `platformCapabilities` array.
+ *
+ * Drift-proof: if `platformCapabilities` changes, this updates automatically.
+ * Consumers should import this constant rather than hardcoding the list.
+ */
+export declare const CANONICAL_CAPABILITY_IDS: readonly string[];
+/**
+ * Canonical capability count. Should remain 4 until a governance-approved
+ * change adds/removes a capability (dropped platform/input).
+ */
+export declare const CAPABILITY_COUNT: number;
+export { CAPABILITY_TYPE_TO_ID, CAPABILITY_TYPES, CAPABILITY_IDS, resolveCapabilityId, resolveCapabilityType, isKnownCapabilityType, canonicalCapabilityId, isCapability, } from './type-mapping.js';
+export { type CapabilityRequirement, type CapabilityValidationResult, validateSurfaceCapabilities, } from './validation.js';
+import type { Capability } from '@pwfabric/contracts';
+/**
+ * Tenant-registry lookup function injected by the runtime host.
+ *
+ * the hardcoded fallback is RETIRED. Callers MUST pass a
+ * lookup backed by `workspace_capabilities` (or an equivalent data source).
+ * A registry miss is a hard error — no silent fall-through to a global list.
+ */
+export type TenantCapabilityLookup = (id: string, worldId: string) => Promise<Capability | null>;
+/**
+ * Registry-first capability resolve.
+ *
+ * @throws if the lookup is missing or the capability is not installed for
+ *   the tenant. No fallback — pack install fan-out is the sole source of
+ *   truth for what a tenant can resolve.
+ */
+export declare function resolveCapability(id: string, worldId: string, lookup: TenantCapabilityLookup): Promise<Capability>;
+/**
+ * Tenant-registry list function injected by the runtime host.
+ */
+export type TenantCapabilityList = (worldId: string) => Promise<readonly Capability[]>;
+/**
+ * Registry-first capability list.
+ *
+ * Returns the full set of capabilities installed for a tenant. No fallback
+ * to the canonical platformCapabilities array — an empty install state
+ * returns `[]`, which the caller must handle (usually by telling the user
+ * their plan bundle is empty).
+ */
+export declare function listCapabilities(worldId: string, list: TenantCapabilityList): Promise<readonly Capability[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAA;AAMnC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAA0C,CAAA;AAEhG;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAoC,CAAA;AAQnE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EAIrB,qBAAqB,EACrB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAM1B,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAA;AAMxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;AAEhG;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAA;AAEtF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAEhC"}

package/dist/capability/index.js

@@ -0,0 +1,87 @@
+/**
+ * Capability Module — Canonical 4-Capability Registry
+ *
+ * ## Single Source of Truth
+ *
+ * `platform-capabilities.ts` is the canonical source for all platform
+ * capabilities. Everything below is derived from `platformCapabilities`
+ * or re-exported from siblings. Add/remove a capability there — this file
+ * and all consumers stay in sync automatically.
+ *
+ * ## Canonical Count: 4
+ *
+ * - platform/persistence (data + state, merger)
+ * - platform/entities (schema-driven entity CRUD; canonical form write path)
+ * - platform/navigation (renamed from routing)
+ * - platform/interaction (event-driven rules, replaces behaviors)
+ *
+ * ## Removed (historical)
+ *
+ * - platform/auth — phantom capability
+ * - ai/content, ai/style, ai/compose, ai/spawn — facade layer
+ * - platform/analytics, platform/seo, platform/i18n — Tier 3 deferred
+ * - platform/routing — renamed to platform/navigation
+ * - platform/input — hard cutover; form writes via platform/entities
+ *
+ * @module @pwfabric/runtime/capability
+ */
+import { platformCapabilities } from './platform-capabilities.js';
+// ============================================================
+// CANONICAL CAPABILITY EXPORTS (SOURCE OF TRUTH)
+// ============================================================
+export { persistenceCapability, entitiesCapability, navigationCapability, interactionCapability, platformCapabilities, registerPlatformCapabilities, } from './platform-capabilities.js';
+// ============================================================
+// DERIVED CANONICAL CONSTANTS (from platformCapabilities)
+// ============================================================
+/**
+ * Canonical capability IDs — derived from the `platformCapabilities` array.
+ *
+ * Drift-proof: if `platformCapabilities` changes, this updates automatically.
+ * Consumers should import this constant rather than hardcoding the list.
+ */
+export const CANONICAL_CAPABILITY_IDS = platformCapabilities.map((c) => c.id);
+/**
+ * Canonical capability count. Should remain 4 until a governance-approved
+ * change adds/removes a capability (dropped platform/input).
+ */
+export const CAPABILITY_COUNT = platformCapabilities.length;
+// ============================================================
+// TYPE MAPPING (starter short-form ↔ full IDs)
+//
+// Translates between the short-form capability types and the full IDs.
+// ============================================================
+export { CAPABILITY_TYPE_TO_ID, CAPABILITY_TYPES, CAPABILITY_IDS, resolveCapabilityId, resolveCapabilityType, isKnownCapabilityType, 
+// The canonical resolver every reader needed: accepts either spelling and
+// answers with the one id the registry, the pack's atoms and the drift guard
+// all agree on.
+canonicalCapabilityId, isCapability, } from './type-mapping.js';
+// ============================================================
+// SURFACE CAPABILITY VALIDATION
+// ============================================================
+export { validateSurfaceCapabilities, } from './validation.js';
+/**
+ * Registry-first capability resolve.
+ *
+ * @throws if the lookup is missing or the capability is not installed for
+ *   the tenant. No fallback — pack install fan-out is the sole source of
+ *   truth for what a tenant can resolve.
+ */
+export async function resolveCapability(id, worldId, lookup) {
+    const fromRegistry = await lookup(id, worldId);
+    if (fromRegistry)
+        return fromRegistry;
+    throw new Error(`Capability "${id}" is not installed for tenant "${worldId}". ` +
+        `Install the providing pack via the plan bundle or marketplace install.`);
+}
+/**
+ * Registry-first capability list.
+ *
+ * Returns the full set of capabilities installed for a tenant. No fallback
+ * to the canonical platformCapabilities array — an empty install state
+ * returns `[]`, which the caller must handle (usually by telling the user
+ * their plan bundle is empty).
+ */
+export async function listCapabilities(worldId, list) {
+    return list(worldId);
+}
+//# sourceMappingURL=index.js.map

package/dist/capability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE,+DAA+D;AAC/D,iDAAiD;AACjD,+DAA+D;AAE/D,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAA;AAEnC,+DAA+D;AAC/D,0DAA0D;AAC1D,+DAA+D;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAEhG;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAW,oBAAoB,CAAC,MAAM,CAAA;AAEnE,+DAA+D;AAC/D,+CAA+C;AAC/C,EAAE;AACF,uEAAuE;AACvE,+DAA+D;AAE/D,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB;AACrB,0EAA0E;AAC1E,6EAA6E;AAC7E,gBAAgB;AAChB,qBAAqB,EACrB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAE1B,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAE/D,OAAO,EAGL,2BAA2B,GAC5B,MAAM,iBAAiB,CAAA;AAiBxB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAU,EACV,OAAe,EACf,MAA8B;IAE9B,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC9C,IAAI,YAAY;QAAE,OAAO,YAAY,CAAA;IACrC,MAAM,IAAI,KAAK,CACb,eAAe,EAAE,kCAAkC,OAAO,KAAK;QAC7D,wEAAwE,CAC3E,CAAA;AACH,CAAC;AAOD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,IAA0B;IAE1B,OAAO,IAAI,CAAC,OAAO,CAAC,CAAA;AACtB,CAAC"}

package/dist/capability/kernel-capabilities.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tier 0 — Kernel Capabilities
+ *
+ * Platform infrastructure that is always active, plan-independent,
+ * and non-toggleable. These are NOT capabilities in the entitlement sense —
+ * they are substrate components that must be present for any surface to render.
+ *
+ * Kernel components are NOT shown in a host's plan editor, NOT listed in
+ * any pack catalogue, and NOT included in `ALWAYS_ON_CAPABILITY_IDS` or any
+ * entitlement check. They exist below the capability tier system.
+ *
+ * @module @pwfabric/runtime/capability/kernel-capabilities
+ * @see — Tier 0: Runtime Infrastructure (Kernel)
+ */
+/**
+ * Canonical list of Tier 0 kernel component identifiers.
+ *
+ * These are informational — used for documentation, logging, and
+ * internal diagnostics. Not checked against any entitlement grant.
+ */
+export declare const KERNEL_COMPONENT_IDS: readonly ["surface-event-bus", "surface-renderer", "behavior-surface-provider", "capability-kernel", "capability-registry"];
+export type KernelComponentId = (typeof KERNEL_COMPONENT_IDS)[number];
+/**
+ * Tier 0 capability ID tokens (Kernel tier).
+ *
+ * `surface` is the single Tier 0 identifier used in
+ * `KERNEL_CAPABILITY_IDS` (bundle-manifests.ts). It represents the
+ * capability system bootstrap — the surface itself.
+ */
+export declare const KERNEL_CAPABILITY_IDS: readonly ["surface"];
+export type KernelCapabilityId = (typeof KERNEL_CAPABILITY_IDS)[number];
+//# sourceMappingURL=kernel-capabilities.d.ts.map

package/dist/capability/kernel-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-capabilities.d.ts","sourceRoot":"","sources":["../../src/capability/kernel-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,6HAMvB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,sBAAuB,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/capability/kernel-capabilities.js

@@ -0,0 +1,36 @@
+/**
+ * Tier 0 — Kernel Capabilities
+ *
+ * Platform infrastructure that is always active, plan-independent,
+ * and non-toggleable. These are NOT capabilities in the entitlement sense —
+ * they are substrate components that must be present for any surface to render.
+ *
+ * Kernel components are NOT shown in a host's plan editor, NOT listed in
+ * any pack catalogue, and NOT included in `ALWAYS_ON_CAPABILITY_IDS` or any
+ * entitlement check. They exist below the capability tier system.
+ *
+ * @module @pwfabric/runtime/capability/kernel-capabilities
+ * @see — Tier 0: Runtime Infrastructure (Kernel)
+ */
+/**
+ * Canonical list of Tier 0 kernel component identifiers.
+ *
+ * These are informational — used for documentation, logging, and
+ * internal diagnostics. Not checked against any entitlement grant.
+ */
+export const KERNEL_COMPONENT_IDS = [
+    'surface-event-bus',
+    'surface-renderer',
+    'behavior-surface-provider',
+    'capability-kernel',
+    'capability-registry',
+];
+/**
+ * Tier 0 capability ID tokens (Kernel tier).
+ *
+ * `surface` is the single Tier 0 identifier used in
+ * `KERNEL_CAPABILITY_IDS` (bundle-manifests.ts). It represents the
+ * capability system bootstrap — the surface itself.
+ */
+export const KERNEL_CAPABILITY_IDS = ['surface'];
+//# sourceMappingURL=kernel-capabilities.js.map

package/dist/capability/kernel-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-capabilities.js","sourceRoot":"","sources":["../../src/capability/kernel-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,mBAAmB;IACnB,kBAAkB;IAClB,2BAA2B;IAC3B,mBAAmB;IACnB,qBAAqB;CACb,CAAA;AAIV;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,CAAU,CAAA"}

package/dist/capability/platform-capabilities.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Platform Capability Definitions
+ *
+ * Canonical capability taxonomy.
+ * - persistence replaces data + state (merged)
+ * - interaction replaces behaviors (Tier 2)
+ * - entities is the canonical form write path
+ *
+ * platform/auth phantom capability removed — real auth
+ * enforcement lives in JWT middleware (requireAuthenticated()), not
+ * the capability system.
+ *
+ * platform/input retired — form submissions flow through
+ * platform/entities (entity_records), hard cutover, no fallback.
+ *
+ * Active capabilities: persistence, entities, navigation, interaction.
+ *
+ * @module @pwfabric/runtime/capability/platform-capabilities
+ */
+import type { Capability } from '@pwfabric/contracts';
+import type { CapabilityRegistry } from '../registry.js';
+/**
+ * Persistence capability
+ *
+ * Merges former data + state capabilities.
+ * Provides data fetching, mutation, persistence operations, and
+ * client-side state management with optional local storage persistence.
+ */
+export declare const persistenceCapability: Capability<import("@pwfabric/core").CapabilityId, unknown, unknown, readonly import("@pwfabric/core").CapabilityId[]>;
+/**
+ * Navigation capability
+ *
+ * Provides multi-page surface navigation, base path configuration, and route handling.
+ * Renamed from routingCapability (platform/routing) to avoid confusion with framework-level routing.
+ */
+export declare const navigationCapability: Capability<import("@pwfabric/core").CapabilityId, unknown, unknown, readonly import("@pwfabric/core").CapabilityId[]>;
+/**
+ * Interaction capability
+ *
+ * Replaces former behaviors capability.
+ * Provides event-driven interaction rules for dynamic surfaces.
+ */
+export declare const interactionCapability: Capability<import("@pwfabric/core").CapabilityId, unknown, unknown, readonly import("@pwfabric/core").CapabilityId[]>;
+/**
+ * Entities capability — NEW Tier 1 capability.
+ *
+ * Schema-driven entity definitions, CRUD store, and connector abstraction.
+ */
+export declare const entitiesCapability: Capability<import("@pwfabric/core").CapabilityId, unknown, unknown, readonly import("@pwfabric/core").CapabilityId[]>;
+/**
+ * All platform capabilities as an array.
+ *
+ * SOURCE OF TRUTH — derive all other lists from this array (see index.ts).
+ * platform/auth removed (phantom capability).
+ * routing renamed to navigation.
+ * platform/input removed — form writes flow through platform/entities.
+ */
+export declare const platformCapabilities: readonly Capability[];
+/**
+ * Register all platform capabilities with a registry
+ *
+ * @param registry - The capability registry to register with
+ * @returns An object with successfully registered IDs and any errors
+ */
+export declare function registerPlatformCapabilities(registry: CapabilityRegistry): {
+    registered: readonly string[];
+    errors: readonly {
+        id: string;
+        error: string;
+    }[];
+};
+//# sourceMappingURL=platform-capabilities.d.ts.map

package/dist/capability/platform-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-capabilities.d.ts","sourceRoot":"","sources":["../../src/capability/platform-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AA2IxD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,uHAiBxB,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,uHAqBvB,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,uHAYxB,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,uHA2BrB,CAAA;AAMV;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,UAAU,EAK5C,CAAA;AAEV;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,kBAAkB,GAAG;IAC1E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,MAAM,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACjD,CAiBA"}