@omerdlw/base-framework 1.0.4 → 1.0.6

package/dist/index.js

@@ -7733,13 +7733,18 @@ init_theme();
 // src/modules/ambient/color.ts
 var COLOR_EXTRACT_CONFIG = Object.freeze({
   blackChromaFactor: 0.35,
-  primaryLightness: 0.74,
-  maxBlackChroma: 0.055,
   blackLightness: 0.15,
   cacheLimit: 100,
+  chromaGain: 9.4,
+  hueBins: 36,
+  maxBlackChroma: 0.055,
   maxChroma: 0.28,
-  minChroma: 0.03,
-  sampleSize: 32
+  maxPrimaryChroma: 0.24,
+  minPixelChroma: 0.03,
+  minPresence: 0.04,
+  neutralChroma: 0.012,
+  primaryLightness: 0.74,
+  sampleSize: 64
 });
 function srgbToLinear(c) {
   const v = c / 255;
@@ -7776,100 +7781,104 @@ function oklchToString(l, c, h, alpha = 1) {
   }
   return `oklch(${safeL} ${safeC} ${safeH})`;
 }
+function clamp2(value, min, max) {
+  return Math.max(min, Math.min(max, value));
+}
 function derivePalette(sampled) {
   const {
     blackChromaFactor,
     blackLightness,
+    chromaGain,
     maxBlackChroma,
     maxChroma,
-    minChroma,
+    maxPrimaryChroma,
+    neutralChroma,
     primaryLightness
   } = COLOR_EXTRACT_CONFIG;
-  const chroma = Math.max(minChroma, Math.min(maxChroma, sampled.c));
-  const blackChroma = Math.min(
-    maxBlackChroma,
-    Math.max(0.025, chroma * blackChromaFactor)
-  );
-  const primaryChroma = Math.max(
-    0.15,
-    Math.min(0.24, Math.max(chroma * 1.15, 0.18))
-  );
+  const chroma = sampled.c < neutralChroma ? 0 : clamp2(sampled.c, 0, maxChroma);
+  const hue = chroma === 0 ? 0 : sampled.h;
+  const primaryChroma = maxPrimaryChroma * (1 - Math.exp(-chroma * chromaGain));
+  const primaryL = clamp2(
+    primaryLightness + (sampled.l - 0.6) * 0.5,
+    0.6,
+    0.86
+  );
+  const blackChroma = Math.min(maxBlackChroma, chroma * blackChromaFactor);
+  const blackL = clamp2(blackLightness + (sampled.l - 0.6) * 0.06, 0.12, 0.18);
   return {
-    black: oklchToString(blackLightness, blackChroma, sampled.h),
-    primary: oklchToString(primaryLightness, primaryChroma, sampled.h)
+    black: oklchToString(blackL, blackChroma, hue),
+    primary: oklchToString(primaryL, primaryChroma, hue)
   };
 }
 
 // src/modules/ambient/extractor.ts
 function sampleImageData(imageData) {
+  const { hueBins, minPixelChroma, minPresence } = COLOR_EXTRACT_CONFIG;
   const data = imageData.data;
-  const len = data.length;
-  const numBins = 24;
-  const binAngle = 360 / numBins;
-  const bins = Array.from({ length: numBins }, () => ({
-    count: 0,
+  const binAngle = 360 / hueBins;
+  const bins = Array.from({ length: hueBins }, () => ({
+    cos: 0,
+    sin: 0,
     sumC: 0,
-    sumCos: 0,
     sumL: 0,
-    sumSin: 0
+    weight: 0
   }));
-  let neutralCount = 0;
-  let neutralSumL = 0;
+  let opaqueCount = 0;
+  let opaqueSumL = 0;
   let chromaticCount = 0;
-  for (let i = 0; i < len; i += 4) {
-    const alpha = data[i + 3];
-    if (alpha < 128) continue;
-    const r = data[i];
-    const g = data[i + 1];
-    const b = data[i + 2];
-    const oklch = rgbToOklch(r, g, b);
-    if (oklch.l < 0.04 || oklch.l > 0.96 || oklch.c < 0.02) {
-      neutralCount++;
-      neutralSumL += oklch.l;
+  let midNeutralCount = 0;
+  for (let i = 0; i < data.length; i += 4) {
+    if (data[i + 3] < 128) continue;
+    const { c, h, l } = rgbToOklch(data[i], data[i + 1], data[i + 2]);
+    opaqueCount++;
+    opaqueSumL += l;
+    if (l < 0.06 || l > 0.96) continue;
+    if (c < minPixelChroma) {
+      midNeutralCount++;
       continue;
     }
-    const binIndex = Math.floor(oklch.h / binAngle) % numBins;
-    const rad = oklch.h * (Math.PI / 180);
-    const bin = bins[binIndex];
-    bin.count++;
-    bin.sumL += oklch.l;
-    bin.sumC += oklch.c;
-    bin.sumCos += Math.cos(rad);
-    bin.sumSin += Math.sin(rad);
+    const usable = 1 - 0.7 * Math.min(1, Math.abs(l - 0.62) / 0.62);
+    const weight2 = c * c * usable;
+    const rad = h * (Math.PI / 180);
+    const bin = bins[Math.floor(h / binAngle) % hueBins];
+    bin.weight += weight2;
+    bin.sumC += c * weight2;
+    bin.sumL += l * weight2;
+    bin.cos += Math.cos(rad) * weight2;
+    bin.sin += Math.sin(rad) * weight2;
     chromaticCount++;
   }
-  if (chromaticCount === 0) {
-    const avgL2 = neutralCount > 0 ? neutralSumL / neutralCount : 0.55;
-    return { c: 0.03, h: 252, l: avgL2 };
-  }
+  const averageL = opaqueCount > 0 ? opaqueSumL / opaqueCount : 0.5;
+  const neutral = { c: 0, h: 0, l: Number(averageL.toFixed(3)) };
+  const presence = chromaticCount / Math.max(1, chromaticCount + midNeutralCount);
+  if (chromaticCount === 0 || presence < minPresence) return neutral;
   let bestIndex = 0;
-  let maxWindowCount = -1;
-  for (let i = 0; i < numBins; i++) {
-    const prev2 = bins[(i - 1 + numBins) % numBins];
-    const curr2 = bins[i];
-    const next2 = bins[(i + 1) % numBins];
-    const windowCount = prev2.count * 0.5 + curr2.count + next2.count * 0.5;
-    if (windowCount > maxWindowCount) {
-      maxWindowCount = windowCount;
+  let bestScore = -1;
+  for (let i = 0; i < hueBins; i++) {
+    const prev = bins[(i - 1 + hueBins) % hueBins];
+    const next = bins[(i + 1) % hueBins];
+    const score = prev.weight * 0.5 + bins[i].weight + next.weight * 0.5;
+    if (score > bestScore) {
+      bestScore = score;
       bestIndex = i;
     }
   }
-  const prev = bins[(bestIndex - 1 + numBins) % numBins];
-  const curr = bins[bestIndex];
-  const next = bins[(bestIndex + 1) % numBins];
-  const totalCount = prev.count + curr.count + next.count;
-  if (totalCount === 0) {
-    return { c: 0.19, h: 252, l: 0.55 };
-  }
-  const avgL = (prev.sumL + curr.sumL + next.sumL) / totalCount;
-  const avgC = (prev.sumC + curr.sumC + next.sumC) / totalCount;
-  const avgSin = prev.sumSin + curr.sumSin + next.sumSin;
-  const avgCos = prev.sumCos + curr.sumCos + next.sumCos;
-  const avgH = (Math.atan2(avgSin, avgCos) * (180 / Math.PI) + 360) % 360;
+  const window2 = [
+    bins[(bestIndex - 1 + hueBins) % hueBins],
+    bins[bestIndex],
+    bins[(bestIndex + 1) % hueBins]
+  ];
+  const weight = window2.reduce((sum, bin) => sum + bin.weight, 0);
+  if (weight === 0) return neutral;
+  const sumC = window2.reduce((sum, bin) => sum + bin.sumC, 0);
+  const sumL = window2.reduce((sum, bin) => sum + bin.sumL, 0);
+  const sin = window2.reduce((sum, bin) => sum + bin.sin, 0);
+  const cos = window2.reduce((sum, bin) => sum + bin.cos, 0);
+  const dilution = 0.45 + 0.55 * Math.min(1, presence / 0.3);
   return {
-    c: Number(avgC.toFixed(3)),
-    h: Number(avgH.toFixed(1)),
-    l: Number(avgL.toFixed(3))
+    c: Number((sumC / weight * dilution).toFixed(3)),
+    h: Number(((Math.atan2(sin, cos) * (180 / Math.PI) + 360) % 360).toFixed(1)),
+    l: Number((sumL / weight).toFixed(3))
   };
 }
 function createDefaultPalette(fallback) {
@@ -8618,6 +8627,7 @@ init_utils();
 init_atoms();
 
 // src/modules/dock/surface/context.tsx
+init_kernel();
 init_utils();
 
 // src/modules/dock/surface/helpers.ts
@@ -8749,7 +8759,7 @@ function normalizeSurfaceExtension(input) {
   if (typeof input !== "object") return null;
   const extension = input;
   const component = isValidComponentType(extension.component) ? extension.component : null;
-  const content = isValidElement(extension.content) || typeof extension.content === "string" || typeof extension.content === "number" ? extension.content : null;
+  const content = isValidElement(extension.content) || typeof extension.content === "string" && extension.content !== "" || typeof extension.content === "number" ? extension.content : null;
   if (!component && content == null) return null;
   const align = extension.align === "right" || extension.align === "end" ? "right" : extension.align === "center" ? "center" : "left";
   return {
@@ -8794,8 +8804,8 @@ function resolveSurfaceFlowReturnHandshake(definition, input) {
 }
 
 // src/modules/dock/surface/context.tsx
-var SurfaceExtensionsContext = createContext(null);
-var SurfaceItemContext = createContext({
+var SurfaceExtensionsContext = getOrCreateGlobalContext("SurfaceExtensionsContext", null);
+var SurfaceItemContext = getOrCreateGlobalContext("SurfaceItemContext", {
   id: null,
   width: null
 });
@@ -8809,12 +8819,12 @@ var SurfaceHeaderActionStore = class {
   }
   subscribe = (listener) => this.store.subscribe(listener);
   getAction = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
+    const sId = surfaceId != null ? String(surfaceId) : "active";
     const { actionsBySurface } = this.store.getSnapshot();
-    return actionsBySurface[sId] ?? actionsBySurface.global ?? null;
+    return actionsBySurface[sId] ?? actionsBySurface.active ?? actionsBySurface.global ?? null;
   };
   setAction = (surfaceId, action) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
+    const sId = surfaceId != null ? String(surfaceId) : "active";
     const current = this.store.getSnapshot();
     if (current.actionsBySurface[sId] === action) return;
     this.store.setState({
@@ -8826,7 +8836,7 @@ var SurfaceHeaderActionStore = class {
     });
   };
   removeAction = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
+    const sId = surfaceId != null ? String(surfaceId) : "active";
     const current = this.store.getSnapshot();
     if (!(sId in current.actionsBySurface)) return;
     const { [sId]: _, ...nextActions } = current.actionsBySurface;
@@ -8850,17 +8860,32 @@ var SurfaceExtensionsStore = class {
     this.store.setState((prev) => ({ version: prev.version + 1 }));
   };
   getExtensionsForSurface = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
+    const sId = surfaceId != null ? String(surfaceId) : "active";
     if (this.cachedListBySurface.has(sId))
       return this.cachedListBySurface.get(sId);
     const globalExts = this.extensionsBySurface.get("global");
-    const surfaceExts = this.extensionsBySurface.get(sId);
-    if (!globalExts && !surfaceExts) {
+    const activeExts = this.extensionsBySurface.get("active");
+    const surfaceExts = sId !== "global" && sId !== "active" ? this.extensionsBySurface.get(sId) : void 0;
+    let fallbackExts;
+    if (!globalExts && !activeExts && !surfaceExts && this.extensionsBySurface.size > 0) {
+      for (const map2 of this.extensionsBySurface.values()) {
+        if (map2.size > 0) {
+          fallbackExts = map2;
+          break;
+        }
+      }
+    }
+    if (!globalExts && !activeExts && !surfaceExts && !fallbackExts) {
       const empty = [];
       this.cachedListBySurface.set(sId, empty);
       return empty;
     }
-    const merged = new Map([...globalExts || [], ...surfaceExts || []]);
+    const merged = new Map([
+      ...globalExts || [],
+      ...activeExts || [],
+      ...surfaceExts || [],
+      ...fallbackExts || []
+    ]);
     const result = Array.from(merged.values()).sort(
       (a, b) => a.order - b.order
     );
@@ -8871,7 +8896,7 @@ var SurfaceExtensionsStore = class {
     if (!extension) return;
     const normalized = normalizeSurfaceExtension(extension);
     if (!normalized) return;
-    const sId = surfaceId != null ? String(surfaceId) : "global";
+    const sId = surfaceId != null ? String(surfaceId) : "active";
     let surfaceMap = this.extensionsBySurface.get(sId);
     if (!surfaceMap) {
       surfaceMap = /* @__PURE__ */ new Map();
@@ -8885,17 +8910,23 @@ var SurfaceExtensionsStore = class {
   };
   removeExtension = (surfaceId, extensionId) => {
     if (!extensionId) return;
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    const surfaceMap = this.extensionsBySurface.get(sId);
-    if (!surfaceMap || !surfaceMap.has(extensionId)) return;
-    surfaceMap.delete(extensionId);
-    if (surfaceMap.size === 0) this.extensionsBySurface.delete(sId);
-    this.notify();
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    let removed = false;
+    for (const [key, map2] of this.extensionsBySurface.entries()) {
+      if (key === sId || key === "active" || key === "global") {
+        if (map2.has(extensionId)) {
+          map2.delete(extensionId);
+          if (map2.size === 0) this.extensionsBySurface.delete(key);
+          removed = true;
+        }
+      }
+    }
+    if (removed) this.notify();
   };
   clearSurface = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    if (!this.extensionsBySurface.has(sId)) return;
+    const sId = surfaceId != null ? String(surfaceId) : "active";
     this.extensionsBySurface.delete(sId);
+    this.extensionsBySurface.delete("active");
     this.notify();
   };
 };
@@ -11626,7 +11657,7 @@ function useDockSurfaceControlsModel({
   const phase = propSurfacePhase ?? activeItem?.surfacePhase;
   const isBodyVisible = phase ? phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN : true;
   const actionStore = use(SurfaceExtensionsContext)?.headerActions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
+  const surfaceId = activeItem?.surfaceId || "active";
   const subscribeAction = useCallback(
     (onStoreChange) => actionStore ? actionStore.subscribe(onStoreChange) : () => {
     },
@@ -11654,7 +11685,7 @@ function SurfaceExtensionsProvider({
 }
 function useIsSurfaceExtensionsVisible(activeItem) {
   const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
+  const surfaceId = activeItem?.surfaceId || "active";
   const isSurface = Boolean(activeItem?.isSurface);
   const phase = activeItem?.surfacePhase;
   const isBodyVisible = phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN;
@@ -11673,14 +11704,14 @@ function useIsSurfaceExtensionsVisible(activeItem) {
     return Array.isArray(raw) ? raw.length : 0;
   }, [activeItem?.surfaceExtensions, activeItem?.extensions]);
   return Boolean(
-    isSurface && isBodyVisible && (dynamicCount > 0 || descriptorCount > 0)
+    isSurface && (isBodyVisible && dynamicCount > 0 || descriptorCount > 0)
   );
 }
 function useDockSurfaceExtensionsBarModel({
   activeItem
 }) {
   const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
+  const surfaceId = activeItem?.surfaceId || "active";
   const subscribe2 = useCallback(
     (onStoreChange) => store ? store.subscribe(onStoreChange) : () => {
     },