@plasius/player-system-interface 0.1.4 → 0.1.6

package/README.md

@@ -25,6 +25,7 @@ npm install @plasius/player-system-interface
 - focus panes and combat-safe reductions
 - world-space overlay panel definitions
 - target popup anchors and alert markers
+- self-state and line-of-sight identity projection overlays
 - overlay accessibility contracts for keyboard, focus restoration, and announcements
 - frame-budget assumptions for diegetic panel updates
 - Party/System composition metadata
@@ -127,6 +128,41 @@ The inherited feature flag for this work is `isekai.player-system.interface.enab
 - Party and Player System surfaces can coexist in one shell definition
 - reduced-combat behavior is explicit per surface and bounded by the shell policy
 
+## Identity Status Overlays
+
+`createIdentityStatusOverlayDefinition()` represents the Identity System's
+self-state and explicit external target projections. The inherited feature
+flag is `isekai.player-system.identity.enabled`.
+
+- Self-state overlays use the `self-state` invocation and never require line of
+  sight.
+- External overlays require an explicit `identity-sweep` or `spell-targeting`
+  invocation and line of sight.
+- `allied`, `neutral`, `unknown`, and `unfriendly` are operational targeting
+  categories, not absolute moral truth labels.
+- `readableFacts` must be a subset of `perceivableFacts`; use `partial`,
+  `fuzzy`, or `withheld` confidence when identity truth is incomplete.
+- Add identity overlays to a shell with an `identity-overlay` surface and use
+  `assessIdentityStatusOverlayDefinition()` / `assessInterfaceShellDefinition()`
+  before rendering.
+
+## Shell State, 3D Panes, and Ambient Alerts
+
+`createInterfaceShellState()` represents ambient, focused, and combat-safe
+visibility without coupling the package to a renderer. Combat-safe state keeps
+only retained surface kinds and never exposes suspended surfaces. Use
+`applyInterfaceShellFocusShift()` for keyboard, direct-hotkey, restore, or
+system focus changes; shifts to hidden surfaces are rejected.
+
+`createThreeDPaneHostDefinition()` associates a pane with a shell surface,
+world anchor, and supported host adapters. It describes the host boundary but
+does not own rendering or scene orchestration.
+
+`createLocalizedAmbientAlertDefinition()` stores an allowlisted locale-to-copy
+map with an explicit live-region mode. Resolve the best available copy with
+`resolveLocalizedAmbientAlertMessage()` and validate pane/alert composition with
+`assessInterfaceShellDefinition()`.
+
 ## Governance
 
 - ADRs: [docs/adrs](./docs/adrs)
@@ -135,3 +171,4 @@ The inherited feature flag for this work is `isekai.player-system.interface.enab
 - Parent feature flag: `isekai.player-system.interface.enabled`
 - Capability: not required for package bootstrap; interface adoption remains feature-flag led
 - Rollback: disable `isekai.player-system.interface.enabled` to halt package-family adoption without changing package code
+- Identity rollback: disable `isekai.player-system.identity.enabled` to stop identity projection adoption without changing package code

package/dist/index.cjs

@@ -20,26 +20,34 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID: () => PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_INTERFACE_ENV_PREFIX: () => PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,
   PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID: () => PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_INTERFACE_PACKAGE: () => PLAYER_SYSTEM_INTERFACE_PACKAGE,
   PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID: () => PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID: () => PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID: () => PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,
+  applyInterfaceShellFocusShift: () => applyInterfaceShellFocusShift,
+  assessIdentityStatusOverlayDefinition: () => assessIdentityStatusOverlayDefinition,
   assessInterfaceShellDefinition: () => assessInterfaceShellDefinition,
   assessPlayerSystemInterfaceComposition: () => assessPlayerSystemInterfaceComposition,
   createFocusPaneShellDefinition: () => createFocusPaneShellDefinition,
+  createIdentityStatusOverlayDefinition: () => createIdentityStatusOverlayDefinition,
   createInterfaceShellDefinition: () => createInterfaceShellDefinition,
+  createInterfaceShellState: () => createInterfaceShellState,
   createInterfaceShellSurfaceDefinition: () => createInterfaceShellSurfaceDefinition,
   createLineOfSightTargetPopupDefinition: () => createLineOfSightTargetPopupDefinition,
+  createLocalizedAmbientAlertDefinition: () => createLocalizedAmbientAlertDefinition,
   createPlayerSystemInterfaceContract: () => createPlayerSystemInterfaceContract,
   createPlayerSystemInterfacePortabilityContract: () => createPlayerSystemInterfacePortabilityContract,
+  createThreeDPaneHostDefinition: () => createThreeDPaneHostDefinition,
   createWorldSpacePanelDefinition: () => createWorldSpacePanelDefinition,
   defaultPlayerSystemInterfaceContract: () => defaultPlayerSystemInterfaceContract,
   defaultPlayerSystemInterfacePortabilityContract: () => defaultPlayerSystemInterfacePortabilityContract,
   defaultReducedCombatOverlayPolicy: () => defaultReducedCombatOverlayPolicy,
   isPlayerSystemInterfaceMode: () => isPlayerSystemInterfaceMode,
-  packageDescriptor: () => packageDescriptor
+  packageDescriptor: () => packageDescriptor,
+  resolveLocalizedAmbientAlertMessage: () => resolveLocalizedAmbientAlertMessage
 });
 module.exports = __toCommonJS(index_exports);
 var PLAYER_SYSTEM_INTERFACE_PACKAGE = "@plasius/player-system-interface";
@@ -48,6 +56,7 @@ var PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID = "isekai.player-system.interface.en
 var PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID = PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;
 var PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID = PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;
 var PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID = PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;
+var PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID = "isekai.player-system.identity.enabled";
 var packageDescriptor = Object.freeze({
   packageName: PLAYER_SYSTEM_INTERFACE_PACKAGE,
   featureFlagId: PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,
@@ -100,7 +109,8 @@ var defaultReducedCombatOverlayPolicy = Object.freeze({
   retainedSurfaceKinds: Object.freeze([
     "alert-marker",
     "target-popup",
-    "focus-pane"
+    "focus-pane",
+    "identity-overlay"
   ]),
   maxInteractiveSurfaces: 1
 });
@@ -154,12 +164,34 @@ function createFocusPaneShellDefinition(input) {
 function createLineOfSightTargetPopupDefinition(input) {
   return Object.freeze({ ...input });
 }
+function createIdentityStatusOverlayDefinition(input) {
+  return Object.freeze({
+    ...input,
+    perceivableFacts: Object.freeze([...input.perceivableFacts]),
+    readableFacts: Object.freeze([...input.readableFacts])
+  });
+}
+function createThreeDPaneHostDefinition(input) {
+  return Object.freeze({
+    ...input,
+    supportedHosts: Object.freeze([...input.supportedHosts])
+  });
+}
+function createLocalizedAmbientAlertDefinition(input) {
+  return Object.freeze({
+    ...input,
+    localizedMessages: Object.freeze({ ...input.localizedMessages })
+  });
+}
 function createInterfaceShellDefinition(input = {}) {
   return Object.freeze({
     featureFlagId: input.featureFlagId ?? PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,
     surfaces: Object.freeze([...input.surfaces ?? []]),
     focusPane: input.focusPane ? Object.freeze({ ...input.focusPane }) : void 0,
     targetPopups: Object.freeze([...input.targetPopups ?? []]),
+    identityOverlays: Object.freeze([...input.identityOverlays ?? []]),
+    paneHosts: Object.freeze([...input.paneHosts ?? []]),
+    ambientAlerts: Object.freeze([...input.ambientAlerts ?? []]),
     reducedCombat: Object.freeze({
       ...defaultReducedCombatOverlayPolicy,
       ...input.reducedCombat,
@@ -169,6 +201,73 @@ function createInterfaceShellDefinition(input = {}) {
     })
   });
 }
+function createInterfaceShellState(shell, input) {
+  const retainedSurfaceKinds = new Set(
+    shell.reducedCombat.retainedSurfaceKinds
+  );
+  const visibleSurfaceIds = shell.surfaces.filter(
+    (surface) => input.mode !== "combat-safe" || surface.combatBehavior !== "suspend" && retainedSurfaceKinds.has(surface.kind)
+  ).map((surface) => surface.surfaceId);
+  if (input.focusedSurfaceId && !visibleSurfaceIds.includes(input.focusedSurfaceId)) {
+    throw new RangeError(
+      `Focused surface '${input.focusedSurfaceId}' is not visible in ${input.mode} mode`
+    );
+  }
+  return Object.freeze({
+    featureFlagId: shell.featureFlagId,
+    mode: input.mode,
+    focusedSurfaceId: input.mode === "focused" ? input.focusedSurfaceId : void 0,
+    visibleSurfaceIds: Object.freeze(visibleSurfaceIds)
+  });
+}
+function applyInterfaceShellFocusShift(state, focusShift) {
+  if (!state.visibleSurfaceIds.includes(focusShift.toSurfaceId)) {
+    throw new RangeError(
+      `Focused surface '${focusShift.toSurfaceId}' is not visible in ${state.mode} mode`
+    );
+  }
+  return Object.freeze({
+    ...state,
+    mode: "focused",
+    focusedSurfaceId: focusShift.toSurfaceId,
+    focusShift: Object.freeze({ ...focusShift })
+  });
+}
+function resolveLocalizedAmbientAlertMessage(alert, locale, fallbackLocale = "en-GB") {
+  return alert.localizedMessages[locale] ?? alert.localizedMessages[fallbackLocale];
+}
+function assessIdentityStatusOverlayDefinition(overlay) {
+  const violations = [];
+  const perceivableFacts = new Set(overlay.perceivableFacts);
+  if (overlay.readableFacts.some((fact) => !perceivableFacts.has(fact))) {
+    violations.push("readableFacts");
+  }
+  if (overlay.readConfidence === "withheld" && overlay.readableFacts.length > 0) {
+    violations.push("withheldRead");
+  }
+  if (overlay.targetKind === "self") {
+    if (overlay.relation !== "self") {
+      violations.push("selfRelation");
+    }
+    if (overlay.invocation !== "self-state") {
+      violations.push("selfInvocation");
+    }
+    if (overlay.requiresLineOfSight) {
+      violations.push("selfLineOfSight");
+    }
+  } else {
+    if (overlay.targetId.length === 0) {
+      violations.push("targetId");
+    }
+    if (!overlay.requiresLineOfSight) {
+      violations.push("lineOfSight");
+    }
+  }
+  return Object.freeze({
+    accepted: violations.length === 0,
+    violations: Object.freeze(violations)
+  });
+}
 function assessPlayerSystemInterfaceComposition(sample, contract = defaultPlayerSystemInterfacePortabilityContract) {
   const violations = [];
   if (sample.panelCount > contract.compositionScale.maxWorldPanels) {
@@ -218,6 +317,31 @@ function assessInterfaceShellDefinition(shell) {
       violations.push(`popup:${popup.popupId}`);
     }
   }
+  for (const overlay of shell.identityOverlays) {
+    const identityAssessment = assessIdentityStatusOverlayDefinition(overlay);
+    for (const violation of identityAssessment.violations) {
+      violations.push(`identityOverlay:${overlay.overlayId}:${violation}`);
+    }
+    const matchingSurface = shell.surfaces.find(
+      (surface) => surface.surfaceId === overlay.surfaceId && surface.kind === "identity-overlay"
+    );
+    if (!matchingSurface) {
+      violations.push(`identityOverlaySurface:${overlay.overlayId}`);
+    }
+  }
+  for (const paneHost of shell.paneHosts) {
+    const matchingSurface = shell.surfaces.find(
+      (surface) => surface.surfaceId === paneHost.surfaceId && surface.owner === paneHost.owner && surface.anchorId === paneHost.anchorId
+    );
+    if (!matchingSurface) {
+      violations.push(`paneHost:${paneHost.hostId}`);
+    }
+  }
+  for (const alert of shell.ambientAlerts) {
+    if (Object.keys(alert.localizedMessages).length === 0) {
+      violations.push(`alert:${alert.alertId}`);
+    }
+  }
   if (ownerSet.has("player-system") && ownerSet.has("party-system") && shell.reducedCombat.retainedSurfaceKinds.length === 0) {
     violations.push("reducedCombat");
   }
@@ -228,25 +352,33 @@ function assessInterfaceShellDefinition(shell) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,
   PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_INTERFACE_PACKAGE,
   PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,
+  applyInterfaceShellFocusShift,
+  assessIdentityStatusOverlayDefinition,
   assessInterfaceShellDefinition,
   assessPlayerSystemInterfaceComposition,
   createFocusPaneShellDefinition,
+  createIdentityStatusOverlayDefinition,
   createInterfaceShellDefinition,
+  createInterfaceShellState,
   createInterfaceShellSurfaceDefinition,
   createLineOfSightTargetPopupDefinition,
+  createLocalizedAmbientAlertDefinition,
   createPlayerSystemInterfaceContract,
   createPlayerSystemInterfacePortabilityContract,
+  createThreeDPaneHostDefinition,
   createWorldSpacePanelDefinition,
   defaultPlayerSystemInterfaceContract,
   defaultPlayerSystemInterfacePortabilityContract,
   defaultReducedCombatOverlayPolicy,
   isPlayerSystemInterfaceMode,
-  packageDescriptor
+  packageDescriptor,
+  resolveLocalizedAmbientAlertMessage
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface PackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nexport type OverlayKeyboardPath = \"sequential\" | \"direct-hotkey\" | \"read-only\";\n\nexport interface OverlayAccessibilityContract {\n  readonly keyboardPath: OverlayKeyboardPath;\n  readonly focusRestorationTarget: \"trigger\" | \"pane-heading\" | \"nearest-anchor\";\n  readonly liveRegionMode: \"polite\" | \"assertive\" | \"off\";\n  readonly requiresAccessibleName: boolean;\n}\n\nexport interface InterfaceFrameBudget {\n  readonly targetFps: number;\n  readonly maxFrameMs: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport type OverlayHostKind =\n  | \"dom-overlay\"\n  | \"native-overlay\"\n  | \"headless-snapshot\";\n\nexport type OverlayAdapterCapability =\n  | \"focus-restoration\"\n  | \"live-region\"\n  | \"anchor-registry\";\n\nexport interface OverlayHostAdapterContract {\n  readonly supportedHosts: readonly OverlayHostKind[];\n  readonly requiredCapabilities: readonly OverlayAdapterCapability[];\n  readonly forbiddenAssumptions: readonly string[];\n}\n\nexport interface OverlayCompositionScaleContract {\n  readonly maxWorldPanels: number;\n  readonly maxFocusPanes: number;\n  readonly maxAlertMarkers: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport interface PlayerSystemInterfaceContract {\n  readonly featureFlagId: string;\n  readonly accessibility: OverlayAccessibilityContract;\n  readonly frameBudget: InterfaceFrameBudget;\n}\n\nexport interface PlayerSystemInterfacePortabilityContract {\n  readonly featureFlagId: string;\n  readonly hostAdapters: OverlayHostAdapterContract;\n  readonly compositionScale: OverlayCompositionScaleContract;\n}\n\nexport interface PlayerSystemInterfaceContractInput {\n  readonly featureFlagId?: string;\n  readonly accessibility?: Partial<OverlayAccessibilityContract>;\n  readonly frameBudget?: Partial<InterfaceFrameBudget>;\n}\n\nexport interface PlayerSystemInterfacePortabilityContractInput {\n  readonly featureFlagId?: string;\n  readonly hostAdapters?: Partial<OverlayHostAdapterContract>;\n  readonly compositionScale?: Partial<OverlayCompositionScaleContract>;\n}\n\nexport type PlayerSystemInterfaceMode = \"ambient\" | \"focused\" | \"combat-safe\";\n\nexport type PlayerSystemPaneId =\n  | \"identity\"\n  | \"missions\"\n  | \"guild-quests\"\n  | \"logs\"\n  | \"mcc\"\n  | \"tutorial\"\n  | \"points-store\";\n\nexport type InterfaceShellOwner = \"player-system\" | \"party-system\";\nexport type InterfaceShellSurfaceKind =\n  | \"world-panel\"\n  | \"focus-pane\"\n  | \"target-popup\"\n  | \"alert-marker\";\nexport type InterfaceCombatBehavior = \"persist\" | \"reduce\" | \"suspend\";\n\nexport interface InterfaceShellSurfaceDefinition {\n  readonly surfaceId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly kind: InterfaceShellSurfaceKind;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly priority: number;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface FocusPaneShellDefinition {\n  readonly panelId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly heading: string;\n  readonly interactive: boolean;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface LineOfSightTargetPopupDefinition {\n  readonly popupId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly anchorId: string;\n  readonly targetId: string;\n  readonly summary: string;\n  readonly requiresLineOfSight: boolean;\n  readonly actionLabel?: string;\n}\n\nexport interface ReducedCombatOverlayPolicy {\n  readonly featureFlagId: string;\n  readonly mode: \"combat-safe\";\n  readonly retainedSurfaceKinds: readonly InterfaceShellSurfaceKind[];\n  readonly maxInteractiveSurfaces: number;\n}\n\nexport interface InterfaceShellDefinition {\n  readonly featureFlagId: string;\n  readonly surfaces: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups: readonly LineOfSightTargetPopupDefinition[];\n  readonly reducedCombat: ReducedCombatOverlayPolicy;\n}\n\nexport interface InterfaceShellDefinitionInput {\n  readonly featureFlagId?: string;\n  readonly surfaces?: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups?: readonly LineOfSightTargetPopupDefinition[];\n  readonly reducedCombat?: Partial<ReducedCombatOverlayPolicy>;\n}\n\nexport interface WorldSpacePanelDefinition {\n  readonly panelId: string;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly accessibilityLabel?: string;\n  readonly focusOrder?: number;\n}\n\nexport interface OverlayAlertMarker {\n  readonly markerId: string;\n  readonly severity: \"info\" | \"warning\" | \"danger\";\n  readonly anchorId: string;\n}\n\nexport interface WorldSpaceCompositionSample {\n  readonly panelCount: number;\n  readonly focusPaneCount: number;\n  readonly alertMarkerCount: number;\n  readonly interactivePanelCount: number;\n}\n\nexport interface InterfaceContractAssessment {\n  readonly accepted: boolean;\n  readonly violations: readonly string[];\n}\n\nexport const PLAYER_SYSTEM_INTERFACE_PACKAGE = \"@plasius/player-system-interface\";\nexport const PLAYER_SYSTEM_INTERFACE_ENV_PREFIX = \"PLAYER_SYSTEM_INTERFACE\";\nexport const PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID =\n  \"isekai.player-system.interface.enabled\";\nexport const PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\n\nexport const packageDescriptor: PackageDescriptor = Object.freeze({\n  packageName: PLAYER_SYSTEM_INTERFACE_PACKAGE,\n  featureFlagId: PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,\n  envPrefix: PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,\n  summary:\n    \"World-space Player System overlays, focus panes, and target-surface contracts for Plasius game experiences.\",\n});\n\nexport const defaultPlayerSystemInterfaceContract: PlayerSystemInterfaceContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,\n    accessibility: Object.freeze({\n      keyboardPath: \"sequential\",\n      focusRestorationTarget: \"trigger\",\n      liveRegionMode: \"polite\",\n      requiresAccessibleName: true,\n    }),\n    frameBudget: Object.freeze({\n      targetFps: 60,\n      maxFrameMs: 16,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultPlayerSystemInterfacePortabilityContract: PlayerSystemInterfacePortabilityContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,\n    hostAdapters: Object.freeze({\n      supportedHosts: Object.freeze([\n        \"dom-overlay\",\n        \"native-overlay\",\n        \"headless-snapshot\",\n      ] satisfies OverlayHostKind[]),\n      requiredCapabilities: Object.freeze([\n        \"focus-restoration\",\n        \"live-region\",\n        \"anchor-registry\",\n      ] satisfies OverlayAdapterCapability[]),\n      forbiddenAssumptions: Object.freeze([\n        \"window-global\",\n        \"single-pane-layout\",\n        \"absolute-scene-coordinates\",\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      maxWorldPanels: 6,\n      maxFocusPanes: 3,\n      maxAlertMarkers: 8,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultReducedCombatOverlayPolicy: ReducedCombatOverlayPolicy =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    mode: \"combat-safe\",\n    retainedSurfaceKinds: Object.freeze([\n      \"alert-marker\",\n      \"target-popup\",\n      \"focus-pane\",\n    ] satisfies InterfaceShellSurfaceKind[]),\n    maxInteractiveSurfaces: 1,\n  });\n\nexport function isPlayerSystemInterfaceMode(\n  value: string\n): value is PlayerSystemInterfaceMode {\n  return value === \"ambient\" || value === \"focused\" || value === \"combat-safe\";\n}\n\nexport function createWorldSpacePanelDefinition(\n  input: WorldSpacePanelDefinition\n): WorldSpacePanelDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createPlayerSystemInterfaceContract(\n  input: PlayerSystemInterfaceContractInput = {}\n): PlayerSystemInterfaceContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ?? defaultPlayerSystemInterfaceContract.featureFlagId,\n    accessibility: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.accessibility,\n      ...input.accessibility,\n    }),\n    frameBudget: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.frameBudget,\n      ...input.frameBudget,\n    }),\n  });\n}\n\nexport function createPlayerSystemInterfacePortabilityContract(\n  input: PlayerSystemInterfacePortabilityContractInput = {}\n): PlayerSystemInterfacePortabilityContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ??\n      defaultPlayerSystemInterfacePortabilityContract.featureFlagId,\n    hostAdapters: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.hostAdapters,\n      ...input.hostAdapters,\n      supportedHosts: Object.freeze([\n        ...(input.hostAdapters?.supportedHosts ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .supportedHosts),\n      ]),\n      requiredCapabilities: Object.freeze([\n        ...(input.hostAdapters?.requiredCapabilities ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .requiredCapabilities),\n      ]),\n      forbiddenAssumptions: Object.freeze([\n        ...(input.hostAdapters?.forbiddenAssumptions ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .forbiddenAssumptions),\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.compositionScale,\n      ...input.compositionScale,\n    }),\n  });\n}\n\nexport function createInterfaceShellSurfaceDefinition(\n  input: InterfaceShellSurfaceDefinition\n): InterfaceShellSurfaceDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createFocusPaneShellDefinition(\n  input: FocusPaneShellDefinition\n): FocusPaneShellDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createLineOfSightTargetPopupDefinition(\n  input: LineOfSightTargetPopupDefinition\n): LineOfSightTargetPopupDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createInterfaceShellDefinition(\n  input: InterfaceShellDefinitionInput = {}\n): InterfaceShellDefinition {\n  return Object.freeze({\n    featureFlagId: input.featureFlagId ?? PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    surfaces: Object.freeze([...(input.surfaces ?? [])]),\n    focusPane: input.focusPane ? Object.freeze({ ...input.focusPane }) : undefined,\n    targetPopups: Object.freeze([...(input.targetPopups ?? [])]),\n    reducedCombat: Object.freeze({\n      ...defaultReducedCombatOverlayPolicy,\n      ...input.reducedCombat,\n      retainedSurfaceKinds: Object.freeze([\n        ...(input.reducedCombat?.retainedSurfaceKinds ??\n          defaultReducedCombatOverlayPolicy.retainedSurfaceKinds),\n      ]),\n    }),\n  });\n}\n\nexport function assessPlayerSystemInterfaceComposition(\n  sample: WorldSpaceCompositionSample,\n  contract: PlayerSystemInterfacePortabilityContract = defaultPlayerSystemInterfacePortabilityContract\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n\n  if (sample.panelCount > contract.compositionScale.maxWorldPanels) {\n    violations.push(\"panelCount\");\n  }\n\n  if (sample.focusPaneCount > contract.compositionScale.maxFocusPanes) {\n    violations.push(\"focusPaneCount\");\n  }\n\n  if (sample.alertMarkerCount > contract.compositionScale.maxAlertMarkers) {\n    violations.push(\"alertMarkerCount\");\n  }\n\n  if (\n    sample.interactivePanelCount >\n    contract.compositionScale.maxInteractivePanelsPerFrame\n  ) {\n    violations.push(\"interactivePanelCount\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n\nexport function assessInterfaceShellDefinition(\n  shell: InterfaceShellDefinition\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n  const ownerSet = new Set(shell.surfaces.map((surface) => surface.owner));\n  const retainedSurfaceKinds = new Set(shell.reducedCombat.retainedSurfaceKinds);\n  const interactiveSurfaceCount = shell.surfaces.filter(\n    (surface) => surface.interactive && retainedSurfaceKinds.has(surface.kind)\n  ).length;\n  const focusPane = shell.focusPane;\n\n  if (shell.surfaces.length === 0) {\n    violations.push(\"surfaces\");\n  }\n\n  if (focusPane && !ownerSet.has(focusPane.owner)) {\n    violations.push(\"focusPaneOwner\");\n  }\n\n  if (focusPane) {\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.kind === \"focus-pane\" &&\n        surface.anchorId === focusPane.anchorId &&\n        surface.owner === focusPane.owner\n    );\n    if (!matchingSurface) {\n      violations.push(\"focusPaneSurface\");\n    }\n  }\n\n  if (\n    interactiveSurfaceCount > shell.reducedCombat.maxInteractiveSurfaces\n  ) {\n    violations.push(\"interactiveSurfaceCount\");\n  }\n\n  for (const popup of shell.targetPopups) {\n    if (popup.requiresLineOfSight && popup.anchorId.length === 0) {\n      violations.push(`popup:${popup.popupId}`);\n    }\n  }\n\n  if (\n    ownerSet.has(\"player-system\") &&\n    ownerSet.has(\"party-system\") &&\n    shell.reducedCombat.retainedSurfaceKinds.length === 0\n  ) {\n    violations.push(\"reducedCombat\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface PackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nexport type OverlayKeyboardPath = \"sequential\" | \"direct-hotkey\" | \"read-only\";\n\nexport interface OverlayAccessibilityContract {\n  readonly keyboardPath: OverlayKeyboardPath;\n  readonly focusRestorationTarget: \"trigger\" | \"pane-heading\" | \"nearest-anchor\";\n  readonly liveRegionMode: \"polite\" | \"assertive\" | \"off\";\n  readonly requiresAccessibleName: boolean;\n}\n\nexport interface InterfaceFrameBudget {\n  readonly targetFps: number;\n  readonly maxFrameMs: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport type OverlayHostKind =\n  | \"dom-overlay\"\n  | \"native-overlay\"\n  | \"headless-snapshot\";\n\nexport type OverlayAdapterCapability =\n  | \"focus-restoration\"\n  | \"live-region\"\n  | \"anchor-registry\";\n\nexport interface OverlayHostAdapterContract {\n  readonly supportedHosts: readonly OverlayHostKind[];\n  readonly requiredCapabilities: readonly OverlayAdapterCapability[];\n  readonly forbiddenAssumptions: readonly string[];\n}\n\nexport interface OverlayCompositionScaleContract {\n  readonly maxWorldPanels: number;\n  readonly maxFocusPanes: number;\n  readonly maxAlertMarkers: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport interface PlayerSystemInterfaceContract {\n  readonly featureFlagId: string;\n  readonly accessibility: OverlayAccessibilityContract;\n  readonly frameBudget: InterfaceFrameBudget;\n}\n\nexport interface PlayerSystemInterfacePortabilityContract {\n  readonly featureFlagId: string;\n  readonly hostAdapters: OverlayHostAdapterContract;\n  readonly compositionScale: OverlayCompositionScaleContract;\n}\n\nexport interface PlayerSystemInterfaceContractInput {\n  readonly featureFlagId?: string;\n  readonly accessibility?: Partial<OverlayAccessibilityContract>;\n  readonly frameBudget?: Partial<InterfaceFrameBudget>;\n}\n\nexport interface PlayerSystemInterfacePortabilityContractInput {\n  readonly featureFlagId?: string;\n  readonly hostAdapters?: Partial<OverlayHostAdapterContract>;\n  readonly compositionScale?: Partial<OverlayCompositionScaleContract>;\n}\n\nexport type PlayerSystemInterfaceMode = \"ambient\" | \"focused\" | \"combat-safe\";\n\nexport type PlayerSystemPaneId =\n  | \"identity\"\n  | \"missions\"\n  | \"guild-quests\"\n  | \"logs\"\n  | \"mcc\"\n  | \"tutorial\"\n  | \"points-store\";\n\nexport type InterfaceShellOwner = \"player-system\" | \"party-system\";\nexport type InterfaceShellSurfaceKind =\n  | \"world-panel\"\n  | \"focus-pane\"\n  | \"target-popup\"\n  | \"alert-marker\"\n  | \"identity-overlay\";\nexport type InterfaceCombatBehavior = \"persist\" | \"reduce\" | \"suspend\";\n\nexport type IdentityProjectionRelation =\n  | \"self\"\n  | \"allied\"\n  | \"neutral\"\n  | \"unknown\"\n  | \"unfriendly\";\nexport type IdentityProjectionInvocation =\n  | \"self-state\"\n  | \"identity-sweep\"\n  | \"spell-targeting\";\nexport type IdentityProjectionReadConfidence =\n  | \"complete\"\n  | \"partial\"\n  | \"fuzzy\"\n  | \"withheld\";\nexport type IdentityProjectionPresentation = \"full\" | \"condensed\";\nexport type IdentityProjectionFact =\n  | \"display-name\"\n  | \"relation\"\n  | \"health-band\"\n  | \"status-summary\"\n  | \"threat-band\"\n  | \"targeting-affordance\";\n\nexport interface IdentityStatusOverlayBaseDefinition {\n  readonly overlayId: string;\n  readonly surfaceId: string;\n  readonly readConfidence: IdentityProjectionReadConfidence;\n  readonly perceivableFacts: readonly IdentityProjectionFact[];\n  readonly readableFacts: readonly IdentityProjectionFact[];\n  readonly presentation: IdentityProjectionPresentation;\n}\n\nexport interface IdentitySelfStateOverlayDefinition\n  extends IdentityStatusOverlayBaseDefinition {\n  readonly targetKind: \"self\";\n  readonly relation: \"self\";\n  readonly invocation: \"self-state\";\n  readonly requiresLineOfSight: false;\n  readonly targetId?: never;\n}\n\nexport interface IdentityTargetProjectionOverlayDefinition\n  extends IdentityStatusOverlayBaseDefinition {\n  readonly targetKind: \"external\";\n  readonly targetId: string;\n  readonly relation: Exclude<IdentityProjectionRelation, \"self\">;\n  readonly invocation: Exclude<IdentityProjectionInvocation, \"self-state\">;\n  readonly requiresLineOfSight: true;\n}\n\nexport type IdentityStatusOverlayDefinition =\n  | IdentitySelfStateOverlayDefinition\n  | IdentityTargetProjectionOverlayDefinition;\n\nexport interface InterfaceShellSurfaceDefinition {\n  readonly surfaceId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly kind: InterfaceShellSurfaceKind;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly priority: number;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface FocusPaneShellDefinition {\n  readonly panelId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly heading: string;\n  readonly interactive: boolean;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface LineOfSightTargetPopupDefinition {\n  readonly popupId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly anchorId: string;\n  readonly targetId: string;\n  readonly summary: string;\n  readonly requiresLineOfSight: boolean;\n  readonly actionLabel?: string;\n}\n\nexport interface ReducedCombatOverlayPolicy {\n  readonly featureFlagId: string;\n  readonly mode: \"combat-safe\";\n  readonly retainedSurfaceKinds: readonly InterfaceShellSurfaceKind[];\n  readonly maxInteractiveSurfaces: number;\n}\n\nexport interface InterfaceShellDefinition {\n  readonly featureFlagId: string;\n  readonly surfaces: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups: readonly LineOfSightTargetPopupDefinition[];\n  readonly identityOverlays: readonly IdentityStatusOverlayDefinition[];\n  readonly paneHosts: readonly ThreeDPaneHostDefinition[];\n  readonly ambientAlerts: readonly LocalizedAmbientAlertDefinition[];\n  readonly reducedCombat: ReducedCombatOverlayPolicy;\n}\n\nexport interface InterfaceShellDefinitionInput {\n  readonly featureFlagId?: string;\n  readonly surfaces?: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups?: readonly LineOfSightTargetPopupDefinition[];\n  readonly identityOverlays?: readonly IdentityStatusOverlayDefinition[];\n  readonly paneHosts?: readonly ThreeDPaneHostDefinition[];\n  readonly ambientAlerts?: readonly LocalizedAmbientAlertDefinition[];\n  readonly reducedCombat?: Partial<ReducedCombatOverlayPolicy>;\n}\n\nexport type InterfaceFocusShiftReason =\n  | \"keyboard\"\n  | \"direct-hotkey\"\n  | \"restore\"\n  | \"system\";\n\nexport interface InterfaceFocusShift {\n  readonly fromSurfaceId?: string;\n  readonly toSurfaceId: string;\n  readonly reason: InterfaceFocusShiftReason;\n}\n\nexport interface InterfaceShellStateDefinition {\n  readonly featureFlagId: string;\n  readonly mode: PlayerSystemInterfaceMode;\n  readonly focusedSurfaceId?: string;\n  readonly visibleSurfaceIds: readonly string[];\n  readonly focusShift?: InterfaceFocusShift;\n}\n\nexport interface InterfaceShellStateInput {\n  readonly mode: PlayerSystemInterfaceMode;\n  readonly focusedSurfaceId?: string;\n}\n\nexport interface ThreeDPaneHostDefinition {\n  readonly hostId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly pane: PlayerSystemPaneId;\n  readonly surfaceId: string;\n  readonly anchorId: string;\n  readonly supportedHosts: readonly OverlayHostKind[];\n}\n\nexport type AmbientAlertSeverity = \"info\" | \"warning\" | \"danger\";\n\nexport interface LocalizedAmbientAlertDefinition {\n  readonly alertId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly severity: AmbientAlertSeverity;\n  readonly anchorId: string;\n  readonly messageKey: string;\n  readonly localizedMessages: Readonly<Record<string, string>>;\n  readonly liveRegionMode: \"polite\" | \"assertive\";\n}\n\nexport interface WorldSpacePanelDefinition {\n  readonly panelId: string;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly accessibilityLabel?: string;\n  readonly focusOrder?: number;\n}\n\nexport interface OverlayAlertMarker {\n  readonly markerId: string;\n  readonly severity: AmbientAlertSeverity;\n  readonly anchorId: string;\n}\n\nexport interface WorldSpaceCompositionSample {\n  readonly panelCount: number;\n  readonly focusPaneCount: number;\n  readonly alertMarkerCount: number;\n  readonly interactivePanelCount: number;\n}\n\nexport interface InterfaceContractAssessment {\n  readonly accepted: boolean;\n  readonly violations: readonly string[];\n}\n\nexport const PLAYER_SYSTEM_INTERFACE_PACKAGE = \"@plasius/player-system-interface\";\nexport const PLAYER_SYSTEM_INTERFACE_ENV_PREFIX = \"PLAYER_SYSTEM_INTERFACE\";\nexport const PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID =\n  \"isekai.player-system.interface.enabled\";\nexport const PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID =\n  \"isekai.player-system.identity.enabled\";\n\nexport const packageDescriptor: PackageDescriptor = Object.freeze({\n  packageName: PLAYER_SYSTEM_INTERFACE_PACKAGE,\n  featureFlagId: PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,\n  envPrefix: PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,\n  summary:\n    \"World-space Player System overlays, focus panes, and target-surface contracts for Plasius game experiences.\",\n});\n\nexport const defaultPlayerSystemInterfaceContract: PlayerSystemInterfaceContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,\n    accessibility: Object.freeze({\n      keyboardPath: \"sequential\",\n      focusRestorationTarget: \"trigger\",\n      liveRegionMode: \"polite\",\n      requiresAccessibleName: true,\n    }),\n    frameBudget: Object.freeze({\n      targetFps: 60,\n      maxFrameMs: 16,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultPlayerSystemInterfacePortabilityContract: PlayerSystemInterfacePortabilityContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,\n    hostAdapters: Object.freeze({\n      supportedHosts: Object.freeze([\n        \"dom-overlay\",\n        \"native-overlay\",\n        \"headless-snapshot\",\n      ] satisfies OverlayHostKind[]),\n      requiredCapabilities: Object.freeze([\n        \"focus-restoration\",\n        \"live-region\",\n        \"anchor-registry\",\n      ] satisfies OverlayAdapterCapability[]),\n      forbiddenAssumptions: Object.freeze([\n        \"window-global\",\n        \"single-pane-layout\",\n        \"absolute-scene-coordinates\",\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      maxWorldPanels: 6,\n      maxFocusPanes: 3,\n      maxAlertMarkers: 8,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultReducedCombatOverlayPolicy: ReducedCombatOverlayPolicy =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    mode: \"combat-safe\",\n    retainedSurfaceKinds: Object.freeze([\n      \"alert-marker\",\n      \"target-popup\",\n      \"focus-pane\",\n      \"identity-overlay\",\n    ] satisfies InterfaceShellSurfaceKind[]),\n    maxInteractiveSurfaces: 1,\n  });\n\nexport function isPlayerSystemInterfaceMode(\n  value: string\n): value is PlayerSystemInterfaceMode {\n  return value === \"ambient\" || value === \"focused\" || value === \"combat-safe\";\n}\n\nexport function createWorldSpacePanelDefinition(\n  input: WorldSpacePanelDefinition\n): WorldSpacePanelDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createPlayerSystemInterfaceContract(\n  input: PlayerSystemInterfaceContractInput = {}\n): PlayerSystemInterfaceContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ?? defaultPlayerSystemInterfaceContract.featureFlagId,\n    accessibility: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.accessibility,\n      ...input.accessibility,\n    }),\n    frameBudget: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.frameBudget,\n      ...input.frameBudget,\n    }),\n  });\n}\n\nexport function createPlayerSystemInterfacePortabilityContract(\n  input: PlayerSystemInterfacePortabilityContractInput = {}\n): PlayerSystemInterfacePortabilityContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ??\n      defaultPlayerSystemInterfacePortabilityContract.featureFlagId,\n    hostAdapters: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.hostAdapters,\n      ...input.hostAdapters,\n      supportedHosts: Object.freeze([\n        ...(input.hostAdapters?.supportedHosts ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .supportedHosts),\n      ]),\n      requiredCapabilities: Object.freeze([\n        ...(input.hostAdapters?.requiredCapabilities ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .requiredCapabilities),\n      ]),\n      forbiddenAssumptions: Object.freeze([\n        ...(input.hostAdapters?.forbiddenAssumptions ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .forbiddenAssumptions),\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.compositionScale,\n      ...input.compositionScale,\n    }),\n  });\n}\n\nexport function createInterfaceShellSurfaceDefinition(\n  input: InterfaceShellSurfaceDefinition\n): InterfaceShellSurfaceDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createFocusPaneShellDefinition(\n  input: FocusPaneShellDefinition\n): FocusPaneShellDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createLineOfSightTargetPopupDefinition(\n  input: LineOfSightTargetPopupDefinition\n): LineOfSightTargetPopupDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createIdentityStatusOverlayDefinition(\n  input: IdentityStatusOverlayDefinition\n): IdentityStatusOverlayDefinition {\n  return Object.freeze({\n    ...input,\n    perceivableFacts: Object.freeze([...input.perceivableFacts]),\n    readableFacts: Object.freeze([...input.readableFacts]),\n  });\n}\n\nexport function createThreeDPaneHostDefinition(\n  input: ThreeDPaneHostDefinition\n): ThreeDPaneHostDefinition {\n  return Object.freeze({\n    ...input,\n    supportedHosts: Object.freeze([...input.supportedHosts]),\n  });\n}\n\nexport function createLocalizedAmbientAlertDefinition(\n  input: LocalizedAmbientAlertDefinition\n): LocalizedAmbientAlertDefinition {\n  return Object.freeze({\n    ...input,\n    localizedMessages: Object.freeze({ ...input.localizedMessages }),\n  });\n}\n\nexport function createInterfaceShellDefinition(\n  input: InterfaceShellDefinitionInput = {}\n): InterfaceShellDefinition {\n  return Object.freeze({\n    featureFlagId: input.featureFlagId ?? PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    surfaces: Object.freeze([...(input.surfaces ?? [])]),\n    focusPane: input.focusPane ? Object.freeze({ ...input.focusPane }) : undefined,\n    targetPopups: Object.freeze([...(input.targetPopups ?? [])]),\n    identityOverlays: Object.freeze([...(input.identityOverlays ?? [])]),\n    paneHosts: Object.freeze([...(input.paneHosts ?? [])]),\n    ambientAlerts: Object.freeze([...(input.ambientAlerts ?? [])]),\n    reducedCombat: Object.freeze({\n      ...defaultReducedCombatOverlayPolicy,\n      ...input.reducedCombat,\n      retainedSurfaceKinds: Object.freeze([\n        ...(input.reducedCombat?.retainedSurfaceKinds ??\n          defaultReducedCombatOverlayPolicy.retainedSurfaceKinds),\n      ]),\n    }),\n  });\n}\n\nexport function createInterfaceShellState(\n  shell: InterfaceShellDefinition,\n  input: InterfaceShellStateInput\n): InterfaceShellStateDefinition {\n  const retainedSurfaceKinds = new Set(\n    shell.reducedCombat.retainedSurfaceKinds\n  );\n  const visibleSurfaceIds = shell.surfaces\n    .filter(\n      (surface) =>\n        input.mode !== \"combat-safe\" ||\n        (surface.combatBehavior !== \"suspend\" &&\n          retainedSurfaceKinds.has(surface.kind))\n    )\n    .map((surface) => surface.surfaceId);\n\n  if (\n    input.focusedSurfaceId &&\n    !visibleSurfaceIds.includes(input.focusedSurfaceId)\n  ) {\n    throw new RangeError(\n      `Focused surface '${input.focusedSurfaceId}' is not visible in ${input.mode} mode`\n    );\n  }\n\n  return Object.freeze({\n    featureFlagId: shell.featureFlagId,\n    mode: input.mode,\n    focusedSurfaceId:\n      input.mode === \"focused\" ? input.focusedSurfaceId : undefined,\n    visibleSurfaceIds: Object.freeze(visibleSurfaceIds),\n  });\n}\n\nexport function applyInterfaceShellFocusShift(\n  state: InterfaceShellStateDefinition,\n  focusShift: InterfaceFocusShift\n): InterfaceShellStateDefinition {\n  if (!state.visibleSurfaceIds.includes(focusShift.toSurfaceId)) {\n    throw new RangeError(\n      `Focused surface '${focusShift.toSurfaceId}' is not visible in ${state.mode} mode`\n    );\n  }\n\n  return Object.freeze({\n    ...state,\n    mode: \"focused\",\n    focusedSurfaceId: focusShift.toSurfaceId,\n    focusShift: Object.freeze({ ...focusShift }),\n  });\n}\n\nexport function resolveLocalizedAmbientAlertMessage(\n  alert: LocalizedAmbientAlertDefinition,\n  locale: string,\n  fallbackLocale = \"en-GB\"\n): string | undefined {\n  return alert.localizedMessages[locale] ?? alert.localizedMessages[fallbackLocale];\n}\n\nexport function assessIdentityStatusOverlayDefinition(\n  overlay: IdentityStatusOverlayDefinition\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n  const perceivableFacts = new Set(overlay.perceivableFacts);\n\n  if (overlay.readableFacts.some((fact) => !perceivableFacts.has(fact))) {\n    violations.push(\"readableFacts\");\n  }\n\n  if (overlay.readConfidence === \"withheld\" && overlay.readableFacts.length > 0) {\n    violations.push(\"withheldRead\");\n  }\n\n  if (overlay.targetKind === \"self\") {\n    if (overlay.relation !== \"self\") {\n      violations.push(\"selfRelation\");\n    }\n    if (overlay.invocation !== \"self-state\") {\n      violations.push(\"selfInvocation\");\n    }\n    if (overlay.requiresLineOfSight) {\n      violations.push(\"selfLineOfSight\");\n    }\n  } else {\n    if (overlay.targetId.length === 0) {\n      violations.push(\"targetId\");\n    }\n    if (!overlay.requiresLineOfSight) {\n      violations.push(\"lineOfSight\");\n    }\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n\nexport function assessPlayerSystemInterfaceComposition(\n  sample: WorldSpaceCompositionSample,\n  contract: PlayerSystemInterfacePortabilityContract = defaultPlayerSystemInterfacePortabilityContract\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n\n  if (sample.panelCount > contract.compositionScale.maxWorldPanels) {\n    violations.push(\"panelCount\");\n  }\n\n  if (sample.focusPaneCount > contract.compositionScale.maxFocusPanes) {\n    violations.push(\"focusPaneCount\");\n  }\n\n  if (sample.alertMarkerCount > contract.compositionScale.maxAlertMarkers) {\n    violations.push(\"alertMarkerCount\");\n  }\n\n  if (\n    sample.interactivePanelCount >\n    contract.compositionScale.maxInteractivePanelsPerFrame\n  ) {\n    violations.push(\"interactivePanelCount\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n\nexport function assessInterfaceShellDefinition(\n  shell: InterfaceShellDefinition\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n  const ownerSet = new Set(shell.surfaces.map((surface) => surface.owner));\n  const retainedSurfaceKinds = new Set(shell.reducedCombat.retainedSurfaceKinds);\n  const interactiveSurfaceCount = shell.surfaces.filter(\n    (surface) => surface.interactive && retainedSurfaceKinds.has(surface.kind)\n  ).length;\n  const focusPane = shell.focusPane;\n\n  if (shell.surfaces.length === 0) {\n    violations.push(\"surfaces\");\n  }\n\n  if (focusPane && !ownerSet.has(focusPane.owner)) {\n    violations.push(\"focusPaneOwner\");\n  }\n\n  if (focusPane) {\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.kind === \"focus-pane\" &&\n        surface.anchorId === focusPane.anchorId &&\n        surface.owner === focusPane.owner\n    );\n    if (!matchingSurface) {\n      violations.push(\"focusPaneSurface\");\n    }\n  }\n\n  if (\n    interactiveSurfaceCount > shell.reducedCombat.maxInteractiveSurfaces\n  ) {\n    violations.push(\"interactiveSurfaceCount\");\n  }\n\n  for (const popup of shell.targetPopups) {\n    if (popup.requiresLineOfSight && popup.anchorId.length === 0) {\n      violations.push(`popup:${popup.popupId}`);\n    }\n  }\n\n  for (const overlay of shell.identityOverlays) {\n    const identityAssessment = assessIdentityStatusOverlayDefinition(overlay);\n    for (const violation of identityAssessment.violations) {\n      violations.push(`identityOverlay:${overlay.overlayId}:${violation}`);\n    }\n\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.surfaceId === overlay.surfaceId &&\n        surface.kind === \"identity-overlay\"\n    );\n    if (!matchingSurface) {\n      violations.push(`identityOverlaySurface:${overlay.overlayId}`);\n    }\n  }\n\n  for (const paneHost of shell.paneHosts) {\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.surfaceId === paneHost.surfaceId &&\n        surface.owner === paneHost.owner &&\n        surface.anchorId === paneHost.anchorId\n    );\n    if (!matchingSurface) {\n      violations.push(`paneHost:${paneHost.hostId}`);\n    }\n  }\n\n  for (const alert of shell.ambientAlerts) {\n    if (Object.keys(alert.localizedMessages).length === 0) {\n      violations.push(`alert:${alert.alertId}`);\n    }\n  }\n\n  if (\n    ownerSet.has(\"player-system\") &&\n    ownerSet.has(\"party-system\") &&\n    shell.reducedCombat.retainedSurfaceKinds.length === 0\n  ) {\n    violations.push(\"reducedCombat\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -52,8 +52,36 @@ interface PlayerSystemInterfacePortabilityContractInput {
 type PlayerSystemInterfaceMode = "ambient" | "focused" | "combat-safe";
 type PlayerSystemPaneId = "identity" | "missions" | "guild-quests" | "logs" | "mcc" | "tutorial" | "points-store";
 type InterfaceShellOwner = "player-system" | "party-system";
-type InterfaceShellSurfaceKind = "world-panel" | "focus-pane" | "target-popup" | "alert-marker";
+type InterfaceShellSurfaceKind = "world-panel" | "focus-pane" | "target-popup" | "alert-marker" | "identity-overlay";
 type InterfaceCombatBehavior = "persist" | "reduce" | "suspend";
+type IdentityProjectionRelation = "self" | "allied" | "neutral" | "unknown" | "unfriendly";
+type IdentityProjectionInvocation = "self-state" | "identity-sweep" | "spell-targeting";
+type IdentityProjectionReadConfidence = "complete" | "partial" | "fuzzy" | "withheld";
+type IdentityProjectionPresentation = "full" | "condensed";
+type IdentityProjectionFact = "display-name" | "relation" | "health-band" | "status-summary" | "threat-band" | "targeting-affordance";
+interface IdentityStatusOverlayBaseDefinition {
+    readonly overlayId: string;
+    readonly surfaceId: string;
+    readonly readConfidence: IdentityProjectionReadConfidence;
+    readonly perceivableFacts: readonly IdentityProjectionFact[];
+    readonly readableFacts: readonly IdentityProjectionFact[];
+    readonly presentation: IdentityProjectionPresentation;
+}
+interface IdentitySelfStateOverlayDefinition extends IdentityStatusOverlayBaseDefinition {
+    readonly targetKind: "self";
+    readonly relation: "self";
+    readonly invocation: "self-state";
+    readonly requiresLineOfSight: false;
+    readonly targetId?: never;
+}
+interface IdentityTargetProjectionOverlayDefinition extends IdentityStatusOverlayBaseDefinition {
+    readonly targetKind: "external";
+    readonly targetId: string;
+    readonly relation: Exclude<IdentityProjectionRelation, "self">;
+    readonly invocation: Exclude<IdentityProjectionInvocation, "self-state">;
+    readonly requiresLineOfSight: true;
+}
+type IdentityStatusOverlayDefinition = IdentitySelfStateOverlayDefinition | IdentityTargetProjectionOverlayDefinition;
 interface InterfaceShellSurfaceDefinition {
     readonly surfaceId: string;
     readonly owner: InterfaceShellOwner;
@@ -92,6 +120,9 @@ interface InterfaceShellDefinition {
     readonly surfaces: readonly InterfaceShellSurfaceDefinition[];
     readonly focusPane?: FocusPaneShellDefinition;
     readonly targetPopups: readonly LineOfSightTargetPopupDefinition[];
+    readonly identityOverlays: readonly IdentityStatusOverlayDefinition[];
+    readonly paneHosts: readonly ThreeDPaneHostDefinition[];
+    readonly ambientAlerts: readonly LocalizedAmbientAlertDefinition[];
     readonly reducedCombat: ReducedCombatOverlayPolicy;
 }
 interface InterfaceShellDefinitionInput {
@@ -99,8 +130,46 @@ interface InterfaceShellDefinitionInput {
     readonly surfaces?: readonly InterfaceShellSurfaceDefinition[];
     readonly focusPane?: FocusPaneShellDefinition;
     readonly targetPopups?: readonly LineOfSightTargetPopupDefinition[];
+    readonly identityOverlays?: readonly IdentityStatusOverlayDefinition[];
+    readonly paneHosts?: readonly ThreeDPaneHostDefinition[];
+    readonly ambientAlerts?: readonly LocalizedAmbientAlertDefinition[];
     readonly reducedCombat?: Partial<ReducedCombatOverlayPolicy>;
 }
+type InterfaceFocusShiftReason = "keyboard" | "direct-hotkey" | "restore" | "system";
+interface InterfaceFocusShift {
+    readonly fromSurfaceId?: string;
+    readonly toSurfaceId: string;
+    readonly reason: InterfaceFocusShiftReason;
+}
+interface InterfaceShellStateDefinition {
+    readonly featureFlagId: string;
+    readonly mode: PlayerSystemInterfaceMode;
+    readonly focusedSurfaceId?: string;
+    readonly visibleSurfaceIds: readonly string[];
+    readonly focusShift?: InterfaceFocusShift;
+}
+interface InterfaceShellStateInput {
+    readonly mode: PlayerSystemInterfaceMode;
+    readonly focusedSurfaceId?: string;
+}
+interface ThreeDPaneHostDefinition {
+    readonly hostId: string;
+    readonly owner: InterfaceShellOwner;
+    readonly pane: PlayerSystemPaneId;
+    readonly surfaceId: string;
+    readonly anchorId: string;
+    readonly supportedHosts: readonly OverlayHostKind[];
+}
+type AmbientAlertSeverity = "info" | "warning" | "danger";
+interface LocalizedAmbientAlertDefinition {
+    readonly alertId: string;
+    readonly owner: InterfaceShellOwner;
+    readonly severity: AmbientAlertSeverity;
+    readonly anchorId: string;
+    readonly messageKey: string;
+    readonly localizedMessages: Readonly<Record<string, string>>;
+    readonly liveRegionMode: "polite" | "assertive";
+}
 interface WorldSpacePanelDefinition {
     readonly panelId: string;
     readonly pane: PlayerSystemPaneId;
@@ -111,7 +180,7 @@ interface WorldSpacePanelDefinition {
 }
 interface OverlayAlertMarker {
     readonly markerId: string;
-    readonly severity: "info" | "warning" | "danger";
+    readonly severity: AmbientAlertSeverity;
     readonly anchorId: string;
 }
 interface WorldSpaceCompositionSample {
@@ -130,6 +199,7 @@ declare const PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID = "isekai.player-system.in
 declare const PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID = "isekai.player-system.interface.enabled";
 declare const PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID = "isekai.player-system.interface.enabled";
 declare const PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID = "isekai.player-system.interface.enabled";
+declare const PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID = "isekai.player-system.identity.enabled";
 declare const packageDescriptor: PackageDescriptor;
 declare const defaultPlayerSystemInterfaceContract: PlayerSystemInterfaceContract;
 declare const defaultPlayerSystemInterfacePortabilityContract: PlayerSystemInterfacePortabilityContract;
@@ -141,8 +211,15 @@ declare function createPlayerSystemInterfacePortabilityContract(input?: PlayerSy
 declare function createInterfaceShellSurfaceDefinition(input: InterfaceShellSurfaceDefinition): InterfaceShellSurfaceDefinition;
 declare function createFocusPaneShellDefinition(input: FocusPaneShellDefinition): FocusPaneShellDefinition;
 declare function createLineOfSightTargetPopupDefinition(input: LineOfSightTargetPopupDefinition): LineOfSightTargetPopupDefinition;
+declare function createIdentityStatusOverlayDefinition(input: IdentityStatusOverlayDefinition): IdentityStatusOverlayDefinition;
+declare function createThreeDPaneHostDefinition(input: ThreeDPaneHostDefinition): ThreeDPaneHostDefinition;
+declare function createLocalizedAmbientAlertDefinition(input: LocalizedAmbientAlertDefinition): LocalizedAmbientAlertDefinition;
 declare function createInterfaceShellDefinition(input?: InterfaceShellDefinitionInput): InterfaceShellDefinition;
+declare function createInterfaceShellState(shell: InterfaceShellDefinition, input: InterfaceShellStateInput): InterfaceShellStateDefinition;
+declare function applyInterfaceShellFocusShift(state: InterfaceShellStateDefinition, focusShift: InterfaceFocusShift): InterfaceShellStateDefinition;
+declare function resolveLocalizedAmbientAlertMessage(alert: LocalizedAmbientAlertDefinition, locale: string, fallbackLocale?: string): string | undefined;
+declare function assessIdentityStatusOverlayDefinition(overlay: IdentityStatusOverlayDefinition): InterfaceContractAssessment;
 declare function assessPlayerSystemInterfaceComposition(sample: WorldSpaceCompositionSample, contract?: PlayerSystemInterfacePortabilityContract): InterfaceContractAssessment;
 declare function assessInterfaceShellDefinition(shell: InterfaceShellDefinition): InterfaceContractAssessment;
 
-export { type FocusPaneShellDefinition, type InterfaceCombatBehavior, type InterfaceContractAssessment, type InterfaceFrameBudget, type InterfaceShellDefinition, type InterfaceShellDefinitionInput, type InterfaceShellOwner, type InterfaceShellSurfaceDefinition, type InterfaceShellSurfaceKind, type LineOfSightTargetPopupDefinition, type OverlayAccessibilityContract, type OverlayAdapterCapability, type OverlayAlertMarker, type OverlayCompositionScaleContract, type OverlayHostAdapterContract, type OverlayHostKind, type OverlayKeyboardPath, PLAYER_SYSTEM_INTERFACE_ENV_PREFIX, PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID, PLAYER_SYSTEM_INTERFACE_PACKAGE, PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID, type PackageDescriptor, type PlayerSystemInterfaceContract, type PlayerSystemInterfaceContractInput, type PlayerSystemInterfaceMode, type PlayerSystemInterfacePortabilityContract, type PlayerSystemInterfacePortabilityContractInput, type PlayerSystemPaneId, type ReducedCombatOverlayPolicy, type WorldSpaceCompositionSample, type WorldSpacePanelDefinition, assessInterfaceShellDefinition, assessPlayerSystemInterfaceComposition, createFocusPaneShellDefinition, createInterfaceShellDefinition, createInterfaceShellSurfaceDefinition, createLineOfSightTargetPopupDefinition, createPlayerSystemInterfaceContract, createPlayerSystemInterfacePortabilityContract, createWorldSpacePanelDefinition, defaultPlayerSystemInterfaceContract, defaultPlayerSystemInterfacePortabilityContract, defaultReducedCombatOverlayPolicy, isPlayerSystemInterfaceMode, packageDescriptor };
+export { type AmbientAlertSeverity, type FocusPaneShellDefinition, type IdentityProjectionFact, type IdentityProjectionInvocation, type IdentityProjectionPresentation, type IdentityProjectionReadConfidence, type IdentityProjectionRelation, type IdentitySelfStateOverlayDefinition, type IdentityStatusOverlayBaseDefinition, type IdentityStatusOverlayDefinition, type IdentityTargetProjectionOverlayDefinition, type InterfaceCombatBehavior, type InterfaceContractAssessment, type InterfaceFocusShift, type InterfaceFocusShiftReason, type InterfaceFrameBudget, type InterfaceShellDefinition, type InterfaceShellDefinitionInput, type InterfaceShellOwner, type InterfaceShellStateDefinition, type InterfaceShellStateInput, type InterfaceShellSurfaceDefinition, type InterfaceShellSurfaceKind, type LineOfSightTargetPopupDefinition, type LocalizedAmbientAlertDefinition, type OverlayAccessibilityContract, type OverlayAdapterCapability, type OverlayAlertMarker, type OverlayCompositionScaleContract, type OverlayHostAdapterContract, type OverlayHostKind, type OverlayKeyboardPath, PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID, PLAYER_SYSTEM_INTERFACE_ENV_PREFIX, PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID, PLAYER_SYSTEM_INTERFACE_PACKAGE, PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID, type PackageDescriptor, type PlayerSystemInterfaceContract, type PlayerSystemInterfaceContractInput, type PlayerSystemInterfaceMode, type PlayerSystemInterfacePortabilityContract, type PlayerSystemInterfacePortabilityContractInput, type PlayerSystemPaneId, type ReducedCombatOverlayPolicy, type ThreeDPaneHostDefinition, type WorldSpaceCompositionSample, type WorldSpacePanelDefinition, applyInterfaceShellFocusShift, assessIdentityStatusOverlayDefinition, assessInterfaceShellDefinition, assessPlayerSystemInterfaceComposition, createFocusPaneShellDefinition, createIdentityStatusOverlayDefinition, createInterfaceShellDefinition, createInterfaceShellState, createInterfaceShellSurfaceDefinition, createLineOfSightTargetPopupDefinition, createLocalizedAmbientAlertDefinition, createPlayerSystemInterfaceContract, createPlayerSystemInterfacePortabilityContract, createThreeDPaneHostDefinition, createWorldSpacePanelDefinition, defaultPlayerSystemInterfaceContract, defaultPlayerSystemInterfacePortabilityContract, defaultReducedCombatOverlayPolicy, isPlayerSystemInterfaceMode, packageDescriptor, resolveLocalizedAmbientAlertMessage };

package/dist/index.d.ts

@@ -52,8 +52,36 @@ interface PlayerSystemInterfacePortabilityContractInput {
 type PlayerSystemInterfaceMode = "ambient" | "focused" | "combat-safe";
 type PlayerSystemPaneId = "identity" | "missions" | "guild-quests" | "logs" | "mcc" | "tutorial" | "points-store";
 type InterfaceShellOwner = "player-system" | "party-system";
-type InterfaceShellSurfaceKind = "world-panel" | "focus-pane" | "target-popup" | "alert-marker";
+type InterfaceShellSurfaceKind = "world-panel" | "focus-pane" | "target-popup" | "alert-marker" | "identity-overlay";
 type InterfaceCombatBehavior = "persist" | "reduce" | "suspend";
+type IdentityProjectionRelation = "self" | "allied" | "neutral" | "unknown" | "unfriendly";
+type IdentityProjectionInvocation = "self-state" | "identity-sweep" | "spell-targeting";
+type IdentityProjectionReadConfidence = "complete" | "partial" | "fuzzy" | "withheld";
+type IdentityProjectionPresentation = "full" | "condensed";
+type IdentityProjectionFact = "display-name" | "relation" | "health-band" | "status-summary" | "threat-band" | "targeting-affordance";
+interface IdentityStatusOverlayBaseDefinition {
+    readonly overlayId: string;
+    readonly surfaceId: string;
+    readonly readConfidence: IdentityProjectionReadConfidence;
+    readonly perceivableFacts: readonly IdentityProjectionFact[];
+    readonly readableFacts: readonly IdentityProjectionFact[];
+    readonly presentation: IdentityProjectionPresentation;
+}
+interface IdentitySelfStateOverlayDefinition extends IdentityStatusOverlayBaseDefinition {
+    readonly targetKind: "self";
+    readonly relation: "self";
+    readonly invocation: "self-state";
+    readonly requiresLineOfSight: false;
+    readonly targetId?: never;
+}
+interface IdentityTargetProjectionOverlayDefinition extends IdentityStatusOverlayBaseDefinition {
+    readonly targetKind: "external";
+    readonly targetId: string;
+    readonly relation: Exclude<IdentityProjectionRelation, "self">;
+    readonly invocation: Exclude<IdentityProjectionInvocation, "self-state">;
+    readonly requiresLineOfSight: true;
+}
+type IdentityStatusOverlayDefinition = IdentitySelfStateOverlayDefinition | IdentityTargetProjectionOverlayDefinition;
 interface InterfaceShellSurfaceDefinition {
     readonly surfaceId: string;
     readonly owner: InterfaceShellOwner;
@@ -92,6 +120,9 @@ interface InterfaceShellDefinition {
     readonly surfaces: readonly InterfaceShellSurfaceDefinition[];
     readonly focusPane?: FocusPaneShellDefinition;
     readonly targetPopups: readonly LineOfSightTargetPopupDefinition[];
+    readonly identityOverlays: readonly IdentityStatusOverlayDefinition[];
+    readonly paneHosts: readonly ThreeDPaneHostDefinition[];
+    readonly ambientAlerts: readonly LocalizedAmbientAlertDefinition[];
     readonly reducedCombat: ReducedCombatOverlayPolicy;
 }
 interface InterfaceShellDefinitionInput {
@@ -99,8 +130,46 @@ interface InterfaceShellDefinitionInput {
     readonly surfaces?: readonly InterfaceShellSurfaceDefinition[];
     readonly focusPane?: FocusPaneShellDefinition;
     readonly targetPopups?: readonly LineOfSightTargetPopupDefinition[];
+    readonly identityOverlays?: readonly IdentityStatusOverlayDefinition[];
+    readonly paneHosts?: readonly ThreeDPaneHostDefinition[];
+    readonly ambientAlerts?: readonly LocalizedAmbientAlertDefinition[];
     readonly reducedCombat?: Partial<ReducedCombatOverlayPolicy>;
 }
+type InterfaceFocusShiftReason = "keyboard" | "direct-hotkey" | "restore" | "system";
+interface InterfaceFocusShift {
+    readonly fromSurfaceId?: string;
+    readonly toSurfaceId: string;
+    readonly reason: InterfaceFocusShiftReason;
+}
+interface InterfaceShellStateDefinition {
+    readonly featureFlagId: string;
+    readonly mode: PlayerSystemInterfaceMode;
+    readonly focusedSurfaceId?: string;
+    readonly visibleSurfaceIds: readonly string[];
+    readonly focusShift?: InterfaceFocusShift;
+}
+interface InterfaceShellStateInput {
+    readonly mode: PlayerSystemInterfaceMode;
+    readonly focusedSurfaceId?: string;
+}
+interface ThreeDPaneHostDefinition {
+    readonly hostId: string;
+    readonly owner: InterfaceShellOwner;
+    readonly pane: PlayerSystemPaneId;
+    readonly surfaceId: string;
+    readonly anchorId: string;
+    readonly supportedHosts: readonly OverlayHostKind[];
+}
+type AmbientAlertSeverity = "info" | "warning" | "danger";
+interface LocalizedAmbientAlertDefinition {
+    readonly alertId: string;
+    readonly owner: InterfaceShellOwner;
+    readonly severity: AmbientAlertSeverity;
+    readonly anchorId: string;
+    readonly messageKey: string;
+    readonly localizedMessages: Readonly<Record<string, string>>;
+    readonly liveRegionMode: "polite" | "assertive";
+}
 interface WorldSpacePanelDefinition {
     readonly panelId: string;
     readonly pane: PlayerSystemPaneId;
@@ -111,7 +180,7 @@ interface WorldSpacePanelDefinition {
 }
 interface OverlayAlertMarker {
     readonly markerId: string;
-    readonly severity: "info" | "warning" | "danger";
+    readonly severity: AmbientAlertSeverity;
     readonly anchorId: string;
 }
 interface WorldSpaceCompositionSample {
@@ -130,6 +199,7 @@ declare const PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID = "isekai.player-system.in
 declare const PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID = "isekai.player-system.interface.enabled";
 declare const PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID = "isekai.player-system.interface.enabled";
 declare const PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID = "isekai.player-system.interface.enabled";
+declare const PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID = "isekai.player-system.identity.enabled";
 declare const packageDescriptor: PackageDescriptor;
 declare const defaultPlayerSystemInterfaceContract: PlayerSystemInterfaceContract;
 declare const defaultPlayerSystemInterfacePortabilityContract: PlayerSystemInterfacePortabilityContract;
@@ -141,8 +211,15 @@ declare function createPlayerSystemInterfacePortabilityContract(input?: PlayerSy
 declare function createInterfaceShellSurfaceDefinition(input: InterfaceShellSurfaceDefinition): InterfaceShellSurfaceDefinition;
 declare function createFocusPaneShellDefinition(input: FocusPaneShellDefinition): FocusPaneShellDefinition;
 declare function createLineOfSightTargetPopupDefinition(input: LineOfSightTargetPopupDefinition): LineOfSightTargetPopupDefinition;
+declare function createIdentityStatusOverlayDefinition(input: IdentityStatusOverlayDefinition): IdentityStatusOverlayDefinition;
+declare function createThreeDPaneHostDefinition(input: ThreeDPaneHostDefinition): ThreeDPaneHostDefinition;
+declare function createLocalizedAmbientAlertDefinition(input: LocalizedAmbientAlertDefinition): LocalizedAmbientAlertDefinition;
 declare function createInterfaceShellDefinition(input?: InterfaceShellDefinitionInput): InterfaceShellDefinition;
+declare function createInterfaceShellState(shell: InterfaceShellDefinition, input: InterfaceShellStateInput): InterfaceShellStateDefinition;
+declare function applyInterfaceShellFocusShift(state: InterfaceShellStateDefinition, focusShift: InterfaceFocusShift): InterfaceShellStateDefinition;
+declare function resolveLocalizedAmbientAlertMessage(alert: LocalizedAmbientAlertDefinition, locale: string, fallbackLocale?: string): string | undefined;
+declare function assessIdentityStatusOverlayDefinition(overlay: IdentityStatusOverlayDefinition): InterfaceContractAssessment;
 declare function assessPlayerSystemInterfaceComposition(sample: WorldSpaceCompositionSample, contract?: PlayerSystemInterfacePortabilityContract): InterfaceContractAssessment;
 declare function assessInterfaceShellDefinition(shell: InterfaceShellDefinition): InterfaceContractAssessment;
 
-export { type FocusPaneShellDefinition, type InterfaceCombatBehavior, type InterfaceContractAssessment, type InterfaceFrameBudget, type InterfaceShellDefinition, type InterfaceShellDefinitionInput, type InterfaceShellOwner, type InterfaceShellSurfaceDefinition, type InterfaceShellSurfaceKind, type LineOfSightTargetPopupDefinition, type OverlayAccessibilityContract, type OverlayAdapterCapability, type OverlayAlertMarker, type OverlayCompositionScaleContract, type OverlayHostAdapterContract, type OverlayHostKind, type OverlayKeyboardPath, PLAYER_SYSTEM_INTERFACE_ENV_PREFIX, PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID, PLAYER_SYSTEM_INTERFACE_PACKAGE, PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID, type PackageDescriptor, type PlayerSystemInterfaceContract, type PlayerSystemInterfaceContractInput, type PlayerSystemInterfaceMode, type PlayerSystemInterfacePortabilityContract, type PlayerSystemInterfacePortabilityContractInput, type PlayerSystemPaneId, type ReducedCombatOverlayPolicy, type WorldSpaceCompositionSample, type WorldSpacePanelDefinition, assessInterfaceShellDefinition, assessPlayerSystemInterfaceComposition, createFocusPaneShellDefinition, createInterfaceShellDefinition, createInterfaceShellSurfaceDefinition, createLineOfSightTargetPopupDefinition, createPlayerSystemInterfaceContract, createPlayerSystemInterfacePortabilityContract, createWorldSpacePanelDefinition, defaultPlayerSystemInterfaceContract, defaultPlayerSystemInterfacePortabilityContract, defaultReducedCombatOverlayPolicy, isPlayerSystemInterfaceMode, packageDescriptor };
+export { type AmbientAlertSeverity, type FocusPaneShellDefinition, type IdentityProjectionFact, type IdentityProjectionInvocation, type IdentityProjectionPresentation, type IdentityProjectionReadConfidence, type IdentityProjectionRelation, type IdentitySelfStateOverlayDefinition, type IdentityStatusOverlayBaseDefinition, type IdentityStatusOverlayDefinition, type IdentityTargetProjectionOverlayDefinition, type InterfaceCombatBehavior, type InterfaceContractAssessment, type InterfaceFocusShift, type InterfaceFocusShiftReason, type InterfaceFrameBudget, type InterfaceShellDefinition, type InterfaceShellDefinitionInput, type InterfaceShellOwner, type InterfaceShellStateDefinition, type InterfaceShellStateInput, type InterfaceShellSurfaceDefinition, type InterfaceShellSurfaceKind, type LineOfSightTargetPopupDefinition, type LocalizedAmbientAlertDefinition, type OverlayAccessibilityContract, type OverlayAdapterCapability, type OverlayAlertMarker, type OverlayCompositionScaleContract, type OverlayHostAdapterContract, type OverlayHostKind, type OverlayKeyboardPath, PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID, PLAYER_SYSTEM_INTERFACE_ENV_PREFIX, PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID, PLAYER_SYSTEM_INTERFACE_PACKAGE, PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID, PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID, type PackageDescriptor, type PlayerSystemInterfaceContract, type PlayerSystemInterfaceContractInput, type PlayerSystemInterfaceMode, type PlayerSystemInterfacePortabilityContract, type PlayerSystemInterfacePortabilityContractInput, type PlayerSystemPaneId, type ReducedCombatOverlayPolicy, type ThreeDPaneHostDefinition, type WorldSpaceCompositionSample, type WorldSpacePanelDefinition, applyInterfaceShellFocusShift, assessIdentityStatusOverlayDefinition, assessInterfaceShellDefinition, assessPlayerSystemInterfaceComposition, createFocusPaneShellDefinition, createIdentityStatusOverlayDefinition, createInterfaceShellDefinition, createInterfaceShellState, createInterfaceShellSurfaceDefinition, createLineOfSightTargetPopupDefinition, createLocalizedAmbientAlertDefinition, createPlayerSystemInterfaceContract, createPlayerSystemInterfacePortabilityContract, createThreeDPaneHostDefinition, createWorldSpacePanelDefinition, defaultPlayerSystemInterfaceContract, defaultPlayerSystemInterfacePortabilityContract, defaultReducedCombatOverlayPolicy, isPlayerSystemInterfaceMode, packageDescriptor, resolveLocalizedAmbientAlertMessage };

package/dist/index.js

@@ -5,6 +5,7 @@ var PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID = "isekai.player-system.interface.en
 var PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID = PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;
 var PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID = PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;
 var PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID = PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;
+var PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID = "isekai.player-system.identity.enabled";
 var packageDescriptor = Object.freeze({
   packageName: PLAYER_SYSTEM_INTERFACE_PACKAGE,
   featureFlagId: PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,
@@ -57,7 +58,8 @@ var defaultReducedCombatOverlayPolicy = Object.freeze({
   retainedSurfaceKinds: Object.freeze([
     "alert-marker",
     "target-popup",
-    "focus-pane"
+    "focus-pane",
+    "identity-overlay"
   ]),
   maxInteractiveSurfaces: 1
 });
@@ -111,12 +113,34 @@ function createFocusPaneShellDefinition(input) {
 function createLineOfSightTargetPopupDefinition(input) {
   return Object.freeze({ ...input });
 }
+function createIdentityStatusOverlayDefinition(input) {
+  return Object.freeze({
+    ...input,
+    perceivableFacts: Object.freeze([...input.perceivableFacts]),
+    readableFacts: Object.freeze([...input.readableFacts])
+  });
+}
+function createThreeDPaneHostDefinition(input) {
+  return Object.freeze({
+    ...input,
+    supportedHosts: Object.freeze([...input.supportedHosts])
+  });
+}
+function createLocalizedAmbientAlertDefinition(input) {
+  return Object.freeze({
+    ...input,
+    localizedMessages: Object.freeze({ ...input.localizedMessages })
+  });
+}
 function createInterfaceShellDefinition(input = {}) {
   return Object.freeze({
     featureFlagId: input.featureFlagId ?? PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,
     surfaces: Object.freeze([...input.surfaces ?? []]),
     focusPane: input.focusPane ? Object.freeze({ ...input.focusPane }) : void 0,
     targetPopups: Object.freeze([...input.targetPopups ?? []]),
+    identityOverlays: Object.freeze([...input.identityOverlays ?? []]),
+    paneHosts: Object.freeze([...input.paneHosts ?? []]),
+    ambientAlerts: Object.freeze([...input.ambientAlerts ?? []]),
     reducedCombat: Object.freeze({
       ...defaultReducedCombatOverlayPolicy,
       ...input.reducedCombat,
@@ -126,6 +150,73 @@ function createInterfaceShellDefinition(input = {}) {
     })
   });
 }
+function createInterfaceShellState(shell, input) {
+  const retainedSurfaceKinds = new Set(
+    shell.reducedCombat.retainedSurfaceKinds
+  );
+  const visibleSurfaceIds = shell.surfaces.filter(
+    (surface) => input.mode !== "combat-safe" || surface.combatBehavior !== "suspend" && retainedSurfaceKinds.has(surface.kind)
+  ).map((surface) => surface.surfaceId);
+  if (input.focusedSurfaceId && !visibleSurfaceIds.includes(input.focusedSurfaceId)) {
+    throw new RangeError(
+      `Focused surface '${input.focusedSurfaceId}' is not visible in ${input.mode} mode`
+    );
+  }
+  return Object.freeze({
+    featureFlagId: shell.featureFlagId,
+    mode: input.mode,
+    focusedSurfaceId: input.mode === "focused" ? input.focusedSurfaceId : void 0,
+    visibleSurfaceIds: Object.freeze(visibleSurfaceIds)
+  });
+}
+function applyInterfaceShellFocusShift(state, focusShift) {
+  if (!state.visibleSurfaceIds.includes(focusShift.toSurfaceId)) {
+    throw new RangeError(
+      `Focused surface '${focusShift.toSurfaceId}' is not visible in ${state.mode} mode`
+    );
+  }
+  return Object.freeze({
+    ...state,
+    mode: "focused",
+    focusedSurfaceId: focusShift.toSurfaceId,
+    focusShift: Object.freeze({ ...focusShift })
+  });
+}
+function resolveLocalizedAmbientAlertMessage(alert, locale, fallbackLocale = "en-GB") {
+  return alert.localizedMessages[locale] ?? alert.localizedMessages[fallbackLocale];
+}
+function assessIdentityStatusOverlayDefinition(overlay) {
+  const violations = [];
+  const perceivableFacts = new Set(overlay.perceivableFacts);
+  if (overlay.readableFacts.some((fact) => !perceivableFacts.has(fact))) {
+    violations.push("readableFacts");
+  }
+  if (overlay.readConfidence === "withheld" && overlay.readableFacts.length > 0) {
+    violations.push("withheldRead");
+  }
+  if (overlay.targetKind === "self") {
+    if (overlay.relation !== "self") {
+      violations.push("selfRelation");
+    }
+    if (overlay.invocation !== "self-state") {
+      violations.push("selfInvocation");
+    }
+    if (overlay.requiresLineOfSight) {
+      violations.push("selfLineOfSight");
+    }
+  } else {
+    if (overlay.targetId.length === 0) {
+      violations.push("targetId");
+    }
+    if (!overlay.requiresLineOfSight) {
+      violations.push("lineOfSight");
+    }
+  }
+  return Object.freeze({
+    accepted: violations.length === 0,
+    violations: Object.freeze(violations)
+  });
+}
 function assessPlayerSystemInterfaceComposition(sample, contract = defaultPlayerSystemInterfacePortabilityContract) {
   const violations = [];
   if (sample.panelCount > contract.compositionScale.maxWorldPanels) {
@@ -175,6 +266,31 @@ function assessInterfaceShellDefinition(shell) {
       violations.push(`popup:${popup.popupId}`);
     }
   }
+  for (const overlay of shell.identityOverlays) {
+    const identityAssessment = assessIdentityStatusOverlayDefinition(overlay);
+    for (const violation of identityAssessment.violations) {
+      violations.push(`identityOverlay:${overlay.overlayId}:${violation}`);
+    }
+    const matchingSurface = shell.surfaces.find(
+      (surface) => surface.surfaceId === overlay.surfaceId && surface.kind === "identity-overlay"
+    );
+    if (!matchingSurface) {
+      violations.push(`identityOverlaySurface:${overlay.overlayId}`);
+    }
+  }
+  for (const paneHost of shell.paneHosts) {
+    const matchingSurface = shell.surfaces.find(
+      (surface) => surface.surfaceId === paneHost.surfaceId && surface.owner === paneHost.owner && surface.anchorId === paneHost.anchorId
+    );
+    if (!matchingSurface) {
+      violations.push(`paneHost:${paneHost.hostId}`);
+    }
+  }
+  for (const alert of shell.ambientAlerts) {
+    if (Object.keys(alert.localizedMessages).length === 0) {
+      violations.push(`alert:${alert.alertId}`);
+    }
+  }
   if (ownerSet.has("player-system") && ownerSet.has("party-system") && shell.reducedCombat.retainedSurfaceKinds.length === 0) {
     violations.push("reducedCombat");
   }
@@ -184,25 +300,33 @@ function assessInterfaceShellDefinition(shell) {
   });
 }
 export {
+  PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,
   PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_INTERFACE_PACKAGE,
   PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,
   PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,
+  applyInterfaceShellFocusShift,
+  assessIdentityStatusOverlayDefinition,
   assessInterfaceShellDefinition,
   assessPlayerSystemInterfaceComposition,
   createFocusPaneShellDefinition,
+  createIdentityStatusOverlayDefinition,
   createInterfaceShellDefinition,
+  createInterfaceShellState,
   createInterfaceShellSurfaceDefinition,
   createLineOfSightTargetPopupDefinition,
+  createLocalizedAmbientAlertDefinition,
   createPlayerSystemInterfaceContract,
   createPlayerSystemInterfacePortabilityContract,
+  createThreeDPaneHostDefinition,
   createWorldSpacePanelDefinition,
   defaultPlayerSystemInterfaceContract,
   defaultPlayerSystemInterfacePortabilityContract,
   defaultReducedCombatOverlayPolicy,
   isPlayerSystemInterfaceMode,
-  packageDescriptor
+  packageDescriptor,
+  resolveLocalizedAmbientAlertMessage
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface PackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nexport type OverlayKeyboardPath = \"sequential\" | \"direct-hotkey\" | \"read-only\";\n\nexport interface OverlayAccessibilityContract {\n  readonly keyboardPath: OverlayKeyboardPath;\n  readonly focusRestorationTarget: \"trigger\" | \"pane-heading\" | \"nearest-anchor\";\n  readonly liveRegionMode: \"polite\" | \"assertive\" | \"off\";\n  readonly requiresAccessibleName: boolean;\n}\n\nexport interface InterfaceFrameBudget {\n  readonly targetFps: number;\n  readonly maxFrameMs: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport type OverlayHostKind =\n  | \"dom-overlay\"\n  | \"native-overlay\"\n  | \"headless-snapshot\";\n\nexport type OverlayAdapterCapability =\n  | \"focus-restoration\"\n  | \"live-region\"\n  | \"anchor-registry\";\n\nexport interface OverlayHostAdapterContract {\n  readonly supportedHosts: readonly OverlayHostKind[];\n  readonly requiredCapabilities: readonly OverlayAdapterCapability[];\n  readonly forbiddenAssumptions: readonly string[];\n}\n\nexport interface OverlayCompositionScaleContract {\n  readonly maxWorldPanels: number;\n  readonly maxFocusPanes: number;\n  readonly maxAlertMarkers: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport interface PlayerSystemInterfaceContract {\n  readonly featureFlagId: string;\n  readonly accessibility: OverlayAccessibilityContract;\n  readonly frameBudget: InterfaceFrameBudget;\n}\n\nexport interface PlayerSystemInterfacePortabilityContract {\n  readonly featureFlagId: string;\n  readonly hostAdapters: OverlayHostAdapterContract;\n  readonly compositionScale: OverlayCompositionScaleContract;\n}\n\nexport interface PlayerSystemInterfaceContractInput {\n  readonly featureFlagId?: string;\n  readonly accessibility?: Partial<OverlayAccessibilityContract>;\n  readonly frameBudget?: Partial<InterfaceFrameBudget>;\n}\n\nexport interface PlayerSystemInterfacePortabilityContractInput {\n  readonly featureFlagId?: string;\n  readonly hostAdapters?: Partial<OverlayHostAdapterContract>;\n  readonly compositionScale?: Partial<OverlayCompositionScaleContract>;\n}\n\nexport type PlayerSystemInterfaceMode = \"ambient\" | \"focused\" | \"combat-safe\";\n\nexport type PlayerSystemPaneId =\n  | \"identity\"\n  | \"missions\"\n  | \"guild-quests\"\n  | \"logs\"\n  | \"mcc\"\n  | \"tutorial\"\n  | \"points-store\";\n\nexport type InterfaceShellOwner = \"player-system\" | \"party-system\";\nexport type InterfaceShellSurfaceKind =\n  | \"world-panel\"\n  | \"focus-pane\"\n  | \"target-popup\"\n  | \"alert-marker\";\nexport type InterfaceCombatBehavior = \"persist\" | \"reduce\" | \"suspend\";\n\nexport interface InterfaceShellSurfaceDefinition {\n  readonly surfaceId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly kind: InterfaceShellSurfaceKind;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly priority: number;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface FocusPaneShellDefinition {\n  readonly panelId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly heading: string;\n  readonly interactive: boolean;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface LineOfSightTargetPopupDefinition {\n  readonly popupId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly anchorId: string;\n  readonly targetId: string;\n  readonly summary: string;\n  readonly requiresLineOfSight: boolean;\n  readonly actionLabel?: string;\n}\n\nexport interface ReducedCombatOverlayPolicy {\n  readonly featureFlagId: string;\n  readonly mode: \"combat-safe\";\n  readonly retainedSurfaceKinds: readonly InterfaceShellSurfaceKind[];\n  readonly maxInteractiveSurfaces: number;\n}\n\nexport interface InterfaceShellDefinition {\n  readonly featureFlagId: string;\n  readonly surfaces: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups: readonly LineOfSightTargetPopupDefinition[];\n  readonly reducedCombat: ReducedCombatOverlayPolicy;\n}\n\nexport interface InterfaceShellDefinitionInput {\n  readonly featureFlagId?: string;\n  readonly surfaces?: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups?: readonly LineOfSightTargetPopupDefinition[];\n  readonly reducedCombat?: Partial<ReducedCombatOverlayPolicy>;\n}\n\nexport interface WorldSpacePanelDefinition {\n  readonly panelId: string;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly accessibilityLabel?: string;\n  readonly focusOrder?: number;\n}\n\nexport interface OverlayAlertMarker {\n  readonly markerId: string;\n  readonly severity: \"info\" | \"warning\" | \"danger\";\n  readonly anchorId: string;\n}\n\nexport interface WorldSpaceCompositionSample {\n  readonly panelCount: number;\n  readonly focusPaneCount: number;\n  readonly alertMarkerCount: number;\n  readonly interactivePanelCount: number;\n}\n\nexport interface InterfaceContractAssessment {\n  readonly accepted: boolean;\n  readonly violations: readonly string[];\n}\n\nexport const PLAYER_SYSTEM_INTERFACE_PACKAGE = \"@plasius/player-system-interface\";\nexport const PLAYER_SYSTEM_INTERFACE_ENV_PREFIX = \"PLAYER_SYSTEM_INTERFACE\";\nexport const PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID =\n  \"isekai.player-system.interface.enabled\";\nexport const PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\n\nexport const packageDescriptor: PackageDescriptor = Object.freeze({\n  packageName: PLAYER_SYSTEM_INTERFACE_PACKAGE,\n  featureFlagId: PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,\n  envPrefix: PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,\n  summary:\n    \"World-space Player System overlays, focus panes, and target-surface contracts for Plasius game experiences.\",\n});\n\nexport const defaultPlayerSystemInterfaceContract: PlayerSystemInterfaceContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,\n    accessibility: Object.freeze({\n      keyboardPath: \"sequential\",\n      focusRestorationTarget: \"trigger\",\n      liveRegionMode: \"polite\",\n      requiresAccessibleName: true,\n    }),\n    frameBudget: Object.freeze({\n      targetFps: 60,\n      maxFrameMs: 16,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultPlayerSystemInterfacePortabilityContract: PlayerSystemInterfacePortabilityContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,\n    hostAdapters: Object.freeze({\n      supportedHosts: Object.freeze([\n        \"dom-overlay\",\n        \"native-overlay\",\n        \"headless-snapshot\",\n      ] satisfies OverlayHostKind[]),\n      requiredCapabilities: Object.freeze([\n        \"focus-restoration\",\n        \"live-region\",\n        \"anchor-registry\",\n      ] satisfies OverlayAdapterCapability[]),\n      forbiddenAssumptions: Object.freeze([\n        \"window-global\",\n        \"single-pane-layout\",\n        \"absolute-scene-coordinates\",\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      maxWorldPanels: 6,\n      maxFocusPanes: 3,\n      maxAlertMarkers: 8,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultReducedCombatOverlayPolicy: ReducedCombatOverlayPolicy =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    mode: \"combat-safe\",\n    retainedSurfaceKinds: Object.freeze([\n      \"alert-marker\",\n      \"target-popup\",\n      \"focus-pane\",\n    ] satisfies InterfaceShellSurfaceKind[]),\n    maxInteractiveSurfaces: 1,\n  });\n\nexport function isPlayerSystemInterfaceMode(\n  value: string\n): value is PlayerSystemInterfaceMode {\n  return value === \"ambient\" || value === \"focused\" || value === \"combat-safe\";\n}\n\nexport function createWorldSpacePanelDefinition(\n  input: WorldSpacePanelDefinition\n): WorldSpacePanelDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createPlayerSystemInterfaceContract(\n  input: PlayerSystemInterfaceContractInput = {}\n): PlayerSystemInterfaceContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ?? defaultPlayerSystemInterfaceContract.featureFlagId,\n    accessibility: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.accessibility,\n      ...input.accessibility,\n    }),\n    frameBudget: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.frameBudget,\n      ...input.frameBudget,\n    }),\n  });\n}\n\nexport function createPlayerSystemInterfacePortabilityContract(\n  input: PlayerSystemInterfacePortabilityContractInput = {}\n): PlayerSystemInterfacePortabilityContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ??\n      defaultPlayerSystemInterfacePortabilityContract.featureFlagId,\n    hostAdapters: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.hostAdapters,\n      ...input.hostAdapters,\n      supportedHosts: Object.freeze([\n        ...(input.hostAdapters?.supportedHosts ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .supportedHosts),\n      ]),\n      requiredCapabilities: Object.freeze([\n        ...(input.hostAdapters?.requiredCapabilities ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .requiredCapabilities),\n      ]),\n      forbiddenAssumptions: Object.freeze([\n        ...(input.hostAdapters?.forbiddenAssumptions ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .forbiddenAssumptions),\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.compositionScale,\n      ...input.compositionScale,\n    }),\n  });\n}\n\nexport function createInterfaceShellSurfaceDefinition(\n  input: InterfaceShellSurfaceDefinition\n): InterfaceShellSurfaceDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createFocusPaneShellDefinition(\n  input: FocusPaneShellDefinition\n): FocusPaneShellDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createLineOfSightTargetPopupDefinition(\n  input: LineOfSightTargetPopupDefinition\n): LineOfSightTargetPopupDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createInterfaceShellDefinition(\n  input: InterfaceShellDefinitionInput = {}\n): InterfaceShellDefinition {\n  return Object.freeze({\n    featureFlagId: input.featureFlagId ?? PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    surfaces: Object.freeze([...(input.surfaces ?? [])]),\n    focusPane: input.focusPane ? Object.freeze({ ...input.focusPane }) : undefined,\n    targetPopups: Object.freeze([...(input.targetPopups ?? [])]),\n    reducedCombat: Object.freeze({\n      ...defaultReducedCombatOverlayPolicy,\n      ...input.reducedCombat,\n      retainedSurfaceKinds: Object.freeze([\n        ...(input.reducedCombat?.retainedSurfaceKinds ??\n          defaultReducedCombatOverlayPolicy.retainedSurfaceKinds),\n      ]),\n    }),\n  });\n}\n\nexport function assessPlayerSystemInterfaceComposition(\n  sample: WorldSpaceCompositionSample,\n  contract: PlayerSystemInterfacePortabilityContract = defaultPlayerSystemInterfacePortabilityContract\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n\n  if (sample.panelCount > contract.compositionScale.maxWorldPanels) {\n    violations.push(\"panelCount\");\n  }\n\n  if (sample.focusPaneCount > contract.compositionScale.maxFocusPanes) {\n    violations.push(\"focusPaneCount\");\n  }\n\n  if (sample.alertMarkerCount > contract.compositionScale.maxAlertMarkers) {\n    violations.push(\"alertMarkerCount\");\n  }\n\n  if (\n    sample.interactivePanelCount >\n    contract.compositionScale.maxInteractivePanelsPerFrame\n  ) {\n    violations.push(\"interactivePanelCount\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n\nexport function assessInterfaceShellDefinition(\n  shell: InterfaceShellDefinition\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n  const ownerSet = new Set(shell.surfaces.map((surface) => surface.owner));\n  const retainedSurfaceKinds = new Set(shell.reducedCombat.retainedSurfaceKinds);\n  const interactiveSurfaceCount = shell.surfaces.filter(\n    (surface) => surface.interactive && retainedSurfaceKinds.has(surface.kind)\n  ).length;\n  const focusPane = shell.focusPane;\n\n  if (shell.surfaces.length === 0) {\n    violations.push(\"surfaces\");\n  }\n\n  if (focusPane && !ownerSet.has(focusPane.owner)) {\n    violations.push(\"focusPaneOwner\");\n  }\n\n  if (focusPane) {\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.kind === \"focus-pane\" &&\n        surface.anchorId === focusPane.anchorId &&\n        surface.owner === focusPane.owner\n    );\n    if (!matchingSurface) {\n      violations.push(\"focusPaneSurface\");\n    }\n  }\n\n  if (\n    interactiveSurfaceCount > shell.reducedCombat.maxInteractiveSurfaces\n  ) {\n    violations.push(\"interactiveSurfaceCount\");\n  }\n\n  for (const popup of shell.targetPopups) {\n    if (popup.requiresLineOfSight && popup.anchorId.length === 0) {\n      violations.push(`popup:${popup.popupId}`);\n    }\n  }\n\n  if (\n    ownerSet.has(\"player-system\") &&\n    ownerSet.has(\"party-system\") &&\n    shell.reducedCombat.retainedSurfaceKinds.length === 0\n  ) {\n    violations.push(\"reducedCombat\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export interface PackageDescriptor {\n  readonly packageName: string;\n  readonly featureFlagId: string;\n  readonly envPrefix: string;\n  readonly summary: string;\n}\n\nexport type OverlayKeyboardPath = \"sequential\" | \"direct-hotkey\" | \"read-only\";\n\nexport interface OverlayAccessibilityContract {\n  readonly keyboardPath: OverlayKeyboardPath;\n  readonly focusRestorationTarget: \"trigger\" | \"pane-heading\" | \"nearest-anchor\";\n  readonly liveRegionMode: \"polite\" | \"assertive\" | \"off\";\n  readonly requiresAccessibleName: boolean;\n}\n\nexport interface InterfaceFrameBudget {\n  readonly targetFps: number;\n  readonly maxFrameMs: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport type OverlayHostKind =\n  | \"dom-overlay\"\n  | \"native-overlay\"\n  | \"headless-snapshot\";\n\nexport type OverlayAdapterCapability =\n  | \"focus-restoration\"\n  | \"live-region\"\n  | \"anchor-registry\";\n\nexport interface OverlayHostAdapterContract {\n  readonly supportedHosts: readonly OverlayHostKind[];\n  readonly requiredCapabilities: readonly OverlayAdapterCapability[];\n  readonly forbiddenAssumptions: readonly string[];\n}\n\nexport interface OverlayCompositionScaleContract {\n  readonly maxWorldPanels: number;\n  readonly maxFocusPanes: number;\n  readonly maxAlertMarkers: number;\n  readonly maxInteractivePanelsPerFrame: number;\n}\n\nexport interface PlayerSystemInterfaceContract {\n  readonly featureFlagId: string;\n  readonly accessibility: OverlayAccessibilityContract;\n  readonly frameBudget: InterfaceFrameBudget;\n}\n\nexport interface PlayerSystemInterfacePortabilityContract {\n  readonly featureFlagId: string;\n  readonly hostAdapters: OverlayHostAdapterContract;\n  readonly compositionScale: OverlayCompositionScaleContract;\n}\n\nexport interface PlayerSystemInterfaceContractInput {\n  readonly featureFlagId?: string;\n  readonly accessibility?: Partial<OverlayAccessibilityContract>;\n  readonly frameBudget?: Partial<InterfaceFrameBudget>;\n}\n\nexport interface PlayerSystemInterfacePortabilityContractInput {\n  readonly featureFlagId?: string;\n  readonly hostAdapters?: Partial<OverlayHostAdapterContract>;\n  readonly compositionScale?: Partial<OverlayCompositionScaleContract>;\n}\n\nexport type PlayerSystemInterfaceMode = \"ambient\" | \"focused\" | \"combat-safe\";\n\nexport type PlayerSystemPaneId =\n  | \"identity\"\n  | \"missions\"\n  | \"guild-quests\"\n  | \"logs\"\n  | \"mcc\"\n  | \"tutorial\"\n  | \"points-store\";\n\nexport type InterfaceShellOwner = \"player-system\" | \"party-system\";\nexport type InterfaceShellSurfaceKind =\n  | \"world-panel\"\n  | \"focus-pane\"\n  | \"target-popup\"\n  | \"alert-marker\"\n  | \"identity-overlay\";\nexport type InterfaceCombatBehavior = \"persist\" | \"reduce\" | \"suspend\";\n\nexport type IdentityProjectionRelation =\n  | \"self\"\n  | \"allied\"\n  | \"neutral\"\n  | \"unknown\"\n  | \"unfriendly\";\nexport type IdentityProjectionInvocation =\n  | \"self-state\"\n  | \"identity-sweep\"\n  | \"spell-targeting\";\nexport type IdentityProjectionReadConfidence =\n  | \"complete\"\n  | \"partial\"\n  | \"fuzzy\"\n  | \"withheld\";\nexport type IdentityProjectionPresentation = \"full\" | \"condensed\";\nexport type IdentityProjectionFact =\n  | \"display-name\"\n  | \"relation\"\n  | \"health-band\"\n  | \"status-summary\"\n  | \"threat-band\"\n  | \"targeting-affordance\";\n\nexport interface IdentityStatusOverlayBaseDefinition {\n  readonly overlayId: string;\n  readonly surfaceId: string;\n  readonly readConfidence: IdentityProjectionReadConfidence;\n  readonly perceivableFacts: readonly IdentityProjectionFact[];\n  readonly readableFacts: readonly IdentityProjectionFact[];\n  readonly presentation: IdentityProjectionPresentation;\n}\n\nexport interface IdentitySelfStateOverlayDefinition\n  extends IdentityStatusOverlayBaseDefinition {\n  readonly targetKind: \"self\";\n  readonly relation: \"self\";\n  readonly invocation: \"self-state\";\n  readonly requiresLineOfSight: false;\n  readonly targetId?: never;\n}\n\nexport interface IdentityTargetProjectionOverlayDefinition\n  extends IdentityStatusOverlayBaseDefinition {\n  readonly targetKind: \"external\";\n  readonly targetId: string;\n  readonly relation: Exclude<IdentityProjectionRelation, \"self\">;\n  readonly invocation: Exclude<IdentityProjectionInvocation, \"self-state\">;\n  readonly requiresLineOfSight: true;\n}\n\nexport type IdentityStatusOverlayDefinition =\n  | IdentitySelfStateOverlayDefinition\n  | IdentityTargetProjectionOverlayDefinition;\n\nexport interface InterfaceShellSurfaceDefinition {\n  readonly surfaceId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly kind: InterfaceShellSurfaceKind;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly priority: number;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface FocusPaneShellDefinition {\n  readonly panelId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly heading: string;\n  readonly interactive: boolean;\n  readonly combatBehavior: InterfaceCombatBehavior;\n}\n\nexport interface LineOfSightTargetPopupDefinition {\n  readonly popupId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly anchorId: string;\n  readonly targetId: string;\n  readonly summary: string;\n  readonly requiresLineOfSight: boolean;\n  readonly actionLabel?: string;\n}\n\nexport interface ReducedCombatOverlayPolicy {\n  readonly featureFlagId: string;\n  readonly mode: \"combat-safe\";\n  readonly retainedSurfaceKinds: readonly InterfaceShellSurfaceKind[];\n  readonly maxInteractiveSurfaces: number;\n}\n\nexport interface InterfaceShellDefinition {\n  readonly featureFlagId: string;\n  readonly surfaces: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups: readonly LineOfSightTargetPopupDefinition[];\n  readonly identityOverlays: readonly IdentityStatusOverlayDefinition[];\n  readonly paneHosts: readonly ThreeDPaneHostDefinition[];\n  readonly ambientAlerts: readonly LocalizedAmbientAlertDefinition[];\n  readonly reducedCombat: ReducedCombatOverlayPolicy;\n}\n\nexport interface InterfaceShellDefinitionInput {\n  readonly featureFlagId?: string;\n  readonly surfaces?: readonly InterfaceShellSurfaceDefinition[];\n  readonly focusPane?: FocusPaneShellDefinition;\n  readonly targetPopups?: readonly LineOfSightTargetPopupDefinition[];\n  readonly identityOverlays?: readonly IdentityStatusOverlayDefinition[];\n  readonly paneHosts?: readonly ThreeDPaneHostDefinition[];\n  readonly ambientAlerts?: readonly LocalizedAmbientAlertDefinition[];\n  readonly reducedCombat?: Partial<ReducedCombatOverlayPolicy>;\n}\n\nexport type InterfaceFocusShiftReason =\n  | \"keyboard\"\n  | \"direct-hotkey\"\n  | \"restore\"\n  | \"system\";\n\nexport interface InterfaceFocusShift {\n  readonly fromSurfaceId?: string;\n  readonly toSurfaceId: string;\n  readonly reason: InterfaceFocusShiftReason;\n}\n\nexport interface InterfaceShellStateDefinition {\n  readonly featureFlagId: string;\n  readonly mode: PlayerSystemInterfaceMode;\n  readonly focusedSurfaceId?: string;\n  readonly visibleSurfaceIds: readonly string[];\n  readonly focusShift?: InterfaceFocusShift;\n}\n\nexport interface InterfaceShellStateInput {\n  readonly mode: PlayerSystemInterfaceMode;\n  readonly focusedSurfaceId?: string;\n}\n\nexport interface ThreeDPaneHostDefinition {\n  readonly hostId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly pane: PlayerSystemPaneId;\n  readonly surfaceId: string;\n  readonly anchorId: string;\n  readonly supportedHosts: readonly OverlayHostKind[];\n}\n\nexport type AmbientAlertSeverity = \"info\" | \"warning\" | \"danger\";\n\nexport interface LocalizedAmbientAlertDefinition {\n  readonly alertId: string;\n  readonly owner: InterfaceShellOwner;\n  readonly severity: AmbientAlertSeverity;\n  readonly anchorId: string;\n  readonly messageKey: string;\n  readonly localizedMessages: Readonly<Record<string, string>>;\n  readonly liveRegionMode: \"polite\" | \"assertive\";\n}\n\nexport interface WorldSpacePanelDefinition {\n  readonly panelId: string;\n  readonly pane: PlayerSystemPaneId;\n  readonly anchorId: string;\n  readonly interactive: boolean;\n  readonly accessibilityLabel?: string;\n  readonly focusOrder?: number;\n}\n\nexport interface OverlayAlertMarker {\n  readonly markerId: string;\n  readonly severity: AmbientAlertSeverity;\n  readonly anchorId: string;\n}\n\nexport interface WorldSpaceCompositionSample {\n  readonly panelCount: number;\n  readonly focusPaneCount: number;\n  readonly alertMarkerCount: number;\n  readonly interactivePanelCount: number;\n}\n\nexport interface InterfaceContractAssessment {\n  readonly accepted: boolean;\n  readonly violations: readonly string[];\n}\n\nexport const PLAYER_SYSTEM_INTERFACE_PACKAGE = \"@plasius/player-system-interface\";\nexport const PLAYER_SYSTEM_INTERFACE_ENV_PREFIX = \"PLAYER_SYSTEM_INTERFACE\";\nexport const PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID =\n  \"isekai.player-system.interface.enabled\";\nexport const PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID =\n  PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID;\nexport const PLAYER_SYSTEM_IDENTITY_FEATURE_FLAG_ID =\n  \"isekai.player-system.identity.enabled\";\n\nexport const packageDescriptor: PackageDescriptor = Object.freeze({\n  packageName: PLAYER_SYSTEM_INTERFACE_PACKAGE,\n  featureFlagId: PLAYER_SYSTEM_PACKAGES_FEATURE_FLAG_ID,\n  envPrefix: PLAYER_SYSTEM_INTERFACE_ENV_PREFIX,\n  summary:\n    \"World-space Player System overlays, focus panes, and target-surface contracts for Plasius game experiences.\",\n});\n\nexport const defaultPlayerSystemInterfaceContract: PlayerSystemInterfaceContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_NFR_FEATURE_FLAG_ID,\n    accessibility: Object.freeze({\n      keyboardPath: \"sequential\",\n      focusRestorationTarget: \"trigger\",\n      liveRegionMode: \"polite\",\n      requiresAccessibleName: true,\n    }),\n    frameBudget: Object.freeze({\n      targetFps: 60,\n      maxFrameMs: 16,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultPlayerSystemInterfacePortabilityContract: PlayerSystemInterfacePortabilityContract =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_RUNTIME_PORTABILITY_FEATURE_FLAG_ID,\n    hostAdapters: Object.freeze({\n      supportedHosts: Object.freeze([\n        \"dom-overlay\",\n        \"native-overlay\",\n        \"headless-snapshot\",\n      ] satisfies OverlayHostKind[]),\n      requiredCapabilities: Object.freeze([\n        \"focus-restoration\",\n        \"live-region\",\n        \"anchor-registry\",\n      ] satisfies OverlayAdapterCapability[]),\n      forbiddenAssumptions: Object.freeze([\n        \"window-global\",\n        \"single-pane-layout\",\n        \"absolute-scene-coordinates\",\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      maxWorldPanels: 6,\n      maxFocusPanes: 3,\n      maxAlertMarkers: 8,\n      maxInteractivePanelsPerFrame: 2,\n    }),\n  });\n\nexport const defaultReducedCombatOverlayPolicy: ReducedCombatOverlayPolicy =\n  Object.freeze({\n    featureFlagId: PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    mode: \"combat-safe\",\n    retainedSurfaceKinds: Object.freeze([\n      \"alert-marker\",\n      \"target-popup\",\n      \"focus-pane\",\n      \"identity-overlay\",\n    ] satisfies InterfaceShellSurfaceKind[]),\n    maxInteractiveSurfaces: 1,\n  });\n\nexport function isPlayerSystemInterfaceMode(\n  value: string\n): value is PlayerSystemInterfaceMode {\n  return value === \"ambient\" || value === \"focused\" || value === \"combat-safe\";\n}\n\nexport function createWorldSpacePanelDefinition(\n  input: WorldSpacePanelDefinition\n): WorldSpacePanelDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createPlayerSystemInterfaceContract(\n  input: PlayerSystemInterfaceContractInput = {}\n): PlayerSystemInterfaceContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ?? defaultPlayerSystemInterfaceContract.featureFlagId,\n    accessibility: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.accessibility,\n      ...input.accessibility,\n    }),\n    frameBudget: Object.freeze({\n      ...defaultPlayerSystemInterfaceContract.frameBudget,\n      ...input.frameBudget,\n    }),\n  });\n}\n\nexport function createPlayerSystemInterfacePortabilityContract(\n  input: PlayerSystemInterfacePortabilityContractInput = {}\n): PlayerSystemInterfacePortabilityContract {\n  return Object.freeze({\n    featureFlagId:\n      input.featureFlagId ??\n      defaultPlayerSystemInterfacePortabilityContract.featureFlagId,\n    hostAdapters: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.hostAdapters,\n      ...input.hostAdapters,\n      supportedHosts: Object.freeze([\n        ...(input.hostAdapters?.supportedHosts ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .supportedHosts),\n      ]),\n      requiredCapabilities: Object.freeze([\n        ...(input.hostAdapters?.requiredCapabilities ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .requiredCapabilities),\n      ]),\n      forbiddenAssumptions: Object.freeze([\n        ...(input.hostAdapters?.forbiddenAssumptions ??\n          defaultPlayerSystemInterfacePortabilityContract.hostAdapters\n            .forbiddenAssumptions),\n      ]),\n    }),\n    compositionScale: Object.freeze({\n      ...defaultPlayerSystemInterfacePortabilityContract.compositionScale,\n      ...input.compositionScale,\n    }),\n  });\n}\n\nexport function createInterfaceShellSurfaceDefinition(\n  input: InterfaceShellSurfaceDefinition\n): InterfaceShellSurfaceDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createFocusPaneShellDefinition(\n  input: FocusPaneShellDefinition\n): FocusPaneShellDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createLineOfSightTargetPopupDefinition(\n  input: LineOfSightTargetPopupDefinition\n): LineOfSightTargetPopupDefinition {\n  return Object.freeze({ ...input });\n}\n\nexport function createIdentityStatusOverlayDefinition(\n  input: IdentityStatusOverlayDefinition\n): IdentityStatusOverlayDefinition {\n  return Object.freeze({\n    ...input,\n    perceivableFacts: Object.freeze([...input.perceivableFacts]),\n    readableFacts: Object.freeze([...input.readableFacts]),\n  });\n}\n\nexport function createThreeDPaneHostDefinition(\n  input: ThreeDPaneHostDefinition\n): ThreeDPaneHostDefinition {\n  return Object.freeze({\n    ...input,\n    supportedHosts: Object.freeze([...input.supportedHosts]),\n  });\n}\n\nexport function createLocalizedAmbientAlertDefinition(\n  input: LocalizedAmbientAlertDefinition\n): LocalizedAmbientAlertDefinition {\n  return Object.freeze({\n    ...input,\n    localizedMessages: Object.freeze({ ...input.localizedMessages }),\n  });\n}\n\nexport function createInterfaceShellDefinition(\n  input: InterfaceShellDefinitionInput = {}\n): InterfaceShellDefinition {\n  return Object.freeze({\n    featureFlagId: input.featureFlagId ?? PLAYER_SYSTEM_INTERFACE_FEATURE_FLAG_ID,\n    surfaces: Object.freeze([...(input.surfaces ?? [])]),\n    focusPane: input.focusPane ? Object.freeze({ ...input.focusPane }) : undefined,\n    targetPopups: Object.freeze([...(input.targetPopups ?? [])]),\n    identityOverlays: Object.freeze([...(input.identityOverlays ?? [])]),\n    paneHosts: Object.freeze([...(input.paneHosts ?? [])]),\n    ambientAlerts: Object.freeze([...(input.ambientAlerts ?? [])]),\n    reducedCombat: Object.freeze({\n      ...defaultReducedCombatOverlayPolicy,\n      ...input.reducedCombat,\n      retainedSurfaceKinds: Object.freeze([\n        ...(input.reducedCombat?.retainedSurfaceKinds ??\n          defaultReducedCombatOverlayPolicy.retainedSurfaceKinds),\n      ]),\n    }),\n  });\n}\n\nexport function createInterfaceShellState(\n  shell: InterfaceShellDefinition,\n  input: InterfaceShellStateInput\n): InterfaceShellStateDefinition {\n  const retainedSurfaceKinds = new Set(\n    shell.reducedCombat.retainedSurfaceKinds\n  );\n  const visibleSurfaceIds = shell.surfaces\n    .filter(\n      (surface) =>\n        input.mode !== \"combat-safe\" ||\n        (surface.combatBehavior !== \"suspend\" &&\n          retainedSurfaceKinds.has(surface.kind))\n    )\n    .map((surface) => surface.surfaceId);\n\n  if (\n    input.focusedSurfaceId &&\n    !visibleSurfaceIds.includes(input.focusedSurfaceId)\n  ) {\n    throw new RangeError(\n      `Focused surface '${input.focusedSurfaceId}' is not visible in ${input.mode} mode`\n    );\n  }\n\n  return Object.freeze({\n    featureFlagId: shell.featureFlagId,\n    mode: input.mode,\n    focusedSurfaceId:\n      input.mode === \"focused\" ? input.focusedSurfaceId : undefined,\n    visibleSurfaceIds: Object.freeze(visibleSurfaceIds),\n  });\n}\n\nexport function applyInterfaceShellFocusShift(\n  state: InterfaceShellStateDefinition,\n  focusShift: InterfaceFocusShift\n): InterfaceShellStateDefinition {\n  if (!state.visibleSurfaceIds.includes(focusShift.toSurfaceId)) {\n    throw new RangeError(\n      `Focused surface '${focusShift.toSurfaceId}' is not visible in ${state.mode} mode`\n    );\n  }\n\n  return Object.freeze({\n    ...state,\n    mode: \"focused\",\n    focusedSurfaceId: focusShift.toSurfaceId,\n    focusShift: Object.freeze({ ...focusShift }),\n  });\n}\n\nexport function resolveLocalizedAmbientAlertMessage(\n  alert: LocalizedAmbientAlertDefinition,\n  locale: string,\n  fallbackLocale = \"en-GB\"\n): string | undefined {\n  return alert.localizedMessages[locale] ?? alert.localizedMessages[fallbackLocale];\n}\n\nexport function assessIdentityStatusOverlayDefinition(\n  overlay: IdentityStatusOverlayDefinition\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n  const perceivableFacts = new Set(overlay.perceivableFacts);\n\n  if (overlay.readableFacts.some((fact) => !perceivableFacts.has(fact))) {\n    violations.push(\"readableFacts\");\n  }\n\n  if (overlay.readConfidence === \"withheld\" && overlay.readableFacts.length > 0) {\n    violations.push(\"withheldRead\");\n  }\n\n  if (overlay.targetKind === \"self\") {\n    if (overlay.relation !== \"self\") {\n      violations.push(\"selfRelation\");\n    }\n    if (overlay.invocation !== \"self-state\") {\n      violations.push(\"selfInvocation\");\n    }\n    if (overlay.requiresLineOfSight) {\n      violations.push(\"selfLineOfSight\");\n    }\n  } else {\n    if (overlay.targetId.length === 0) {\n      violations.push(\"targetId\");\n    }\n    if (!overlay.requiresLineOfSight) {\n      violations.push(\"lineOfSight\");\n    }\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n\nexport function assessPlayerSystemInterfaceComposition(\n  sample: WorldSpaceCompositionSample,\n  contract: PlayerSystemInterfacePortabilityContract = defaultPlayerSystemInterfacePortabilityContract\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n\n  if (sample.panelCount > contract.compositionScale.maxWorldPanels) {\n    violations.push(\"panelCount\");\n  }\n\n  if (sample.focusPaneCount > contract.compositionScale.maxFocusPanes) {\n    violations.push(\"focusPaneCount\");\n  }\n\n  if (sample.alertMarkerCount > contract.compositionScale.maxAlertMarkers) {\n    violations.push(\"alertMarkerCount\");\n  }\n\n  if (\n    sample.interactivePanelCount >\n    contract.compositionScale.maxInteractivePanelsPerFrame\n  ) {\n    violations.push(\"interactivePanelCount\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n\nexport function assessInterfaceShellDefinition(\n  shell: InterfaceShellDefinition\n): InterfaceContractAssessment {\n  const violations: string[] = [];\n  const ownerSet = new Set(shell.surfaces.map((surface) => surface.owner));\n  const retainedSurfaceKinds = new Set(shell.reducedCombat.retainedSurfaceKinds);\n  const interactiveSurfaceCount = shell.surfaces.filter(\n    (surface) => surface.interactive && retainedSurfaceKinds.has(surface.kind)\n  ).length;\n  const focusPane = shell.focusPane;\n\n  if (shell.surfaces.length === 0) {\n    violations.push(\"surfaces\");\n  }\n\n  if (focusPane && !ownerSet.has(focusPane.owner)) {\n    violations.push(\"focusPaneOwner\");\n  }\n\n  if (focusPane) {\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.kind === \"focus-pane\" &&\n        surface.anchorId === focusPane.anchorId &&\n        surface.owner === focusPane.owner\n    );\n    if (!matchingSurface) {\n      violations.push(\"focusPaneSurface\");\n    }\n  }\n\n  if (\n    interactiveSurfaceCount > shell.reducedCombat.maxInteractiveSurfaces\n  ) {\n    violations.push(\"interactiveSurfaceCount\");\n  }\n\n  for (const popup of shell.targetPopups) {\n    if (popup.requiresLineOfSight && popup.anchorId.length === 0) {\n      violations.push(`popup:${popup.popupId}`);\n    }\n  }\n\n  for (const overlay of shell.identityOverlays) {\n    const identityAssessment = assessIdentityStatusOverlayDefinition(overlay);\n    for (const violation of identityAssessment.violations) {\n      violations.push(`identityOverlay:${overlay.overlayId}:${violation}`);\n    }\n\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.surfaceId === overlay.surfaceId &&\n        surface.kind === \"identity-overlay\"\n    );\n    if (!matchingSurface) {\n      violations.push(`identityOverlaySurface:${overlay.overlayId}`);\n    }\n  }\n\n  for (const paneHost of shell.paneHosts) {\n    const matchingSurface = shell.surfaces.find(\n      (surface) =>\n        surface.surfaceId === paneHost.surfaceId &&\n        surface.owner === paneHost.owner &&\n        surface.anchorId === paneHost.anchorId\n    );\n    if (!matchingSurface) {\n      violations.push(`paneHost:${paneHost.hostId}`);\n    }\n  }\n\n  for (const alert of shell.ambientAlerts) {\n    if (Object.keys(alert.localizedMessages).length === 0) {\n      violations.push(`alert:${alert.alertId}`);\n    }\n  }\n\n  if (\n    ownerSet.has(\"player-system\") &&\n    ownerSet.has(\"party-system\") &&\n    shell.reducedCombat.retainedSurfaceKinds.length === 0\n  ) {\n    violations.push(\"reducedCombat\");\n  }\n\n  return Object.freeze({\n    accepted: violations.length === 0,\n    violations: Object.freeze(violations),\n  });\n}\n"],"mappings":";AAoRO,IAAM,kCAAkC;AACxC,IAAM,qCAAqC;AAC3C,IAAM,0CACX;AACK,IAAM,yCACX;AACK,IAAM,4CACX;AACK,IAAM,oDACX;AACK,IAAM,yCACX;AAEK,IAAM,oBAAuC,OAAO,OAAO;AAAA,EAChE,aAAa;AAAA,EACb,eAAe;AAAA,EACf,WAAW;AAAA,EACX,SACE;AACJ,CAAC;AAEM,IAAM,uCACX,OAAO,OAAO;AAAA,EACZ,eAAe;AAAA,EACf,eAAe,OAAO,OAAO;AAAA,IAC3B,cAAc;AAAA,IACd,wBAAwB;AAAA,IACxB,gBAAgB;AAAA,IAChB,wBAAwB;AAAA,EAC1B,CAAC;AAAA,EACD,aAAa,OAAO,OAAO;AAAA,IACzB,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,8BAA8B;AAAA,EAChC,CAAC;AACH,CAAC;AAEI,IAAM,kDACX,OAAO,OAAO;AAAA,EACZ,eAAe;AAAA,EACf,cAAc,OAAO,OAAO;AAAA,IAC1B,gBAAgB,OAAO,OAAO;AAAA,MAC5B;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAA6B;AAAA,IAC7B,sBAAsB,OAAO,OAAO;AAAA,MAClC;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAsC;AAAA,IACtC,sBAAsB,OAAO,OAAO;AAAA,MAClC;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA,EACD,kBAAkB,OAAO,OAAO;AAAA,IAC9B,gBAAgB;AAAA,IAChB,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,8BAA8B;AAAA,EAChC,CAAC;AACH,CAAC;AAEI,IAAM,oCACX,OAAO,OAAO;AAAA,EACZ,eAAe;AAAA,EACf,MAAM;AAAA,EACN,sBAAsB,OAAO,OAAO;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAuC;AAAA,EACvC,wBAAwB;AAC1B,CAAC;AAEI,SAAS,4BACd,OACoC;AACpC,SAAO,UAAU,aAAa,UAAU,aAAa,UAAU;AACjE;AAEO,SAAS,gCACd,OAC2B;AAC3B,SAAO,OAAO,OAAO,EAAE,GAAG,MAAM,CAAC;AACnC;AAEO,SAAS,oCACd,QAA4C,CAAC,GACd;AAC/B,SAAO,OAAO,OAAO;AAAA,IACnB,eACE,MAAM,iBAAiB,qCAAqC;AAAA,IAC9D,eAAe,OAAO,OAAO;AAAA,MAC3B,GAAG,qCAAqC;AAAA,MACxC,GAAG,MAAM;AAAA,IACX,CAAC;AAAA,IACD,aAAa,OAAO,OAAO;AAAA,MACzB,GAAG,qCAAqC;AAAA,MACxC,GAAG,MAAM;AAAA,IACX,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,+CACd,QAAuD,CAAC,GACd;AAC1C,SAAO,OAAO,OAAO;AAAA,IACnB,eACE,MAAM,iBACN,gDAAgD;AAAA,IAClD,cAAc,OAAO,OAAO;AAAA,MAC1B,GAAG,gDAAgD;AAAA,MACnD,GAAG,MAAM;AAAA,MACT,gBAAgB,OAAO,OAAO;AAAA,QAC5B,GAAI,MAAM,cAAc,kBACtB,gDAAgD,aAC7C;AAAA,MACP,CAAC;AAAA,MACD,sBAAsB,OAAO,OAAO;AAAA,QAClC,GAAI,MAAM,cAAc,wBACtB,gDAAgD,aAC7C;AAAA,MACP,CAAC;AAAA,MACD,sBAAsB,OAAO,OAAO;AAAA,QAClC,GAAI,MAAM,cAAc,wBACtB,gDAAgD,aAC7C;AAAA,MACP,CAAC;AAAA,IACH,CAAC;AAAA,IACD,kBAAkB,OAAO,OAAO;AAAA,MAC9B,GAAG,gDAAgD;AAAA,MACnD,GAAG,MAAM;AAAA,IACX,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,sCACd,OACiC;AACjC,SAAO,OAAO,OAAO,EAAE,GAAG,MAAM,CAAC;AACnC;AAEO,SAAS,+BACd,OAC0B;AAC1B,SAAO,OAAO,OAAO,EAAE,GAAG,MAAM,CAAC;AACnC;AAEO,SAAS,uCACd,OACkC;AAClC,SAAO,OAAO,OAAO,EAAE,GAAG,MAAM,CAAC;AACnC;AAEO,SAAS,sCACd,OACiC;AACjC,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,kBAAkB,OAAO,OAAO,CAAC,GAAG,MAAM,gBAAgB,CAAC;AAAA,IAC3D,eAAe,OAAO,OAAO,CAAC,GAAG,MAAM,aAAa,CAAC;AAAA,EACvD,CAAC;AACH;AAEO,SAAS,+BACd,OAC0B;AAC1B,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,gBAAgB,OAAO,OAAO,CAAC,GAAG,MAAM,cAAc,CAAC;AAAA,EACzD,CAAC;AACH;AAEO,SAAS,sCACd,OACiC;AACjC,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,mBAAmB,OAAO,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC;AAAA,EACjE,CAAC;AACH;AAEO,SAAS,+BACd,QAAuC,CAAC,GACd;AAC1B,SAAO,OAAO,OAAO;AAAA,IACnB,eAAe,MAAM,iBAAiB;AAAA,IACtC,UAAU,OAAO,OAAO,CAAC,GAAI,MAAM,YAAY,CAAC,CAAE,CAAC;AAAA,IACnD,WAAW,MAAM,YAAY,OAAO,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI;AAAA,IACrE,cAAc,OAAO,OAAO,CAAC,GAAI,MAAM,gBAAgB,CAAC,CAAE,CAAC;AAAA,IAC3D,kBAAkB,OAAO,OAAO,CAAC,GAAI,MAAM,oBAAoB,CAAC,CAAE,CAAC;AAAA,IACnE,WAAW,OAAO,OAAO,CAAC,GAAI,MAAM,aAAa,CAAC,CAAE,CAAC;AAAA,IACrD,eAAe,OAAO,OAAO,CAAC,GAAI,MAAM,iBAAiB,CAAC,CAAE,CAAC;AAAA,IAC7D,eAAe,OAAO,OAAO;AAAA,MAC3B,GAAG;AAAA,MACH,GAAG,MAAM;AAAA,MACT,sBAAsB,OAAO,OAAO;AAAA,QAClC,GAAI,MAAM,eAAe,wBACvB,kCAAkC;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,0BACd,OACA,OAC+B;AAC/B,QAAM,uBAAuB,IAAI;AAAA,IAC/B,MAAM,cAAc;AAAA,EACtB;AACA,QAAM,oBAAoB,MAAM,SAC7B;AAAA,IACC,CAAC,YACC,MAAM,SAAS,iBACd,QAAQ,mBAAmB,aAC1B,qBAAqB,IAAI,QAAQ,IAAI;AAAA,EAC3C,EACC,IAAI,CAAC,YAAY,QAAQ,SAAS;AAErC,MACE,MAAM,oBACN,CAAC,kBAAkB,SAAS,MAAM,gBAAgB,GAClD;AACA,UAAM,IAAI;AAAA,MACR,oBAAoB,MAAM,gBAAgB,uBAAuB,MAAM,IAAI;AAAA,IAC7E;AAAA,EACF;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,eAAe,MAAM;AAAA,IACrB,MAAM,MAAM;AAAA,IACZ,kBACE,MAAM,SAAS,YAAY,MAAM,mBAAmB;AAAA,IACtD,mBAAmB,OAAO,OAAO,iBAAiB;AAAA,EACpD,CAAC;AACH;AAEO,SAAS,8BACd,OACA,YAC+B;AAC/B,MAAI,CAAC,MAAM,kBAAkB,SAAS,WAAW,WAAW,GAAG;AAC7D,UAAM,IAAI;AAAA,MACR,oBAAoB,WAAW,WAAW,uBAAuB,MAAM,IAAI;AAAA,IAC7E;AAAA,EACF;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,MAAM;AAAA,IACN,kBAAkB,WAAW;AAAA,IAC7B,YAAY,OAAO,OAAO,EAAE,GAAG,WAAW,CAAC;AAAA,EAC7C,CAAC;AACH;AAEO,SAAS,oCACd,OACA,QACA,iBAAiB,SACG;AACpB,SAAO,MAAM,kBAAkB,MAAM,KAAK,MAAM,kBAAkB,cAAc;AAClF;AAEO,SAAS,sCACd,SAC6B;AAC7B,QAAM,aAAuB,CAAC;AAC9B,QAAM,mBAAmB,IAAI,IAAI,QAAQ,gBAAgB;AAEzD,MAAI,QAAQ,cAAc,KAAK,CAAC,SAAS,CAAC,iBAAiB,IAAI,IAAI,CAAC,GAAG;AACrE,eAAW,KAAK,eAAe;AAAA,EACjC;AAEA,MAAI,QAAQ,mBAAmB,cAAc,QAAQ,cAAc,SAAS,GAAG;AAC7E,eAAW,KAAK,cAAc;AAAA,EAChC;AAEA,MAAI,QAAQ,eAAe,QAAQ;AACjC,QAAI,QAAQ,aAAa,QAAQ;AAC/B,iBAAW,KAAK,cAAc;AAAA,IAChC;AACA,QAAI,QAAQ,eAAe,cAAc;AACvC,iBAAW,KAAK,gBAAgB;AAAA,IAClC;AACA,QAAI,QAAQ,qBAAqB;AAC/B,iBAAW,KAAK,iBAAiB;AAAA,IACnC;AAAA,EACF,OAAO;AACL,QAAI,QAAQ,SAAS,WAAW,GAAG;AACjC,iBAAW,KAAK,UAAU;AAAA,IAC5B;AACA,QAAI,CAAC,QAAQ,qBAAqB;AAChC,iBAAW,KAAK,aAAa;AAAA,IAC/B;AAAA,EACF;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,UAAU,WAAW,WAAW;AAAA,IAChC,YAAY,OAAO,OAAO,UAAU;AAAA,EACtC,CAAC;AACH;AAEO,SAAS,uCACd,QACA,WAAqD,iDACxB;AAC7B,QAAM,aAAuB,CAAC;AAE9B,MAAI,OAAO,aAAa,SAAS,iBAAiB,gBAAgB;AAChE,eAAW,KAAK,YAAY;AAAA,EAC9B;AAEA,MAAI,OAAO,iBAAiB,SAAS,iBAAiB,eAAe;AACnE,eAAW,KAAK,gBAAgB;AAAA,EAClC;AAEA,MAAI,OAAO,mBAAmB,SAAS,iBAAiB,iBAAiB;AACvE,eAAW,KAAK,kBAAkB;AAAA,EACpC;AAEA,MACE,OAAO,wBACP,SAAS,iBAAiB,8BAC1B;AACA,eAAW,KAAK,uBAAuB;AAAA,EACzC;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,UAAU,WAAW,WAAW;AAAA,IAChC,YAAY,OAAO,OAAO,UAAU;AAAA,EACtC,CAAC;AACH;AAEO,SAAS,+BACd,OAC6B;AAC7B,QAAM,aAAuB,CAAC;AAC9B,QAAM,WAAW,IAAI,IAAI,MAAM,SAAS,IAAI,CAAC,YAAY,QAAQ,KAAK,CAAC;AACvE,QAAM,uBAAuB,IAAI,IAAI,MAAM,cAAc,oBAAoB;AAC7E,QAAM,0BAA0B,MAAM,SAAS;AAAA,IAC7C,CAAC,YAAY,QAAQ,eAAe,qBAAqB,IAAI,QAAQ,IAAI;AAAA,EAC3E,EAAE;AACF,QAAM,YAAY,MAAM;AAExB,MAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,eAAW,KAAK,UAAU;AAAA,EAC5B;AAEA,MAAI,aAAa,CAAC,SAAS,IAAI,UAAU,KAAK,GAAG;AAC/C,eAAW,KAAK,gBAAgB;AAAA,EAClC;AAEA,MAAI,WAAW;AACb,UAAM,kBAAkB,MAAM,SAAS;AAAA,MACrC,CAAC,YACC,QAAQ,SAAS,gBACjB,QAAQ,aAAa,UAAU,YAC/B,QAAQ,UAAU,UAAU;AAAA,IAChC;AACA,QAAI,CAAC,iBAAiB;AACpB,iBAAW,KAAK,kBAAkB;AAAA,IACpC;AAAA,EACF;AAEA,MACE,0BAA0B,MAAM,cAAc,wBAC9C;AACA,eAAW,KAAK,yBAAyB;AAAA,EAC3C;AAEA,aAAW,SAAS,MAAM,cAAc;AACtC,QAAI,MAAM,uBAAuB,MAAM,SAAS,WAAW,GAAG;AAC5D,iBAAW,KAAK,SAAS,MAAM,OAAO,EAAE;AAAA,IAC1C;AAAA,EACF;AAEA,aAAW,WAAW,MAAM,kBAAkB;AAC5C,UAAM,qBAAqB,sCAAsC,OAAO;AACxE,eAAW,aAAa,mBAAmB,YAAY;AACrD,iBAAW,KAAK,mBAAmB,QAAQ,SAAS,IAAI,SAAS,EAAE;AAAA,IACrE;AAEA,UAAM,kBAAkB,MAAM,SAAS;AAAA,MACrC,CAAC,YACC,QAAQ,cAAc,QAAQ,aAC9B,QAAQ,SAAS;AAAA,IACrB;AACA,QAAI,CAAC,iBAAiB;AACpB,iBAAW,KAAK,0BAA0B,QAAQ,SAAS,EAAE;AAAA,IAC/D;AAAA,EACF;AAEA,aAAW,YAAY,MAAM,WAAW;AACtC,UAAM,kBAAkB,MAAM,SAAS;AAAA,MACrC,CAAC,YACC,QAAQ,cAAc,SAAS,aAC/B,QAAQ,UAAU,SAAS,SAC3B,QAAQ,aAAa,SAAS;AAAA,IAClC;AACA,QAAI,CAAC,iBAAiB;AACpB,iBAAW,KAAK,YAAY,SAAS,MAAM,EAAE;AAAA,IAC/C;AAAA,EACF;AAEA,aAAW,SAAS,MAAM,eAAe;AACvC,QAAI,OAAO,KAAK,MAAM,iBAAiB,EAAE,WAAW,GAAG;AACrD,iBAAW,KAAK,SAAS,MAAM,OAAO,EAAE;AAAA,IAC1C;AAAA,EACF;AAEA,MACE,SAAS,IAAI,eAAe,KAC5B,SAAS,IAAI,cAAc,KAC3B,MAAM,cAAc,qBAAqB,WAAW,GACpD;AACA,eAAW,KAAK,eAAe;AAAA,EACjC;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,UAAU,WAAW,WAAW;AAAA,IAChC,YAAY,OAAO,OAAO,UAAU;AAAA,EACtC,CAAC;AACH;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/player-system-interface",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "World-space Player System overlays, focus panes, and target-surface contracts for Plasius game experiences",
   "type": "module",
   "sideEffects": false,