@syntrologie/runtime-sdk 1.0.1 → 2.0.0

package/dist/apps/faq/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../adaptives/adaptive-faq/src/FAQWidget.tsx", "../../../../adaptives/adaptive-faq/src/runtime.ts", "../../../../adaptives/adaptive-faq/src/cdn.ts"],
+  "sourcesContent": ["/**\n * Adaptive FAQ - FAQWidget Component\n *\n * React component that renders a collapsible Q&A accordion with per-item\n * conditional visibility based on showWhen decision strategies.\n *\n * Demonstrates the compositional action pattern where child actions\n * (faq:question) serve as configuration data for the parent widget.\n */\n\nimport React, { useEffect, useReducer, useMemo, useCallback, useState } from \"react\";\nimport type { FAQWidgetProps, FAQQuestionAction, FAQConfig, FAQWidgetRuntime } from \"./types\";\n\n// ============================================================================\n// Styles\n// ============================================================================\n\nconst baseStyles = {\n  container: {\n    fontFamily: \"system-ui, -apple-system, sans-serif\",\n    maxWidth: \"800px\",\n    margin: \"0 auto\",\n  },\n  searchWrapper: {\n    marginBottom: \"16px\",\n  },\n  searchInput: {\n    width: \"100%\",\n    padding: \"12px 16px\",\n    borderRadius: \"8px\",\n    fontSize: \"14px\",\n    outline: \"none\",\n    transition: \"border-color 0.15s ease\",\n  },\n  accordion: {\n    display: \"flex\",\n    flexDirection: \"column\" as const,\n    gap: \"8px\",\n  },\n  item: {\n    borderRadius: \"8px\",\n    overflow: \"hidden\",\n    transition: \"box-shadow 0.15s ease\",\n  },\n  question: {\n    width: \"100%\",\n    padding: \"16px 20px\",\n    display: \"flex\",\n    alignItems: \"center\",\n    justifyContent: \"space-between\",\n    border: \"none\",\n    cursor: \"pointer\",\n    fontSize: \"15px\",\n    fontWeight: 500,\n    textAlign: \"left\" as const,\n    transition: \"background-color 0.15s ease\",\n  },\n  chevron: {\n    fontSize: \"18px\",\n    transition: \"transform 0.2s ease\",\n  },\n  answer: {\n    padding: \"0 20px 16px 20px\",\n    fontSize: \"14px\",\n    lineHeight: 1.6,\n    overflow: \"hidden\",\n    transition: \"max-height 0.2s ease, padding 0.2s ease\",\n  },\n  category: {\n    display: \"inline-block\",\n    fontSize: \"11px\",\n    fontWeight: 600,\n    textTransform: \"uppercase\" as const,\n    letterSpacing: \"0.05em\",\n    padding: \"4px 8px\",\n    borderRadius: \"4px\",\n    marginBottom: \"8px\",\n  },\n  emptyState: {\n    textAlign: \"center\" as const,\n    padding: \"48px 24px\",\n    fontSize: \"14px\",\n  },\n  noResults: {\n    textAlign: \"center\" as const,\n    padding: \"32px 16px\",\n    fontSize: \"14px\",\n  },\n} as const;\n\nconst themeStyles = {\n  light: {\n    container: {\n      backgroundColor: \"#ffffff\",\n      color: \"#111827\",\n    },\n    searchInput: {\n      backgroundColor: \"#f9fafb\",\n      border: \"1px solid #e5e7eb\",\n      color: \"#111827\",\n    },\n    item: {\n      backgroundColor: \"#f9fafb\",\n      border: \"1px solid #e5e7eb\",\n    },\n    itemExpanded: {\n      boxShadow: \"0 4px 12px rgba(0, 0, 0, 0.08)\",\n    },\n    question: {\n      backgroundColor: \"transparent\",\n      color: \"#111827\",\n    },\n    questionHover: {\n      backgroundColor: \"#f3f4f6\",\n    },\n    answer: {\n      color: \"#4b5563\",\n    },\n    category: {\n      backgroundColor: \"#e0e7ff\",\n      color: \"#4338ca\",\n    },\n    emptyState: {\n      color: \"#9ca3af\",\n    },\n  },\n  dark: {\n    container: {\n      backgroundColor: \"#111827\",\n      color: \"#f9fafb\",\n    },\n    searchInput: {\n      backgroundColor: \"#1f2937\",\n      border: \"1px solid #374151\",\n      color: \"#f9fafb\",\n    },\n    item: {\n      backgroundColor: \"#1f2937\",\n      border: \"1px solid #374151\",\n    },\n    itemExpanded: {\n      boxShadow: \"0 4px 12px rgba(0, 0, 0, 0.3)\",\n    },\n    question: {\n      backgroundColor: \"transparent\",\n      color: \"#f9fafb\",\n    },\n    questionHover: {\n      backgroundColor: \"#374151\",\n    },\n    answer: {\n      color: \"#9ca3af\",\n    },\n    category: {\n      backgroundColor: \"#312e81\",\n      color: \"#a5b4fc\",\n    },\n    emptyState: {\n      color: \"#6b7280\",\n    },\n  },\n} as const;\n\n// ============================================================================\n// FAQItem Component\n// ============================================================================\n\ninterface FAQItemProps {\n  item: FAQQuestionAction;\n  isExpanded: boolean;\n  onToggle: () => void;\n  theme: \"light\" | \"dark\";\n}\n\nfunction FAQItem({ item, isExpanded, onToggle, theme }: FAQItemProps) {\n  const [isHovered, setIsHovered] = useState(false);\n  const colors = themeStyles[theme];\n  const { question, answer, category } = item.config;\n\n  const itemStyle: React.CSSProperties = {\n    ...baseStyles.item,\n    ...colors.item,\n    ...(isExpanded ? colors.itemExpanded : {}),\n  };\n\n  const questionStyle: React.CSSProperties = {\n    ...baseStyles.question,\n    ...colors.question,\n    ...(isHovered ? colors.questionHover : {}),\n  };\n\n  const chevronStyle: React.CSSProperties = {\n    ...baseStyles.chevron,\n    transform: isExpanded ? \"rotate(180deg)\" : \"rotate(0deg)\",\n  };\n\n  const answerStyle: React.CSSProperties = {\n    ...baseStyles.answer,\n    ...colors.answer,\n    maxHeight: isExpanded ? \"500px\" : \"0\",\n    paddingBottom: isExpanded ? \"16px\" : \"0\",\n  };\n\n  const categoryStyle: React.CSSProperties = {\n    ...baseStyles.category,\n    ...colors.category,\n  };\n\n  return (\n    <div style={itemStyle}>\n      <button\n        style={questionStyle}\n        onClick={onToggle}\n        onMouseEnter={() => setIsHovered(true)}\n        onMouseLeave={() => setIsHovered(false)}\n        aria-expanded={isExpanded}\n      >\n        <span>{question}</span>\n        <span style={chevronStyle}>\u25BC</span>\n      </button>\n      <div style={answerStyle} aria-hidden={!isExpanded}>\n        {category && <span style={categoryStyle}>{category}</span>}\n        <p style={{ margin: 0 }}>{answer}</p>\n      </div>\n    </div>\n  );\n}\n\n// ============================================================================\n// FAQWidget Component\n// ============================================================================\n\n/**\n * FAQWidget - Renders a collapsible Q&A accordion with per-item activation.\n *\n * This component demonstrates the compositional action pattern:\n * - Parent (FAQWidget) receives `config.actions` array\n * - Each action has optional `showWhen` for per-item visibility\n * - Parent evaluates showWhen and filters visible questions\n * - Parent manages expand state and re-rendering on context changes\n */\nexport function FAQWidget({ config, runtime, instanceId }: FAQWidgetProps) {\n  // Force re-render when context changes\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  // Track expanded question IDs\n  const [expandedIds, setExpandedIds] = useState<Set<string>>(new Set());\n\n  // Search query state\n  const [searchQuery, setSearchQuery] = useState(\"\");\n\n  // Subscribe to context changes for reactive updates\n  useEffect(() => {\n    const unsubscribe = runtime.context.subscribe(() => {\n      forceUpdate();\n    });\n    return unsubscribe;\n  }, [runtime.context]);\n\n  // Filter visible questions based on per-item showWhen\n  const visibleQuestions = useMemo(() => {\n    return config.actions.filter((q) => {\n      // No showWhen = always visible\n      if (!q.showWhen) return true;\n\n      // Evaluate the decision strategy\n      const result = runtime.evaluateSync<boolean>(q.showWhen);\n      return result.value;\n    });\n  }, [config.actions, runtime]);\n\n  // Apply search filter\n  const filteredQuestions = useMemo(() => {\n    if (!config.searchable || !searchQuery.trim()) {\n      return visibleQuestions;\n    }\n\n    const query = searchQuery.toLowerCase();\n    return visibleQuestions.filter(\n      (q) =>\n        q.config.question.toLowerCase().includes(query) ||\n        q.config.answer.toLowerCase().includes(query) ||\n        q.config.category?.toLowerCase().includes(query)\n    );\n  }, [visibleQuestions, searchQuery, config.searchable]);\n\n  // Resolve theme (auto \u2192 detect system preference)\n  const resolvedTheme = useMemo(() => {\n    if (config.theme !== \"auto\") return config.theme;\n\n    // Check system preference (SSR-safe)\n    if (typeof window !== \"undefined\") {\n      return window.matchMedia?.(\"(prefers-color-scheme: dark)\").matches\n        ? \"dark\"\n        : \"light\";\n    }\n    return \"light\";\n  }, [config.theme]);\n\n  // Handle question toggle\n  const handleToggle = useCallback(\n    (id: string) => {\n      setExpandedIds((prev) => {\n        const next = new Set(prev);\n\n        if (config.expandBehavior === \"single\") {\n          // Single mode: collapse all others\n          if (prev.has(id)) {\n            return new Set();\n          }\n          return new Set([id]);\n        } else {\n          // Multiple mode: toggle this one\n          if (prev.has(id)) {\n            next.delete(id);\n          } else {\n            next.add(id);\n          }\n          return next;\n        }\n      });\n\n      // Publish toggle event for analytics\n      runtime.events.publish(\"faq:toggled\", {\n        instanceId,\n        questionId: id,\n        expanded: !expandedIds.has(id),\n        timestamp: Date.now(),\n      });\n    },\n    [config.expandBehavior, runtime.events, instanceId, expandedIds]\n  );\n\n  // Compute styles\n  const containerStyle: React.CSSProperties = {\n    ...baseStyles.container,\n    ...themeStyles[resolvedTheme].container,\n  };\n\n  const searchInputStyle: React.CSSProperties = {\n    ...baseStyles.searchInput,\n    ...themeStyles[resolvedTheme].searchInput,\n  };\n\n  const emptyStateStyle: React.CSSProperties = {\n    ...baseStyles.emptyState,\n    ...themeStyles[resolvedTheme].emptyState,\n  };\n\n  // Empty state (no visible questions at all)\n  if (visibleQuestions.length === 0) {\n    return (\n      <div style={containerStyle} data-adaptive-id={instanceId} data-adaptive-type=\"adaptive-faq\">\n        <div style={emptyStateStyle}>\n          No FAQ questions available.\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <div style={containerStyle} data-adaptive-id={instanceId} data-adaptive-type=\"adaptive-faq\">\n      {/* Search input */}\n      {config.searchable && (\n        <div style={baseStyles.searchWrapper}>\n          <input\n            type=\"text\"\n            placeholder=\"Search questions...\"\n            value={searchQuery}\n            onChange={(e) => setSearchQuery(e.target.value)}\n            style={searchInputStyle}\n          />\n        </div>\n      )}\n\n      {/* Accordion */}\n      <div style={baseStyles.accordion}>\n        {filteredQuestions.map((q) => (\n          <FAQItem\n            key={q.config.id}\n            item={q}\n            isExpanded={expandedIds.has(q.config.id)}\n            onToggle={() => handleToggle(q.config.id)}\n            theme={resolvedTheme}\n          />\n        ))}\n      </div>\n\n      {/* No search results */}\n      {config.searchable && filteredQuestions.length === 0 && searchQuery && (\n        <div style={{ ...baseStyles.noResults, ...themeStyles[resolvedTheme].emptyState }}>\n          No questions found matching \"{searchQuery}\"\n        </div>\n      )}\n    </div>\n  );\n}\n\n// ============================================================================\n// Mountable Widget Interface\n// ============================================================================\n\n/**\n * Mountable widget interface for the runtime's WidgetRegistry.\n */\nexport const FAQMountableWidget = {\n  mount(\n    container: HTMLElement,\n    config?: FAQConfig & { runtime?: FAQWidgetRuntime; instanceId?: string }\n  ) {\n    // This is a simplified mount for non-React environments\n    // In practice, the runtime handles React rendering\n\n    const { runtime, instanceId = \"faq-widget\", ...faqConfig } = config || {\n      expandBehavior: \"single\" as const,\n      searchable: false,\n      theme: \"auto\" as const,\n      actions: [],\n    };\n\n    // Create simple HTML fallback if no runtime\n    if (!runtime) {\n      const questions = faqConfig.actions || [];\n      container.innerHTML = `\n        <div style=\"font-family: system-ui; max-width: 800px;\">\n          ${questions\n            .map(\n              (q) => `\n            <div style=\"margin-bottom: 8px; padding: 16px; background: #f9fafb; border-radius: 8px;\">\n              <strong>${q.config.question}</strong>\n              <p style=\"margin-top: 8px; color: #4b5563;\">${q.config.answer}</p>\n            </div>\n          `\n            )\n            .join(\"\")}\n        </div>\n      `;\n    }\n\n    return () => {\n      container.innerHTML = \"\";\n    };\n  },\n};\n\nexport default FAQWidget;\n", "/**\n * Adaptive FAQ - Runtime Module\n *\n * Runtime manifest for the FAQ accordion adaptive.\n * This is a widget-based adaptive with no action executors.\n */\n\nimport { FAQMountableWidget } from \"./FAQWidget\";\n\n// ============================================================================\n// App Runtime Manifest\n// ============================================================================\n\n/**\n * Runtime manifest for adaptive-faq.\n *\n * Note: This adaptive is widget-based, not action-based.\n * The `faq:question` actions are compositional - they're rendered by\n * the widget, not executed by the runtime.\n */\nexport const runtime = {\n  id: \"adaptive-faq\",\n  version: \"1.0.0\",\n  name: \"FAQ Accordion\",\n  description: \"Collapsible Q&A accordion with per-item conditional visibility\",\n\n  /**\n   * No action executors - faq:question actions are compositional,\n   * meaning they serve as configuration for the FAQWidget.\n   */\n  executors: [],\n\n  /**\n   * Widget definitions for the runtime's WidgetRegistry.\n   */\n  widgets: [\n    {\n      id: \"adaptive-faq:accordion\",\n      component: FAQMountableWidget,\n      metadata: {\n        name: \"FAQ Accordion\",\n        description: \"Collapsible Q&A accordion with search\",\n        icon: \"\u2753\",\n      },\n    },\n  ],\n};\n\nexport default runtime;\n", "/**\n * CDN Entry Point for Adaptive FAQ\n *\n * This module is bundled for CDN delivery and self-registers with the global\n * SynOS app registry when loaded dynamically via the AppLoader.\n */\n\nimport { runtime } from \"./runtime\";\n\n/**\n * App manifest for registry registration.\n * Follows the AppManifest interface expected by AppLoader/AppRegistry.\n */\nexport const manifest = {\n  id: \"faq\",\n  version: runtime.version,\n  name: runtime.name,\n  description: runtime.description,\n  runtime: {\n    // FAQ is widget-based, no action executors\n    actions: [],\n    widgets: runtime.widgets,\n  },\n  metadata: {\n    isBuiltIn: false,\n  },\n};\n\n/**\n * Self-register with global registry if available.\n * This happens when loaded via script tag (UMD).\n */\nif (typeof window !== \"undefined\") {\n  const globalRegistry = (window as any).__SYNOS_APP_REGISTRY__;\n  if (globalRegistry && typeof globalRegistry.register === \"function\") {\n    globalRegistry.register(manifest);\n  }\n}\n\nexport default manifest;\n"],
+  "mappings": "AAUA,OAAgB,aAAAA,EAAW,cAAAC,EAAY,WAAAC,EAAS,eAAAC,EAAa,YAAAC,MAAgB,QAwMvE,OAOE,OAAAC,EAPF,QAAAC,MAAA,oBAmMC,IAAMC,EAAqB,CAChC,MACEC,EACAC,EACA,CAIA,GAAM,CAAE,QAAAC,EAAS,WAAAC,EAAa,aAAc,GAAGC,CAAU,EAAIH,GAAU,CACrE,eAAgB,SAChB,WAAY,GACZ,MAAO,OACP,QAAS,CAAC,CACZ,EAGA,GAAI,CAACC,EAAS,CACZ,IAAMG,EAAYD,EAAU,SAAW,CAAC,EACxCJ,EAAU,UAAY;AAAA;AAAA,YAEhBK,EACC,IACEC,GAAM;AAAA;AAAA,wBAEGA,EAAE,OAAO,QAAQ;AAAA,4DACmBA,EAAE,OAAO,MAAM;AAAA;AAAA,WAG/D,EACC,KAAK,EAAE,CAAC;AAAA;AAAA,OAGjB,CAEA,MAAO,IAAM,CACXN,EAAU,UAAY,EACxB,CACF,CACF,ECvaO,IAAMO,EAAU,CACrB,GAAI,eACJ,QAAS,QACT,KAAM,gBACN,YAAa,iEAMb,UAAW,CAAC,EAKZ,QAAS,CACP,CACE,GAAI,yBACJ,UAAWC,EACX,SAAU,CACR,KAAM,gBACN,YAAa,wCACb,KAAM,QACR,CACF,CACF,CACF,ECjCO,IAAMC,EAAW,CACtB,GAAI,MACJ,QAASC,EAAQ,QACjB,KAAMA,EAAQ,KACd,YAAaA,EAAQ,YACrB,QAAS,CAEP,QAAS,CAAC,EACV,QAASA,EAAQ,OACnB,EACA,SAAU,CACR,UAAW,EACb,CACF,EAMA,GAAI,OAAO,OAAW,IAAa,CACjC,IAAMC,EAAkB,OAAe,uBACnCA,GAAkB,OAAOA,EAAe,UAAa,YACvDA,EAAe,SAASF,CAAQ,CAEpC,CAEA,IAAOG,EAAQH",
+  "names": ["useEffect", "useReducer", "useMemo", "useCallback", "useState", "jsx", "jsxs", "FAQMountableWidget", "container", "config", "runtime", "instanceId", "faqConfig", "questions", "q", "runtime", "FAQMountableWidget", "manifest", "runtime", "globalRegistry", "cdn_default"]
+}

package/dist/apps/gamification/index.js

@@ -0,0 +1,2 @@
+var c=async(e,t)=>{let{badgeId:i}=e;return t.publishEvent("gamification.badge_awarded",{badgeId:i,awardedAt:Date.now()}),{cleanup:()=>{}}},d=async(e,t)=>{let{points:i,reason:s}=e;return t.publishEvent("gamification.points_added",{points:i,reason:s,timestamp:Date.now()}),{cleanup:()=>{}}},g={names:["page_view","button_click"],handler:(e,t)=>{console.log("[Gamification] Event received for badge trigger check")}},o=[{kind:"gamification:awardBadge",executor:c},{kind:"gamification:addPoints",executor:d}],a=[g],n={id:"adaptive-gamification",version:"1.0.0",name:"Gamification",description:"Badges, rewards, points, and engagement mechanics",executors:o,eventHandlers:a};var r={id:"gamification",version:n.version,name:n.name,description:n.description,runtime:{actions:o.map(({kind:e,executor:t})=>({kind:e,executor:t})),events:a},metadata:{isBuiltIn:!1}};if(typeof window<"u"){let e=window.__SYNOS_APP_REGISTRY__;e&&typeof e.register=="function"&&e.register(r)}var p=r;export{p as default,r as manifest};
+//# sourceMappingURL=index.js.map

package/dist/apps/gamification/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../adaptives/adaptive-gamification/src/runtime.ts", "../../../../adaptives/adaptive-gamification/src/cdn.ts"],
+  "sourcesContent": ["/**\n * Adaptive Gamification - Runtime Module\n *\n * Gamification actions: awardBadge, addPoints.\n * Provides gamification features like badges, points, and rewards.\n */\n\nimport type {\n  ExecutorResult,\n  ExecutorContext,\n  ActionExecutor,\n} from \"./types\";\n\n// ============================================================================\n// Action Types\n// ============================================================================\n\n/**\n * Award badge action\n */\nexport interface AwardBadgeAction {\n  kind: \"gamification:awardBadge\";\n  badgeId: string;\n  anchorId?: string;\n  label?: string;\n}\n\n/**\n * Add points action\n */\nexport interface AddPointsAction {\n  kind: \"gamification:addPoints\";\n  points: number;\n  reason?: string;\n  label?: string;\n}\n\n// ============================================================================\n// Executors\n// ============================================================================\n\n/**\n * Execute an awardBadge action\n *\n * Note: This executor uses publishEvent to track badge awards.\n * State management is handled at the app level via AppContext,\n * not at the action executor level.\n */\nexport const executeAwardBadge: ActionExecutor<AwardBadgeAction> = async (\n  action,\n  context\n): Promise<ExecutorResult> => {\n  const { badgeId } = action;\n\n  // Emit telemetry event (state management handled at app level)\n  context.publishEvent(\"gamification.badge_awarded\", {\n    badgeId,\n    awardedAt: Date.now(),\n  });\n\n  return {\n    cleanup: () => {\n      // Badge awards are permanent, no cleanup needed\n    },\n  };\n};\n\n/**\n * Execute an addPoints action\n *\n * Note: This executor uses publishEvent to track points.\n * State management is handled at the app level via AppContext,\n * not at the action executor level.\n */\nexport const executeAddPoints: ActionExecutor<AddPointsAction> = async (\n  action,\n  context\n): Promise<ExecutorResult> => {\n  const { points, reason } = action;\n\n  // Emit telemetry event (state management handled at app level)\n  context.publishEvent(\"gamification.points_added\", {\n    points,\n    reason,\n    timestamp: Date.now(),\n  });\n\n  return {\n    cleanup: () => {\n      // Points are permanent, no cleanup needed\n    },\n  };\n};\n\n// ============================================================================\n// Event Handlers\n// ============================================================================\n\n/**\n * Event handler for auto-awarding badges based on triggers.\n */\nexport const badgeTriggerHandler = {\n  names: [\"page_view\", \"button_click\"],\n  handler: (event: unknown, ctx: unknown) => {\n    // Auto-award badges based on event triggers\n    // This would check badge trigger conditions in the config\n    console.log(\"[Gamification] Event received for badge trigger check\");\n  },\n};\n\n// ============================================================================\n// Executor Definitions for Registration\n// ============================================================================\n\n/**\n * All executors provided by this app.\n * These are registered with the runtime's ExecutorRegistry.\n */\nexport const executors = [\n  { kind: \"gamification:awardBadge\", executor: executeAwardBadge },\n  { kind: \"gamification:addPoints\", executor: executeAddPoints },\n] as const;\n\n/**\n * Event handlers provided by this app.\n */\nexport const eventHandlers = [badgeTriggerHandler];\n\n/**\n * App runtime manifest.\n */\nexport const runtime = {\n  id: \"adaptive-gamification\",\n  version: \"1.0.0\",\n  name: \"Gamification\",\n  description: \"Badges, rewards, points, and engagement mechanics\",\n  executors,\n  eventHandlers,\n};\n", "/**\n * CDN Entry Point for Adaptive Gamification\n *\n * This module is bundled for CDN delivery and self-registers with the global\n * SynOS app registry when loaded dynamically via the AppLoader.\n */\n\nimport { executors, eventHandlers, runtime } from \"./runtime\";\n\n/**\n * App manifest for registry registration.\n * Follows the AppManifest interface expected by AppLoader/AppRegistry.\n */\nexport const manifest = {\n  id: \"gamification\",\n  version: runtime.version,\n  name: runtime.name,\n  description: runtime.description,\n  runtime: {\n    actions: executors.map(({ kind, executor }) => ({\n      kind,\n      executor,\n    })),\n    events: eventHandlers,\n  },\n  metadata: {\n    isBuiltIn: false,\n  },\n};\n\n/**\n * Self-register with global registry if available.\n * This happens when loaded via script tag (UMD).\n */\nif (typeof window !== \"undefined\") {\n  const globalRegistry = (window as any).__SYNOS_APP_REGISTRY__;\n  if (globalRegistry && typeof globalRegistry.register === \"function\") {\n    globalRegistry.register(manifest);\n  }\n}\n\nexport default manifest;\n"],
+  "mappings": "AAgDO,IAAMA,EAAsD,MACjEC,EACAC,IAC4B,CAC5B,GAAM,CAAE,QAAAC,CAAQ,EAAIF,EAGpB,OAAAC,EAAQ,aAAa,6BAA8B,CACjD,QAAAC,EACA,UAAW,KAAK,IAAI,CACtB,CAAC,EAEM,CACL,QAAS,IAAM,CAEf,CACF,CACF,EASaC,EAAoD,MAC/DH,EACAC,IAC4B,CAC5B,GAAM,CAAE,OAAAG,EAAQ,OAAAC,CAAO,EAAIL,EAG3B,OAAAC,EAAQ,aAAa,4BAA6B,CAChD,OAAAG,EACA,OAAAC,EACA,UAAW,KAAK,IAAI,CACtB,CAAC,EAEM,CACL,QAAS,IAAM,CAEf,CACF,CACF,EASaC,EAAsB,CACjC,MAAO,CAAC,YAAa,cAAc,EACnC,QAAS,CAACC,EAAgBC,IAAiB,CAGzC,QAAQ,IAAI,uDAAuD,CACrE,CACF,EAUaC,EAAY,CACvB,CAAE,KAAM,0BAA2B,SAAUV,CAAkB,EAC/D,CAAE,KAAM,yBAA0B,SAAUI,CAAiB,CAC/D,EAKaO,EAAgB,CAACJ,CAAmB,EAKpCK,EAAU,CACrB,GAAI,wBACJ,QAAS,QACT,KAAM,eACN,YAAa,oDACb,UAAAF,EACA,cAAAC,CACF,EC7HO,IAAME,EAAW,CACtB,GAAI,eACJ,QAASC,EAAQ,QACjB,KAAMA,EAAQ,KACd,YAAaA,EAAQ,YACrB,QAAS,CACP,QAASC,EAAU,IAAI,CAAC,CAAE,KAAAC,EAAM,SAAAC,CAAS,KAAO,CAC9C,KAAAD,EACA,SAAAC,CACF,EAAE,EACF,OAAQC,CACV,EACA,SAAU,CACR,UAAW,EACb,CACF,EAMA,GAAI,OAAO,OAAW,IAAa,CACjC,IAAMC,EAAkB,OAAe,uBACnCA,GAAkB,OAAOA,EAAe,UAAa,YACvDA,EAAe,SAASN,CAAQ,CAEpC,CAEA,IAAOO,EAAQP",
+  "names": ["executeAwardBadge", "action", "context", "badgeId", "executeAddPoints", "points", "reason", "badgeTriggerHandler", "event", "ctx", "executors", "eventHandlers", "runtime", "manifest", "runtime", "executors", "kind", "executor", "eventHandlers", "globalRegistry", "cdn_default"]
+}

package/dist/apps/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Apps Module
+ *
+ * SynOS app system for extensible runtime and editor modules.
+ */
+export { AppRegistry, appRegistry } from "./AppRegistry";
+export type { AppRegistryEventCallback } from "./AppRegistry";
+export { createAppContext, cleanupAppContext } from "./AppContext";
+export type { CreateAppContextOptions } from "./AppContext";
+export { createAppLoader, isCoreActionKind, getAppIdFromActionKind, getAppIdFromWidgetId, } from "./AppLoader";
+export type { AppLoader, AppLoaderOptions, AppLoadResult, CanvasConfigForLoader, } from "./AppLoader";
+export { runtime as contentRuntime } from "@syntrologie/app-content/runtime";
+export { runtime as overlaysRuntime } from "@syntrologie/app-overlays/runtime";
+export { runtime as navigationRuntime } from "@syntrologie/app-navigation/runtime";
+export type { AppManifest, AppRegistration, AppLifecycleState, AppContext, AppRuntimeExtensions, AppActionDefinition, AppWidgetDefinition, AppEventHandler, AppEventContext, EditorPanelProps, EditorPanelConfig, AppEditorModule, AppRegistryEvent, } from "./types";

package/dist/apps/index.js

@@ -0,0 +1,17 @@
+/**
+ * Apps Module
+ *
+ * SynOS app system for extensible runtime and editor modules.
+ */
+// App Registry
+export { AppRegistry, appRegistry } from "./AppRegistry";
+// App Context
+export { createAppContext, cleanupAppContext } from "./AppContext";
+// App Loader
+export { createAppLoader, isCoreActionKind, getAppIdFromActionKind, getAppIdFromWidgetId, } from "./AppLoader";
+// Core app runtime modules (bundled with runtime SDK)
+// These executors are available immediately without CDN loading.
+export { runtime as contentRuntime } from "@syntrologie/app-content/runtime";
+export { runtime as overlaysRuntime } from "@syntrologie/app-overlays/runtime";
+export { runtime as navigationRuntime } from "@syntrologie/app-navigation/runtime";
+//# sourceMappingURL=index.js.map

package/dist/apps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/apps/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGzD,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,aAAa;AACb,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAQrB,sDAAsD;AACtD,iEAAiE;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/apps/nav/index.js

@@ -0,0 +1,11 @@
+import p,{useEffect as f,useReducer as u,useMemo as v,useCallback as g}from"react";import{jsx as k,jsxs as b}from"react/jsx-runtime";var o={mount(e,i){let{runtime:r,instanceId:c="nav-widget",...s}=i||{layout:"horizontal",theme:"auto",actions:[]};if(!r){let l=s.actions||[];e.innerHTML=`
+        <nav style="display: flex; gap: 8px; padding: 8px; font-family: system-ui;">
+          ${l.map(t=>`
+            <a href="${t.config.href}" style="padding: 8px 12px; text-decoration: none; color: #374151;">
+              ${t.config.icon?`<span>${t.config.icon}</span>`:""}
+              ${t.config.label}
+            </a>
+          `).join("")}
+        </nav>
+      `}return()=>{e.innerHTML=""}}};var n={id:"adaptive-nav",version:"1.0.0",name:"Navigation Links",description:"Widget-based navigation link list with per-item conditional visibility",executors:[],widgets:[{id:"adaptive-nav:links",component:o,metadata:{name:"Navigation Links",description:"Horizontal or vertical navigation link list",icon:"\u{1F517}"}}]};var a={id:"nav",version:n.version,name:n.name,description:n.description,runtime:{actions:[],widgets:n.widgets},metadata:{isBuiltIn:!1}};if(typeof window<"u"){let e=window.__SYNOS_APP_REGISTRY__;e&&typeof e.register=="function"&&e.register(a)}var N=a;export{N as default,a as manifest};
+//# sourceMappingURL=index.js.map

package/dist/apps/nav/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../adaptives/adaptive-nav/src/NavWidget.tsx", "../../../../adaptives/adaptive-nav/src/runtime.ts", "../../../../adaptives/adaptive-nav/src/cdn.ts"],
+  "sourcesContent": ["/**\n * Adaptive Nav - NavWidget Component\n *\n * React component that renders a navigation link list with per-item\n * conditional visibility based on showWhen decision strategies.\n *\n * Demonstrates the compositional action pattern where child actions\n * (nav:link) serve as configuration data for the parent widget.\n */\n\nimport React, { useEffect, useReducer, useMemo, useCallback } from \"react\";\nimport type { NavWidgetProps, NavLinkAction, NavConfig, NavWidgetRuntime } from \"./types\";\n\n// ============================================================================\n// Styles\n// ============================================================================\n\nconst baseStyles = {\n  nav: {\n    display: \"flex\",\n    gap: \"4px\",\n    padding: \"8px\",\n    fontFamily: \"system-ui, -apple-system, sans-serif\",\n  },\n  link: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"6px\",\n    padding: \"8px 12px\",\n    borderRadius: \"6px\",\n    textDecoration: \"none\",\n    fontSize: \"14px\",\n    fontWeight: 500,\n    transition: \"background-color 0.15s ease, color 0.15s ease\",\n    cursor: \"pointer\",\n    border: \"none\",\n    background: \"transparent\",\n  },\n  icon: {\n    fontSize: \"16px\",\n  },\n  externalIcon: {\n    fontSize: \"12px\",\n    opacity: 0.6,\n  },\n} as const;\n\nconst themeStyles = {\n  light: {\n    nav: {\n      backgroundColor: \"#ffffff\",\n    },\n    link: {\n      color: \"#374151\",\n    },\n    linkHover: {\n      backgroundColor: \"#f3f4f6\",\n      color: \"#111827\",\n    },\n  },\n  dark: {\n    nav: {\n      backgroundColor: \"#1f2937\",\n    },\n    link: {\n      color: \"#d1d5db\",\n    },\n    linkHover: {\n      backgroundColor: \"#374151\",\n      color: \"#f9fafb\",\n    },\n  },\n} as const;\n\n// ============================================================================\n// NavLink Component\n// ============================================================================\n\ninterface NavLinkComponentProps {\n  link: NavLinkAction;\n  theme: \"light\" | \"dark\";\n  onNavigate: (href: string, external: boolean) => void;\n}\n\nfunction NavLinkComponent({ link, theme, onNavigate }: NavLinkComponentProps) {\n  const [isHovered, setIsHovered] = React.useState(false);\n  const { label, href, icon, external } = link.config;\n  const colors = themeStyles[theme];\n\n  const style: React.CSSProperties = {\n    ...baseStyles.link,\n    ...colors.link,\n    ...(isHovered ? colors.linkHover : {}),\n  };\n\n  const handleClick = (e: React.MouseEvent) => {\n    e.preventDefault();\n    onNavigate(href, external ?? false);\n  };\n\n  return (\n    <a\n      href={href}\n      onClick={handleClick}\n      style={style}\n      onMouseEnter={() => setIsHovered(true)}\n      onMouseLeave={() => setIsHovered(false)}\n      target={external ? \"_blank\" : undefined}\n      rel={external ? \"noopener noreferrer\" : undefined}\n    >\n      {icon && <span style={baseStyles.icon}>{icon}</span>}\n      <span>{label}</span>\n      {external && <span style={baseStyles.externalIcon}>\u2197</span>}\n    </a>\n  );\n}\n\n// ============================================================================\n// NavWidget Component\n// ============================================================================\n\n/**\n * NavWidget - Renders a navigation link list with per-item activation.\n *\n * This component demonstrates the compositional action pattern:\n * - Parent (NavWidget) receives `config.actions` array\n * - Each action has optional `showWhen` for per-item visibility\n * - Parent evaluates showWhen and filters visible links\n * - Parent manages re-rendering on context changes\n */\nexport function NavWidget({ config, runtime, instanceId }: NavWidgetProps) {\n  // Force re-render when context changes\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n\n  // Subscribe to context changes for reactive updates\n  useEffect(() => {\n    const unsubscribe = runtime.context.subscribe(() => {\n      forceUpdate();\n    });\n    return unsubscribe;\n  }, [runtime.context]);\n\n  // Filter visible links based on per-item showWhen\n  const visibleLinks = useMemo(() => {\n    return config.actions.filter((link) => {\n      // No showWhen = always visible\n      if (!link.showWhen) return true;\n\n      // Evaluate the decision strategy\n      const result = runtime.evaluateSync<boolean>(link.showWhen);\n      return result.value;\n    });\n  }, [config.actions, runtime]);\n\n  // Resolve theme (auto \u2192 detect system preference)\n  const resolvedTheme = useMemo(() => {\n    if (config.theme !== \"auto\") return config.theme;\n\n    // Check system preference (SSR-safe)\n    if (typeof window !== \"undefined\") {\n      return window.matchMedia?.(\"(prefers-color-scheme: dark)\").matches\n        ? \"dark\"\n        : \"light\";\n    }\n    return \"light\";\n  }, [config.theme]);\n\n  // Handle navigation with event publishing\n  const handleNavigate = useCallback(\n    (href: string, external: boolean) => {\n      // Publish navigation event for analytics\n      runtime.events.publish(\"nav:click\", {\n        instanceId,\n        href,\n        external,\n        timestamp: Date.now(),\n      });\n\n      // Perform navigation\n      if (external) {\n        window.open(href, \"_blank\", \"noopener,noreferrer\");\n      } else {\n        window.location.href = href;\n      }\n    },\n    [runtime.events, instanceId]\n  );\n\n  // Compute nav styles\n  const navStyle: React.CSSProperties = {\n    ...baseStyles.nav,\n    ...themeStyles[resolvedTheme].nav,\n    flexDirection: config.layout === \"vertical\" ? \"column\" : \"row\",\n  };\n\n  // Empty state\n  if (visibleLinks.length === 0) {\n    return null;\n  }\n\n  return (\n    <nav style={navStyle} data-adaptive-id={instanceId} data-adaptive-type=\"adaptive-nav\">\n      {visibleLinks.map((link, index) => (\n        <NavLinkComponent\n          key={link.config.href + index}\n          link={link}\n          theme={resolvedTheme}\n          onNavigate={handleNavigate}\n        />\n      ))}\n    </nav>\n  );\n}\n\n// ============================================================================\n// Mountable Widget Interface\n// ============================================================================\n\n/**\n * Mountable widget interface for the runtime's WidgetRegistry.\n */\nexport const NavMountableWidget = {\n  mount(\n    container: HTMLElement,\n    config?: NavConfig & { runtime?: NavWidgetRuntime; instanceId?: string }\n  ) {\n    // This is a simplified mount for non-React environments\n    // In practice, the runtime handles React rendering\n\n    const { runtime, instanceId = \"nav-widget\", ...navConfig } = config || {\n      layout: \"horizontal\" as const,\n      theme: \"auto\" as const,\n      actions: [],\n    };\n\n    // Create simple HTML fallback if no runtime\n    if (!runtime) {\n      const links = navConfig.actions || [];\n      container.innerHTML = `\n        <nav style=\"display: flex; gap: 8px; padding: 8px; font-family: system-ui;\">\n          ${links\n            .map(\n              (link) => `\n            <a href=\"${link.config.href}\" style=\"padding: 8px 12px; text-decoration: none; color: #374151;\">\n              ${link.config.icon ? `<span>${link.config.icon}</span>` : \"\"}\n              ${link.config.label}\n            </a>\n          `\n            )\n            .join(\"\")}\n        </nav>\n      `;\n    }\n\n    return () => {\n      container.innerHTML = \"\";\n    };\n  },\n};\n\nexport default NavWidget;\n", "/**\n * Adaptive Nav - Runtime Module\n *\n * Runtime manifest for the navigation link list adaptive.\n * This is a widget-based adaptive with no action executors.\n */\n\nimport { NavMountableWidget } from \"./NavWidget\";\n\n// ============================================================================\n// App Runtime Manifest\n// ============================================================================\n\n/**\n * Runtime manifest for adaptive-nav.\n *\n * Note: This adaptive is widget-based, not action-based.\n * The `nav:link` actions are compositional - they're rendered by\n * the widget, not executed by the runtime.\n */\nexport const runtime = {\n  id: \"adaptive-nav\",\n  version: \"1.0.0\",\n  name: \"Navigation Links\",\n  description: \"Widget-based navigation link list with per-item conditional visibility\",\n\n  /**\n   * No action executors - nav:link actions are compositional,\n   * meaning they serve as configuration for the NavWidget.\n   */\n  executors: [],\n\n  /**\n   * Widget definitions for the runtime's WidgetRegistry.\n   */\n  widgets: [\n    {\n      id: \"adaptive-nav:links\",\n      component: NavMountableWidget,\n      metadata: {\n        name: \"Navigation Links\",\n        description: \"Horizontal or vertical navigation link list\",\n        icon: \"\uD83D\uDD17\",\n      },\n    },\n  ],\n};\n\nexport default runtime;\n", "/**\n * CDN Entry Point for Adaptive Nav\n *\n * This module is bundled for CDN delivery and self-registers with the global\n * SynOS app registry when loaded dynamically via the AppLoader.\n */\n\nimport { runtime } from \"./runtime\";\n\n/**\n * App manifest for registry registration.\n * Follows the AppManifest interface expected by AppLoader/AppRegistry.\n */\nexport const manifest = {\n  id: \"nav\",\n  version: runtime.version,\n  name: runtime.name,\n  description: runtime.description,\n  runtime: {\n    // Nav is widget-based, no action executors\n    actions: [],\n    widgets: runtime.widgets,\n  },\n  metadata: {\n    isBuiltIn: false,\n  },\n};\n\n/**\n * Self-register with global registry if available.\n * This happens when loaded via script tag (UMD).\n */\nif (typeof window !== \"undefined\") {\n  const globalRegistry = (window as any).__SYNOS_APP_REGISTRY__;\n  if (globalRegistry && typeof globalRegistry.register === \"function\") {\n    globalRegistry.register(manifest);\n  }\n}\n\nexport default manifest;\n"],
+  "mappings": "AAUA,OAAOA,GAAS,aAAAC,EAAW,cAAAC,EAAY,WAAAC,EAAS,eAAAC,MAAmB,QA2F/D,OASW,OAAAC,EATX,QAAAC,MAAA,oBAwHG,IAAMC,EAAqB,CAChC,MACEC,EACAC,EACA,CAIA,GAAM,CAAE,QAAAC,EAAS,WAAAC,EAAa,aAAc,GAAGC,CAAU,EAAIH,GAAU,CACrE,OAAQ,aACR,MAAO,OACP,QAAS,CAAC,CACZ,EAGA,GAAI,CAACC,EAAS,CACZ,IAAMG,EAAQD,EAAU,SAAW,CAAC,EACpCJ,EAAU,UAAY;AAAA;AAAA,YAEhBK,EACC,IACEC,GAAS;AAAA,uBACDA,EAAK,OAAO,IAAI;AAAA,gBACvBA,EAAK,OAAO,KAAO,SAASA,EAAK,OAAO,IAAI,UAAY,EAAE;AAAA,gBAC1DA,EAAK,OAAO,KAAK;AAAA;AAAA,WAGrB,EACC,KAAK,EAAE,CAAC;AAAA;AAAA,OAGjB,CAEA,MAAO,IAAM,CACXN,EAAU,UAAY,EACxB,CACF,CACF,EC9OO,IAAMO,EAAU,CACrB,GAAI,eACJ,QAAS,QACT,KAAM,mBACN,YAAa,yEAMb,UAAW,CAAC,EAKZ,QAAS,CACP,CACE,GAAI,qBACJ,UAAWC,EACX,SAAU,CACR,KAAM,mBACN,YAAa,8CACb,KAAM,WACR,CACF,CACF,CACF,ECjCO,IAAMC,EAAW,CACtB,GAAI,MACJ,QAASC,EAAQ,QACjB,KAAMA,EAAQ,KACd,YAAaA,EAAQ,YACrB,QAAS,CAEP,QAAS,CAAC,EACV,QAASA,EAAQ,OACnB,EACA,SAAU,CACR,UAAW,EACb,CACF,EAMA,GAAI,OAAO,OAAW,IAAa,CACjC,IAAMC,EAAkB,OAAe,uBACnCA,GAAkB,OAAOA,EAAe,UAAa,YACvDA,EAAe,SAASF,CAAQ,CAEpC,CAEA,IAAOG,EAAQH",
+  "names": ["React", "useEffect", "useReducer", "useMemo", "useCallback", "jsx", "jsxs", "NavMountableWidget", "container", "config", "runtime", "instanceId", "navConfig", "links", "link", "runtime", "NavMountableWidget", "manifest", "runtime", "globalRegistry", "cdn_default"]
+}

package/dist/apps/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * App Types
+ *
+ * Defines the types for the SynOS app system.
+ * Apps provide runtime extensions (actions, widgets, events) and editor modules.
+ */
+import type { ZodSchema } from "zod";
+import type { ActionExecutor } from "../actions/types";
+import type { MountableWidget } from "../widgets/WidgetRegistry";
+import type { NormalizedEvent } from "../events/types";
+/**
+ * Action definition provided by an app.
+ */
+export interface AppActionDefinition {
+    /** Action kind (e.g., "gamification:awardBadge") */
+    kind: string;
+    /** Zod schema for validation */
+    schema?: ZodSchema;
+    /** Executor function */
+    executor: ActionExecutor<any>;
+}
+/**
+ * Widget definition provided by an app.
+ */
+export interface AppWidgetDefinition {
+    /** Widget ID (e.g., "gamification:leaderboard") */
+    id: string;
+    /** The widget component */
+    component: MountableWidget;
+    /** Optional metadata */
+    metadata?: {
+        name?: string;
+        description?: string;
+        icon?: string;
+    };
+}
+/**
+ * Context passed to app event handlers.
+ */
+export interface AppEventContext {
+    /** The app ID */
+    appId: string;
+    /** Access to state store */
+    state: {
+        get: (key: string) => unknown;
+        set: (key: string, value: unknown) => void;
+    };
+    /** Emit telemetry events */
+    telemetry?: {
+        emit: (eventName: string, props?: Record<string, unknown>) => void;
+    };
+    /** Access to surfaces */
+    surfaces?: {
+        mount: (slot: string, content: unknown, opts?: unknown) => {
+            unmount: () => void;
+        };
+    };
+}
+/**
+ * Event handler definition provided by an app.
+ */
+export interface AppEventHandler {
+    /** Event names to listen for */
+    names: string[];
+    /** Handler function */
+    handler: (event: NormalizedEvent, ctx: AppEventContext) => void | Promise<void>;
+}
+/**
+ * Runtime extensions provided by an app.
+ */
+export interface AppRuntimeExtensions {
+    /** Custom action kinds */
+    actions?: AppActionDefinition[];
+    /** Widget components */
+    widgets?: AppWidgetDefinition[];
+    /** Event handlers */
+    events?: AppEventHandler[];
+}
+/**
+ * Props passed to editor panel components.
+ */
+export interface EditorPanelProps {
+    /** The current config for this app's portion */
+    config: Record<string, unknown>;
+    /** Callback when config changes */
+    onChange: (config: Record<string, unknown>) => void;
+    /** Editor utilities */
+    editor: {
+        /** Mark the editor as dirty (has unsaved changes) */
+        setDirty: (dirty: boolean) => void;
+        /** Navigate back to home */
+        navigateHome: () => Promise<boolean>;
+        /** Save the current config */
+        save: () => Promise<void>;
+        /** Publish the current config */
+        publish: (captureScreenshot?: boolean) => Promise<void>;
+    };
+    /** Platform client for API calls (optional) */
+    platformClient?: unknown;
+}
+/**
+ * Editor panel configuration.
+ */
+export interface EditorPanelConfig {
+    /** Panel title */
+    title: string;
+    /** Panel icon (emoji or icon key) */
+    icon: string;
+    /** Panel description */
+    description: string;
+}
+/**
+ * Editor module provided by an app.
+ */
+export interface AppEditorModule {
+    /** React component for the editor panel */
+    component: React.ComponentType<EditorPanelProps>;
+    /** Panel configuration */
+    panel: EditorPanelConfig;
+}
+/**
+ * App manifest - the complete definition of a SynOS app.
+ */
+export interface AppManifest {
+    /** Unique app identifier (e.g., "adaptive-gamification") */
+    id: string;
+    /** App version (semver) */
+    version: string;
+    /** Human-readable app name */
+    name: string;
+    /** App description */
+    description?: string;
+    /** Runtime extensions */
+    runtime?: AppRuntimeExtensions;
+    /** Zod schema for this app's config portion */
+    configSchema?: ZodSchema;
+    /** Editor module (optional - apps without editors are runtime-only) */
+    editor?: AppEditorModule;
+    /** App dependencies (other app IDs that must be loaded first) */
+    dependencies?: string[];
+    /** App metadata */
+    metadata?: {
+        /** Author name or organization */
+        author?: string;
+        /** Homepage URL */
+        homepage?: string;
+        /** License identifier */
+        license?: string;
+        /** Tags for categorization */
+        tags?: string[];
+        /** Whether this is a built-in app (bundled with runtime) */
+        isBuiltIn?: boolean;
+    };
+}
+/**
+ * App lifecycle state.
+ */
+export type AppLifecycleState = "registered" | "activating" | "active" | "deactivating" | "inactive" | "error";
+/**
+ * App registration - tracked state for a registered app.
+ */
+export interface AppRegistration {
+    /** The app manifest */
+    manifest: AppManifest;
+    /** Current lifecycle state */
+    state: AppLifecycleState;
+    /** When the app was registered */
+    registeredAt: number;
+    /** When the app was last activated */
+    activatedAt?: number;
+    /** Error message if state is "error" */
+    error?: string;
+    /** Cleanup function to deactivate the app */
+    cleanup?: () => void | Promise<void>;
+}
+/**
+ * Sandboxed runtime context provided to apps.
+ */
+export interface AppContext {
+    /** The app ID */
+    appId: string;
+    /** State store (scoped to app namespace) */
+    state: {
+        get: (key: string) => unknown;
+        set: (key: string, value: unknown) => void;
+        remove: (key: string) => void;
+    };
+    /** Telemetry (if available) */
+    telemetry?: {
+        emit: (eventName: string, props?: Record<string, unknown>) => void;
+        getSessionId: () => string | undefined;
+    };
+    /** Surfaces access */
+    surfaces: {
+        mount: (slot: string, content: unknown, opts?: unknown) => {
+            unmount: () => void;
+            update: (content: unknown) => void;
+        };
+        canMount: (slot: string, priority?: number) => boolean;
+    };
+    /** Event subscription */
+    events: {
+        subscribe: (callback: (event: NormalizedEvent) => void) => () => void;
+        publish: (name: string, props?: Record<string, unknown>) => void;
+    };
+    /** Register app-provided actions */
+    registerAction: (definition: AppActionDefinition) => void;
+    /** Register app-provided widgets */
+    registerWidget: (definition: AppWidgetDefinition) => void;
+}
+/**
+ * Events emitted by the app registry.
+ */
+export type AppRegistryEvent = {
+    type: "app:registered";
+    appId: string;
+    manifest: AppManifest;
+} | {
+    type: "app:activated";
+    appId: string;
+} | {
+    type: "app:deactivated";
+    appId: string;
+} | {
+    type: "app:error";
+    appId: string;
+    error: string;
+} | {
+    type: "app:unregistered";
+    appId: string;
+};

package/dist/apps/types.js

@@ -0,0 +1,8 @@
+/**
+ * App Types
+ *
+ * Defines the types for the SynOS app system.
+ * Apps provide runtime extensions (actions, widgets, events) and editor modules.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/apps/types.js.map

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

package/dist/bootstrap.d.ts

@@ -20,6 +20,8 @@ import { decodeToken, encodeToken } from "./token";
 import { SmartCanvasConfig, SmartCanvasHandle } from "./api";
 import { SessionMetricTracker } from "./metrics";
 import { SmartCanvasRuntime } from "./runtime";
+import { appRegistry } from "./apps";
+import { type AppLoader } from "./apps/AppLoader";
 import type { ExperimentClient } from "./experiments/types";
 import type { TelemetryClient } from "./telemetry/types";
 import type { CanvasConfigFetcher } from "./types";
@@ -51,6 +53,18 @@ export interface SyntroInitOptions {
      * @default false
      */
     enableSessionMetrics?: boolean;
+    /**
+     * CDN base URL for loading external SynOS apps.
+     * Apps are loaded from: {cdnBase}/apps/{appId}/index.js
+     *
+     * @default "https://cdn.syntro.io"
+     */
+    cdnBase?: string;
+    /**
+     * @deprecated Core app executors are now registered synchronously.
+     * This option has no effect and will be removed in a future version.
+     */
+    registerBuiltInApps?: boolean;
 }
 export interface SyntroInitResult {
     /**
@@ -77,6 +91,11 @@ export interface SyntroInitResult {
      * @deprecated Access via runtime.sessionMetrics instead
      */
     sessionMetrics?: SessionMetricTracker;
+    /**
+     * App loader for loading external apps from CDN.
+     * Exposed for manual app loading if needed.
+     */
+    appLoader: AppLoader;
 }
 /**
  * Initialize the Syntro SDK with a single token.
@@ -103,6 +122,11 @@ export declare const Syntro: {
 declare global {
     interface Window {
         Syntro?: typeof Syntro;
+        SynOS?: {
+            appRegistry: typeof appRegistry;
+            runtime: SmartCanvasRuntime;
+            version: string;
+        };
     }
 }
 export {};