@pablo2410/shared-ui 0.26.0 → 0.27.1

package/dist/{HealthFooter-BpByxJkc.d.ts → HealthFooter-Cepg3mRC.d.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode, CSSProperties } from 'react';
-import { C as CrossServiceLink } from './crossNav-Bz0RXU_F.js';
+import { C as CrossServiceLink } from './crossNav-DBX4Eyx7.js';
 
 /**
  * SharedSidebar — Config-driven sidebar component for all Oplytics subdomains.

package/dist/{chunk-MGTOQY6O.js → chunk-45ZQDLPA.js}

@@ -15,7 +15,6 @@ var SERVICE_CATALOG = [
     description: "Hoshin Kanri and X-matrix planning. Cascade strategic objectives through every level of your organisation with live tracking and bowling charts.",
     icon: "Target",
     accentColor: "#F59E0B",
-    status: "live",
     category: "core",
     subdomainLabel: "policy",
     onboarding: {
@@ -50,7 +49,6 @@ var SERVICE_CATALOG = [
     description: "Digital SQDCP boards that drive daily accountability. Safety, Quality, Delivery, Cost, and People metrics at a glance for every team.",
     icon: "LayoutGrid",
     accentColor: "#1DB8CE",
-    status: "live",
     category: "core",
     subdomainLabel: "sqdcp",
     onboarding: {
@@ -58,7 +56,6 @@ var SERVICE_CATALOG = [
       highlights: [
         "Rooms \u2014 one per team, tiered (Team Huddle \u2192 Area/Plant Review \u2192 Monthly Review), each feeding the one above.",
         "Data Entry \u2014 where actuals get logged against each pillar's metrics.",
-        "Safety Manager / Quality Manager tabs \u2014 the deeper pillar-specific views inside SQDCP.",
         "If AI Facilitator is on, Opi runs the huddle itself \u2014 drafts the line for each red pillar, opens the action review by name."
       ],
       features: [
@@ -69,10 +66,6 @@ var SERVICE_CATALOG = [
         {
           name: "Data Entry",
           detail: "Where actuals get logged against each pillar's metrics \u2014 this is the one habit that makes everything else here true; skip it and the board just goes stale, not red."
-        },
-        {
-          name: "Safety & Quality Manager",
-          detail: "The deeper pillar-specific views inside SQDCP \u2014 ISO-aligned gap analysis for Safety and Quality, one level below the daily board for when a red needs more than a glance."
         }
       ],
       firstAction: { label: "Open Rooms", path: "/" },
@@ -86,7 +79,6 @@ var SERVICE_CATALOG = [
     description: "Monitor Overall Equipment Effectiveness in real-time. Track availability, performance, and quality metrics across your entire production line.",
     icon: "Gauge",
     accentColor: "#8C34E9",
-    status: "live",
     category: "core",
     subdomainLabel: "oeemanager"
     // No `onboarding` block yet — held back for a later cohort (2026-09-11 decision).
@@ -98,7 +90,6 @@ var SERVICE_CATALOG = [
     description: "Capture, assign, and track corrective and preventive actions from any source. Ensure nothing falls through the cracks.",
     icon: "ClipboardCheck",
     accentColor: "#22C55E",
-    status: "live",
     category: "core",
     subdomainLabel: "actionmanager",
     onboarding: {
@@ -125,62 +116,11 @@ var SERVICE_CATALOG = [
       firstAction: { label: "Open Board", path: "/board" },
       emptyStateHint: "Zero actions yet \u2014 say this is normal on day one, actions will start showing up as SQDCP and Policy Deployment generate them, rather than describing an empty board as broken."
     }
-  },
-  {
-    slug: "connect",
-    name: "OplyticsConnect",
-    tagline: "Integrate machines, sensors, and systems",
-    description: "Industrial IoT connectivity layer. Connect PLCs, sensors, and legacy systems to the Oplytics platform with zero-code configuration.",
-    icon: "Plug",
-    accentColor: "#1DB8CE",
-    status: "in-development",
-    category: "core",
-    subdomainLabel: "connect"
-  },
-  // ─── HUB SERVICES ───
-  {
-    slug: "safety-manager",
-    name: "Safety Manager",
-    tagline: "Proactive safety culture, powered by data",
-    description: "Incident reporting, hazard tracking, safety observations, and compliance management in one unified platform.",
-    icon: "Shield",
-    accentColor: "#EF4444",
-    status: "coming-soon",
-    category: "hub",
-    subdomainLabel: "safetymanager"
-  },
-  {
-    slug: "quality-manager",
-    name: "Quality Manager",
-    tagline: "End-to-end quality assurance",
-    description: "Non-conformance tracking, CAPA management, audit scheduling, and quality metrics dashboards.",
-    icon: "CheckCircle",
-    accentColor: "#22C55E",
-    status: "coming-soon",
-    category: "hub",
-    subdomainLabel: null
-  },
-  {
-    slug: "certification-manager",
-    name: "Certification Manager",
-    tagline: "Stay audit-ready, always",
-    description: "Manage ISO, IATF, and other certification requirements. Document control, audit trails, and compliance tracking.",
-    icon: "Award",
-    accentColor: "#F97316",
-    status: "coming-soon",
-    category: "hub",
-    subdomainLabel: null
   }
 ];
 var coreServices = SERVICE_CATALOG.filter((s) => s.category === "core");
 var hubServices = SERVICE_CATALOG.filter((s) => s.category === "hub");
-var liveServices = SERVICE_CATALOG.filter((s) => s.status === "live");
-var inDevServices = SERVICE_CATALOG.filter(
-  (s) => s.status === "in-development"
-);
-var comingSoonServices = SERVICE_CATALOG.filter(
-  (s) => s.status === "coming-soon"
-);
+var liveServices = SERVICE_CATALOG;
 var onboardingTourServices = SERVICE_CATALOG.filter(
   (s) => s.onboarding !== void 0
 );
@@ -211,7 +151,7 @@ function buildCrossServiceLinks(options) {
   const granted = new Set(grantedSlugs.map(normalizeServiceSlug));
   const current = normalizeServiceSlug(currentSlug);
   return SERVICE_CATALOG.filter(
-    (svc) => svc.status === "live" && svc.subdomainLabel !== null && svc.slug !== current && (isAdmin || granted.has(svc.slug))
+    (svc) => svc.subdomainLabel !== null && svc.slug !== current && (isAdmin || granted.has(svc.slug))
   ).map((svc) => ({
     slug: svc.slug,
     name: svc.name,
@@ -226,8 +166,6 @@ export {
   coreServices,
   hubServices,
   liveServices,
-  inDevServices,
-  comingSoonServices,
   onboardingTourServices,
   getServiceBySlug,
   getServiceUrl,
@@ -236,4 +174,4 @@ export {
   normalizeServiceSlug,
   buildCrossServiceLinks
 };
-//# sourceMappingURL=chunk-MGTOQY6O.js.map
+//# sourceMappingURL=chunk-45ZQDLPA.js.map

package/dist/chunk-45ZQDLPA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/catalog.ts","../src/services/crossNav.ts"],"sourcesContent":["/**\n * Shared Service Catalog — Single source of truth for all Oplytics.digital services.\n *\n * Consumed by:\n *   - oplytics-subdomains (ServiceHub.tsx) — service cards, access gating\n *   - oplytics-marketing-site (services.ts) — marketing pages, hero sections\n *\n * Each consumer extends with context-specific fields locally:\n *   - Platform adds: route, external URL, React icon component\n *   - Marketing adds: heroImage, demoImage, problem, howItWorks, results, aiFeatures\n */\n\nimport { platformUrl } from \"./platformDomain\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type ServiceCategory = \"core\" | \"hub\";\n\nexport interface ServiceDefinition {\n  /** Unique identifier used for DB lookups, URL slugs, and cross-referencing */\n  slug: string;\n  /** Display name shown in cards, headers, and navigation */\n  name: string;\n  /** Short one-line value proposition */\n  tagline: string;\n  /** Longer description (1-2 sentences) for cards and summaries */\n  description: string;\n  /** Lucide icon name (string) — consumers resolve to component locally */\n  icon: string;\n  /** Hex accent color for cards, badges, and theming */\n  accentColor: string;\n  /** Core = standalone product, Hub = extension/add-on module */\n  category: ServiceCategory;\n  /**\n   * Subdomain label on the platform domain (e.g. \"sqdcp\") — null if hosted\n   * on portal. Full URLs are built via getServiceUrl(), which resolves the\n   * platform domain at runtime (see ./platformDomain).\n   */\n  subdomainLabel: string | null;\n  /**\n   * Scripted content for the Opi onboarding tour (see @pablo2410/shared-ui/tour).\n   * Optional and deliberately sparse — only services with a real, verified\n   * first-run path should have this filled in. A service with no `onboarding`\n   * block is skipped by the tour entirely rather than shown with placeholder\n   * copy. Marketing/other consumers ignore this field.\n   */\n  onboarding?: ServiceOnboardingContent;\n}\n\nexport interface ServiceOnboardingContent {\n  /** Opi's scripted opening line for this step — the always-available fallback if the live LLM narration call fails or AI is gated off. */\n  hook: string;\n  /** 2-4 short bullets: what's actually here, in plain language. Superseded\n   *  by `features` for display when both are present — kept for back-compat\n   *  and as the fallback shape for any service not yet upgraded. */\n  highlights: string[];\n  /**\n   * Named feature call-outs, richer than a flat bullet — one sentence each\n   * on what it does AND why the user should care, not just what it's\n   * called. Convention (not enforced): aim for 3 per service. Each `name`\n   * doubles as the natural spotlight-target label a later in-app tour\n   * (inside the service's own subdomain, once the tour follows the user\n   * in) can reuse — this is deliberately the same data written once.\n   */\n  features?: ServiceOnboardingFeature[];\n  /** The one thing the step ends on. */\n  firstAction: {\n    label: string;\n    /** Path relative to the service's own root (e.g. \"/xmatrix\"). */\n    path: string;\n  };\n  /** What Opi should say instead when the service has no data yet for this enterprise (empty-state framing), rather than pointing at the normal firstAction. */\n  emptyStateHint?: string;\n}\n\nexport interface ServiceOnboardingFeature {\n  /** Short feature name, e.g. \"X-Matrix\". */\n  name: string;\n  /** One deeper sentence — what it does and why the user should care. */\n  detail: string;\n}\n\n// ---------------------------------------------------------------------------\n// Catalog\n// ---------------------------------------------------------------------------\n\nexport const SERVICE_CATALOG: ServiceDefinition[] = [\n  // ─── CORE SERVICES ───\n  {\n    slug: \"policy-deployment\",\n    name: \"Policy Deployment\",\n    tagline: \"Align strategy to execution\",\n    description:\n      \"Hoshin Kanri and X-matrix planning. Cascade strategic objectives through every level of your organisation with live tracking and bowling charts.\",\n    icon: \"Target\",\n    accentColor: \"#F59E0B\",\n    category: \"core\",\n    subdomainLabel: \"policy\",\n    onboarding: {\n      hook: \"This is where your strategy becomes a plan everyone can see. Long-term goals break into this year's objectives, objectives break into projects, and projects carry the metrics that prove it's working.\",\n      highlights: [\n        \"X-Matrix — the rollup view: goals, objectives, and projects, with dots showing which project moves which goal.\",\n        \"Catchball — where the plan actually gets built: negotiate objectives and projects up and down the org, add a metric to a project.\",\n        \"Actions — every task that comes out of the plan, tracked to closure.\",\n      ],\n      features: [\n        {\n          name: \"X-Matrix\",\n          detail:\n            \"The whole plan at a glance — goals, objectives, and projects on one grid, with dots showing exactly which project moves which goal, so nobody's guessing why a project exists.\",\n        },\n        {\n          name: \"Catchball\",\n          detail:\n            \"Where the plan actually gets negotiated — objectives and projects get pitched up and down the org until everyone agrees, and that's also where a project picks up the metric it'll be measured on.\",\n        },\n        {\n          name: \"Actions\",\n          detail:\n            \"Every task the plan generates, tracked to closure by pillar — so a strategic project never quietly stalls because nobody was assigned the next step.\",\n        },\n      ],\n      firstAction: { label: \"Open X-Matrix\", path: \"/xmatrix\" },\n      emptyStateHint:\n        \"No plan yet for this enterprise — say so plainly and point at Catchball's \\\"Create your first plan\\\" instead of X-Matrix's empty state.\",\n    },\n  },\n  {\n    slug: \"sqdcp\",\n    name: \"SQDCP Dashboard\",\n    tagline: \"Daily management boards, digitised\",\n    description:\n      \"Digital SQDCP boards that drive daily accountability. Safety, Quality, Delivery, Cost, and People metrics at a glance for every team.\",\n    icon: \"LayoutGrid\",\n    accentColor: \"#1DB8CE\",\n    category: \"core\",\n    subdomainLabel: \"sqdcp\",\n    onboarding: {\n      hook: \"This is your daily board — Safety, Quality, Delivery, Cost, People, live. Every team has a room; the huddle happens here, and the numbers you log in Data Entry are what turn the board green or red.\",\n      highlights: [\n        \"Rooms — one per team, tiered (Team Huddle → Area/Plant Review → Monthly Review), each feeding the one above.\",\n        \"Data Entry — where actuals get logged against each pillar's metrics.\",\n        \"If AI Facilitator is on, Opi runs the huddle itself — drafts the line for each red pillar, opens the action review by name.\",\n      ],\n      features: [\n        {\n          name: \"Rooms\",\n          detail:\n            \"One room per team, tiered from Team Huddle up to Area/Plant Review to Monthly Review — each level feeds the one above, so a problem raised on the floor is visible all the way up without anyone re-typing it into a slide deck.\",\n        },\n        {\n          name: \"Data Entry\",\n          detail:\n            \"Where actuals get logged against each pillar's metrics — this is the one habit that makes everything else here true; skip it and the board just goes stale, not red.\",\n        },\n      ],\n      firstAction: { label: \"Open Rooms\", path: \"/\" },\n      emptyStateHint:\n        \"No rooms configured yet — this needs an admin to set up rooms first; point at Admin rather than Rooms.\",\n    },\n  },\n  {\n    slug: \"oee-manager\",\n    name: \"OEE Manager\",\n    tagline: \"Real-time equipment effectiveness tracking\",\n    description:\n      \"Monitor Overall Equipment Effectiveness in real-time. Track availability, performance, and quality metrics across your entire production line.\",\n    icon: \"Gauge\",\n    accentColor: \"#8C34E9\",\n    category: \"core\",\n    subdomainLabel: \"oeemanager\",\n    // No `onboarding` block yet — held back for a later cohort (2026-09-11 decision).\n  },\n  {\n    slug: \"action-manager\",\n    name: \"Action Manager\",\n    tagline: \"Track every action to closure\",\n    description:\n      \"Capture, assign, and track corrective and preventive actions from any source. Ensure nothing falls through the cracks.\",\n    icon: \"ClipboardCheck\",\n    accentColor: \"#22C55E\",\n    category: \"core\",\n    subdomainLabel: \"actionmanager\",\n    onboarding: {\n      hook: \"Every action from every service lands here — SQDCP huddles, Policy Deployment projects, safety reports, all in one place, tracked until someone closes it out.\",\n      highlights: [\n        \"Board — kanban view, the default way most people work actions day to day.\",\n        \"List and Calendar — the same actions, sorted or scheduled instead.\",\n        \"Improvement (A3) — structured 7-box root-cause work for the actions that need more than a quick fix.\",\n      ],\n      features: [\n        {\n          name: \"Board\",\n          detail:\n            \"The default working view — a kanban of every open action, so a team can see what's moving and what's stuck without opening a single report.\",\n        },\n        {\n          name: \"List & Calendar\",\n          detail:\n            \"The same actions, just sorted or scheduled instead of columned — List for triaging a long backlog, Calendar for seeing what's due this week before it becomes overdue.\",\n        },\n        {\n          name: \"Improvement (A3)\",\n          detail:\n            \"Structured 7-box root-cause work for the actions that keep coming back — Background through Follow-up, one page, so a real fix gets the same rigor a quick fix doesn't need.\",\n        },\n      ],\n      firstAction: { label: \"Open Board\", path: \"/board\" },\n      emptyStateHint:\n        \"Zero actions yet — say this is normal on day one, actions will start showing up as SQDCP and Policy Deployment generate them, rather than describing an empty board as broken.\",\n    },\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Derived helpers\n// ---------------------------------------------------------------------------\n\nexport const coreServices = SERVICE_CATALOG.filter(s => s.category === \"core\");\nexport const hubServices = SERVICE_CATALOG.filter(s => s.category === \"hub\");\n/** Every service in the catalog is live: an entry is only added once it ships. */\nexport const liveServices = SERVICE_CATALOG;\n/** Services with a scripted onboarding tour step, in catalog order. */\nexport const onboardingTourServices = SERVICE_CATALOG.filter(\n  s => s.onboarding !== undefined\n);\n\nexport function getServiceBySlug(slug: string): ServiceDefinition | undefined {\n  return SERVICE_CATALOG.find(s => s.slug === slug);\n}\n\nexport function getServiceUrl(service: ServiceDefinition): string | null {\n  if (service.subdomainLabel) {\n    return platformUrl(service.subdomainLabel);\n  }\n  return null;\n}\n","/**\n * crossNav — build the sidebar cross-service links (service → service jump\n * without going through the Portal Service Hub).\n *\n * Visibility mirrors the Portal ServiceHub rule: platform_admin and\n * enterprise_admin see every service; everyone else only sees the\n * services granted in the portal `user_services` table. The current service\n * never links to itself. Each link URL carries the caller's current\n * org-hierarchy selection (?oh=…) so the breadcrumb arrives pre-aligned.\n */\nimport type { OrgHierarchySelection } from \"../hierarchy/orgHierarchy\";\nimport { appendSelectionParam } from \"../hierarchy/selectionParams\";\nimport { SERVICE_CATALOG, getServiceUrl } from \"./catalog\";\n\n/** Roles that see every service regardless of individual grants. */\nexport const ADMIN_SEE_ALL_ROLES = [\n  \"platform_admin\",\n  \"enterprise_admin\",\n] as const;\n\n/**\n * Legacy grant slugs → canonical catalog slugs. Auto-provisioned accounts\n * were granted \"sqdcp-logic\" while the catalog slug is \"sqdcp\".\n */\nexport const SLUG_ALIASES: Record<string, string> = {\n  \"sqdcp-logic\": \"sqdcp\",\n};\n\nexport function normalizeServiceSlug(slug: string): string {\n  return SLUG_ALIASES[slug] ?? slug;\n}\n\n/** Display-ready cross-service link entry. */\nexport interface CrossServiceLink {\n  slug: string;\n  name: string;\n  /** Lucide icon name from the service catalog (consumers resolve locally). */\n  icon: string;\n  accentColor: string;\n  /** Absolute URL including the ?oh= hierarchy selection param. */\n  url: string;\n}\n\nexport interface BuildCrossServiceLinksOptions {\n  /** Catalog slug of the service doing the rendering (excluded from links). */\n  currentSlug: string;\n  /** Grant slugs from the portal (raw — aliases are normalized here). */\n  grantedSlugs: string[];\n  /** Portal role of the current user (drives the admin see-all rule). */\n  role?: string | null;\n  /** Current org-hierarchy selection to carry across (may be empty/null). */\n  selection?: OrgHierarchySelection | null;\n}\n\nexport function buildCrossServiceLinks(\n  options: BuildCrossServiceLinksOptions\n): CrossServiceLink[] {\n  const { currentSlug, grantedSlugs, role, selection } = options;\n\n  const isAdmin =\n    !!role && (ADMIN_SEE_ALL_ROLES as readonly string[]).includes(role);\n  const granted = new Set(grantedSlugs.map(normalizeServiceSlug));\n  const current = normalizeServiceSlug(currentSlug);\n\n  return SERVICE_CATALOG.filter(\n    svc =>\n      svc.subdomainLabel !== null &&\n      svc.slug !== current &&\n      (isAdmin || granted.has(svc.slug))\n  ).map(svc => ({\n    slug: svc.slug,\n    name: svc.name,\n    icon: svc.icon,\n    accentColor: svc.accentColor,\n    url: appendSelectionParam(getServiceUrl(svc)!, selection),\n  }));\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-LUQAR6NB.js → chunk-BG4DVZAY.js}

@@ -512,18 +512,42 @@ var PANEL_GAP = 12;
 function computePanelPosition(target, panelSize, viewport, placement = "auto") {
   const order = placement === "auto" ? AUTO_ORDER : FALLBACK_ORDER[placement];
   for (const candidate of order) {
-    const pos2 = placeAt(candidate, target, panelSize);
-    if (fits(pos2, panelSize, viewport)) {
-      return { ...pos2, placement: candidate };
+    const pos = placeAt(candidate, target, panelSize);
+    if (fits(pos, panelSize, viewport)) {
+      return { ...pos, placement: candidate };
     }
   }
-  const fallback = order[0];
-  const pos = placeAt(fallback, target, panelSize);
-  return {
-    top: clamp(pos.top, 0, Math.max(0, viewport.height - panelSize.height)),
-    left: clamp(pos.left, 0, Math.max(0, viewport.width - panelSize.width)),
-    placement: fallback
+  const clampedAt = (side) => {
+    const pos = placeAt(side, target, panelSize);
+    return {
+      top: clamp(pos.top, 0, Math.max(0, viewport.height - panelSize.height)),
+      left: clamp(pos.left, 0, Math.max(0, viewport.width - panelSize.width)),
+      placement: side
+    };
   };
+  for (const candidate of order) {
+    const pos = clampedAt(candidate);
+    if (!overlapsTarget(pos, panelSize, target)) return pos;
+  }
+  return clampedAt(order[0]);
+}
+function maxPanelHeight(target, panelWidth, viewport) {
+  const targetRight = target.left + target.width;
+  const targetBottom = target.top + target.height;
+  const heights = [
+    viewport.height - (targetBottom + PANEL_GAP),
+    // below
+    target.top - PANEL_GAP
+    // above
+  ];
+  if (targetRight + PANEL_GAP + panelWidth <= viewport.width || // right
+  target.left - PANEL_GAP - panelWidth >= 0) {
+    heights.push(viewport.height);
+  }
+  return Math.max(0, ...heights);
+}
+function overlapsTarget(pos, panelSize, target) {
+  return pos.left < target.left + target.width && pos.left + panelSize.width > target.left && pos.top < target.top + target.height && pos.top + panelSize.height > target.top;
 }
 function placeAt(side, target, panelSize) {
   const targetCenterX = target.left + target.width / 2;
@@ -559,7 +583,12 @@ function clamp(value, min, max) {
 }
 
 // src/tour/TourShell.tsx
-import { useEffect as useEffect3, useRef as useRef2, useState as useState2 } from "react";
+import {
+  useEffect as useEffect3,
+  useLayoutEffect,
+  useRef as useRef2,
+  useState as useState2
+} from "react";
 import {
   X,
   ChevronLeft,
@@ -577,7 +606,11 @@ var defaultSkin = {
   bodyText: "#c0c6d0",
   softText: "#8890a0"
 };
-var SPOTLIGHT_PANEL_SIZE = { width: 320, height: 280 };
+var SPOTLIGHT_PANEL_WIDTH = 320;
+var SPOTLIGHT_PANEL_ESTIMATED_HEIGHT = 280;
+var SPOTLIGHT_PANEL_MAX_HEIGHT = 560;
+var SPOTLIGHT_PANEL_MIN_HEIGHT = 220;
+var SPOTLIGHT_VIEWPORT_MARGIN = 16;
 function useHover() {
   const [hovered, setHovered] = useState2(false);
   return [
@@ -588,6 +621,39 @@ function useHover() {
     }
   ];
 }
+function useMeasuredHeight(ref, active, estimate) {
+  const [height, setHeight] = useState2(estimate);
+  useLayoutEffect(() => {
+    const el = ref.current;
+    if (!active || !el) return;
+    const measure = () => {
+      const next = Math.ceil(el.getBoundingClientRect().height);
+      setHeight((prev) => next > 0 && next !== prev ? next : prev);
+    };
+    measure();
+    if (typeof ResizeObserver === "undefined") return;
+    const observer = new ResizeObserver(measure);
+    observer.observe(el);
+    return () => observer.disconnect();
+  }, [ref, active]);
+  return height;
+}
+function scrollCue(background, accent) {
+  const shadow = `${accent}88`;
+  return {
+    backgroundColor: background,
+    backgroundImage: [
+      `linear-gradient(${background} 30%, transparent)`,
+      `linear-gradient(transparent, ${background} 70%)`,
+      `radial-gradient(farthest-side at 50% 0, ${shadow}, transparent)`,
+      `radial-gradient(farthest-side at 50% 100%, ${shadow}, transparent)`
+    ].join(", "),
+    backgroundRepeat: "no-repeat",
+    backgroundPosition: "center top, center bottom, center top, center bottom",
+    backgroundSize: "100% 40px, 100% 40px, 100% 20px, 100% 20px",
+    backgroundAttachment: "local, local, scroll, scroll"
+  };
+}
 function TourShell({
   step,
   index,
@@ -607,6 +673,11 @@ function TourShell({
   const panelRef = useRef2(null);
   const { rect, found } = useSpotlight(step.spotlight?.selector ?? null);
   const isSpotlight = Boolean(step.spotlight) && found && rect !== null;
+  const panelHeight = useMeasuredHeight(
+    panelRef,
+    isSpotlight,
+    SPOTLIGHT_PANEL_ESTIMATED_HEIGHT
+  );
   useEffect3(() => {
     const onKeyDown = (e) => {
       if (e.key === "Escape") onDismiss();
@@ -634,12 +705,36 @@ function TourShell({
   if (isSpotlight && rect) {
     const viewport = { width: window.innerWidth, height: window.innerHeight };
     const frame = computeSpotlightFrame(rect, viewport);
-    const panelPos = computePanelPosition(
-      rect,
-      SPOTLIGHT_PANEL_SIZE,
-      viewport,
+    const inset = SPOTLIGHT_VIEWPORT_MARGIN;
+    const insetTarget = {
+      ...rect,
+      top: rect.top - inset,
+      left: rect.left - inset
+    };
+    const insetViewport = {
+      width: viewport.width - 2 * inset,
+      height: viewport.height - 2 * inset
+    };
+    const room = maxPanelHeight(
+      insetTarget,
+      SPOTLIGHT_PANEL_WIDTH,
+      insetViewport
+    );
+    const maxHeight = Math.min(
+      SPOTLIGHT_PANEL_MAX_HEIGHT,
+      insetViewport.height,
+      room >= SPOTLIGHT_PANEL_MIN_HEIGHT ? room : Infinity
+    );
+    const placed = computePanelPosition(
+      insetTarget,
+      {
+        width: SPOTLIGHT_PANEL_WIDTH,
+        height: Math.min(panelHeight, maxHeight)
+      },
+      insetViewport,
       step.spotlight?.placement ?? "auto"
     );
+    const panelPos = { top: placed.top + inset, left: placed.left + inset };
     return /* @__PURE__ */ jsxs2(Fragment, { children: [
       ["top", "bottom", "left", "right"].map((side) => {
         const segment = frame[side];
@@ -685,25 +780,35 @@ function TourShell({
           style: {
             top: panelPos.top,
             left: panelPos.left,
-            width: SPOTLIGHT_PANEL_SIZE.width,
-            maxHeight: SPOTLIGHT_PANEL_SIZE.height,
+            width: SPOTLIGHT_PANEL_WIDTH,
+            maxHeight,
             background: skin.panelBg,
             border: skin.panelBorder
           },
           children: [
             /* @__PURE__ */ jsx3(TourShellHeader, { step, orb, onDismiss }),
             /* @__PURE__ */ jsx3(TourShellStepDots, { total, index, skin }),
-            /* @__PURE__ */ jsx3("div", { className: "overflow-y-auto", style: { padding: "12px 16px" }, children: /* @__PURE__ */ jsx3(
-              TourShellBody,
+            /* @__PURE__ */ jsx3(
+              "div",
               {
-                gap: 12,
-                step,
-                narration,
-                narrationPending,
-                skin,
-                children
+                className: "overflow-y-auto",
+                style: {
+                  padding: "12px 16px",
+                  ...scrollCue(skin.panelBg, skin.accent)
+                },
+                children: /* @__PURE__ */ jsx3(
+                  TourShellBody,
+                  {
+                    gap: 12,
+                    step,
+                    narration,
+                    narrationPending,
+                    skin,
+                    children
+                  }
+                )
               }
-            ) }),
+            ),
             /* @__PURE__ */ jsx3(
               TourShellFooter,
               {
@@ -1203,4 +1308,4 @@ export {
   useTour,
   OpiTourHost
 };
-//# sourceMappingURL=chunk-LUQAR6NB.js.map
+//# sourceMappingURL=chunk-BG4DVZAY.js.map