@picked/svelte 0.0.1-dev.1780446300503 → 0.0.1-dev.1780464669265

package/dist/experience/Experience.svelte

@@ -7,7 +7,7 @@
    * re-renders reactively.
    */
   import type { ExperienceStore, ExperienceTarget } from '@picked/client'
-  import { evaluateConditionMemo, hashRule } from '@picked/client/server'
+  import { evaluateConditionMemo, hashRule, ruleReferencesAction } from '@picked/client/server'
   import { getPicked, useUnit } from '../hooks'
   import ExperienceHost from './ExperienceHost.svelte'
 
@@ -26,7 +26,7 @@
   const { name }: Props = $props()
 
   const client = getPicked()
-  const selector = `.picked-slot-${name}`
+  const selector = $derived(`.picked-slot-${name}`)
 
   const PLACEMENT_ORDER: ExperienceTarget['placement'][] = ['before', 'prepend', 'append', 'after']
 
@@ -54,10 +54,11 @@
   }
 
   /**
-   * Maps an experience to a slot candidate, or null when it does not target this slot.
+   * Maps an experience to a slot candidate, or null when it does not target this slot, uses the
+   * deferred `replace` placement, or carries an action-referencing condition.
    *
    * @param {ExperienceStore} experience - The experience to inspect.
-   * @returns {Candidate | null} The candidate, or null when the experience does not target this slot.
+   * @returns {Candidate | null} The candidate, or null when the experience is not an eligible slot match.
    * @example
    * toCandidate(experienceStore)
    */
@@ -70,6 +71,20 @@
       return null
     }
 
+    // `replace` is deferred (first-wins semantics are not implemented yet), so skip it rather than
+    // letting it fall through and render appended-last.
+    if (target.placement === 'replace') {
+      return null
+    }
+
+    // Action-referencing conditions are never cached (their side effect must re-run), so they can
+    // never resolve through the synchronous `peek` the slot path relies on. Slots do not support
+    // action-gated conditions in v1; excluding them also stops the selection effect from re-firing
+    // the action on every render.
+    if (ruleReferencesAction(config.decisionLogic)) {
+      return null
+    }
+
     return {
       experience,
       placement: target.placement,

package/dist/experience/ExperienceHost.svelte

@@ -40,7 +40,10 @@
   // content arrives pre-registered via the snapshot.
   $effect(() => {
     if ($ready) {
-      void experience.prepareExperienceContentFx()
+      // Content fetch failures (e.g. a 404 when the content endpoint is unavailable) are already
+      // swallowed inside the effect; the explicit catch guarantees no unhandled rejection even if
+      // that contract changes, so a missing/erroring content endpoint never breaks rendering.
+      experience.prepareExperienceContentFx().catch(() => undefined)
     }
   })
 

package/dist/render/browser.d.ts

@@ -1,5 +1,29 @@
 import { AdaptedComponent, ExperienceInstance, Picked } from '@picked/client';
+/**
+ * Builds the Svelte context map exposing the client and experience instance to a mounted component.
+ *
+ * @param {Picked} client - The Picked client.
+ * @param {ExperienceInstance} experience - The experience instance.
+ * @returns {Map<symbol, Picked | ExperienceInstance>} The context map keyed by the client and experience context symbols.
+ * @example
+ * createContext(client, experience)
+ */
 export declare function createContext(client: Picked, experience: ExperienceInstance): Map<symbol, Picked | ExperienceInstance>;
+/**
+ * Renders an adapted Svelte component into a shadow root, injecting its stylesheets and inline CSS.
+ *
+ * @param {ShadowRoot} shadowRoot - The shadow root to render into.
+ * @param {AdaptedComponent<string, unknown>} component - The adapted component to render.
+ * @param {Picked} client - The Picked client.
+ * @param {ExperienceInstance} experience - The experience instance.
+ * @param {object} options - Stylesheets and inline CSS to inject into the shadow root.
+ * @param {string[]} [options.stylesheets] - Stylesheet URLs to inject as `<link>` elements.
+ * @param {string[]} [options.css] - Inline CSS blocks to inject as `<style>` elements.
+ * @returns {Promise<void>} A promise that resolves once the component is mounted.
+ * @throws {Error} When the component is not a valid adapted Svelte component.
+ * @example
+ * await renderSvelteComponent(shadowRoot, component, client, experience, {})
+ */
 export declare const renderSvelteComponent: (shadowRoot: ShadowRoot, component: AdaptedComponent<string, unknown>, client: Picked, experience: ExperienceInstance, options: {
     stylesheets?: string[];
     css?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picked/svelte",
-  "version": "0.0.1-dev.1780446300503",
+  "version": "0.0.1-dev.1780464669265",
   "dependencies": {
     "d3": "^7.9.0"
   },
@@ -14,7 +14,7 @@
     "@tsconfig/svelte": "^5.0.4",
     "@types/d3": "^7.4.3",
     "@types/node": "^22",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/coverage-v8": "^4.1.8",
     "effector": "^23.3.0",
     "fast-glob": "^3.3.3",
     "happy-dom": "^20.8.8",
@@ -25,7 +25,7 @@
     "typedoc-plugin-markdown": "^4.6.3",
     "vite": "^8.0.8",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.8"
   },
   "exports": {
     ".": {
@@ -106,7 +106,7 @@
   },
   "module": "./dist/index.js",
   "peerDependencies": {
-    "@picked/client": "0.0.1-dev.1780446300503",
+    "@picked/client": "0.0.1-dev.1780464669265",
     "effector": "^23.3.0",
     "svelte": "^5.46.4"
   },