@barefootjs/shared 0.15.2 → 0.17.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { BF_SCOPE, BF_SLOT, BF_HOST, BF_AT, BF_ROOT, BF_PROPS, BF_COND, BF_ITEM, BF_PORTAL_OWNER, BF_PORTAL_ID, BF_PORTAL_PLACEHOLDER, BF_PARENT_OWNED_PREFIX, BF_SCOPE_COMMENT_PREFIX, BF_LOOP_START, BF_LOOP_END, BF_LOOP_ITEM, loopItemMarker, loopStartMarker, loopEndMarker, BF_KEY, BF_KEY_PREFIX, BF_PLACEHOLDER, BF_ASYNC, BF_ASYNC_RESOLVE, BF_REGION, BF_PARENT_SCOPE_PLACEHOLDER, BF_SEAM_HYDRATE, BF_SEAM_HYDRATE_WITHIN, BF_SEAM_DISPOSE_WITHIN, BF_SEAM_PUSH_SEARCH, } from './markers.ts';
+export { BF_SCOPE, BF_SLOT, BF_HOST, BF_AT, BF_ROOT, BF_PROPS, BF_COND, BF_ITEM, BF_PORTAL_OWNER, BF_PORTAL_ID, BF_PORTAL_PLACEHOLDER, BF_PARENT_OWNED_PREFIX, BF_SCOPE_COMMENT_PREFIX, BF_LOOP_START, BF_LOOP_END, BF_LOOP_ITEM, loopItemMarker, loopStartMarker, loopEndMarker, BF_KEY, BF_KEY_PREFIX, BF_PLACEHOLDER, BF_ASYNC, BF_ASYNC_RESOLVE, BF_REGION, BF_PARENT_SCOPE_PLACEHOLDER, BF_SEAM_HYDRATE, BF_SEAM_HYDRATE_WITHIN, BF_SEAM_DISPOSE_WITHIN, BF_SEAM_PUSH_SEARCH, BF_SEAM_NAV_SEARCH, } from './markers.ts';
 export { classifyDOMProp, toHTMLAttrName, toHTMLAttrNameRuntime, isBooleanAttr, isEventProp, BOOLEAN_ATTRS, } from './dom-prop.ts';
 export type { DOMPropKind, DOMPropClassification } from './dom-prop.ts';
 export type { ProfilerEvent, ProfilerEventType, ProfilerSubscriberKind, } from './profiler-events.ts';

package/dist/index.js

@@ -35,6 +35,7 @@ var BF_SEAM_HYDRATE = "__bf_hydrate";
 var BF_SEAM_HYDRATE_WITHIN = "__bf_hydrate_within";
 var BF_SEAM_DISPOSE_WITHIN = "__bf_dispose_within";
 var BF_SEAM_PUSH_SEARCH = "__bf_pushSearch";
+var BF_SEAM_NAV_SEARCH = "__bf_navSearch";
 // src/dom-prop.ts
 var BOOLEAN_ATTRS = new Set([
   "checked",
@@ -212,6 +213,7 @@ export {
   BOOLEAN_ATTRS,
   BF_SLOT,
   BF_SEAM_PUSH_SEARCH,
+  BF_SEAM_NAV_SEARCH,
   BF_SEAM_HYDRATE_WITHIN,
   BF_SEAM_HYDRATE,
   BF_SEAM_DISPOSE_WITHIN,

package/dist/markers.d.ts

@@ -143,5 +143,17 @@ export declare const BF_SEAM_HYDRATE = "__bf_hydrate";
 export declare const BF_SEAM_HYDRATE_WITHIN = "__bf_hydrate_within";
 /** Dispose the islands in a subtree. `window[BF_SEAM_DISPOSE_WITHIN](root)`. */
 export declare const BF_SEAM_DISPOSE_WITHIN = "__bf_dispose_within";
-/** Push a new query string into the `searchParams()` env signal. `window[BF_SEAM_PUSH_SEARCH](search)`. */
+/** Push a new query string into the env-signal getter returned by
+ *  `createSearchParams()`. `window[BF_SEAM_PUSH_SEARCH](search)`. */
 export declare const BF_SEAM_PUSH_SEARCH = "__bf_pushSearch";
+/**
+ * Imperative query-only navigation for `setSearchParams(...)`
+ * (`createSearchParams()`, router v0.5). `window[BF_SEAM_NAV_SEARCH](search)`.
+ *
+ * The client's `setSearchParams` writes the new query through this seam so the
+ * router can perform a soft, same-route navigation (history push + region
+ * re-render) without `@barefootjs/client` importing the router. When no router
+ * has installed the seam, `setSearchParams` falls back to a hard navigation —
+ * "never worse than an MPA" — so the imperative write is correct standalone.
+ */
+export declare const BF_SEAM_NAV_SEARCH = "__bf_navSearch";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/shared",
-  "version": "0.15.2",
+  "version": "0.17.0",
   "description": "Shared constants for BarefootJS compiler and runtime",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -29,6 +29,7 @@ export {
   BF_SEAM_HYDRATE_WITHIN,
   BF_SEAM_DISPOSE_WITHIN,
   BF_SEAM_PUSH_SEARCH,
+  BF_SEAM_NAV_SEARCH,
 } from './markers.ts'
 
 export {

package/src/markers.ts

@@ -213,7 +213,7 @@ export const BF_PARENT_SCOPE_PLACEHOLDER = '__BF_PARENT_SCOPE__'
 // The optional client router (`@barefootjs/router`) reaches the client runtime
 // through a few `window.__bf_*` function properties. The runtime *installs*
 // them (`@barefootjs/client/runtime/streaming.ts`, `@barefootjs/client`'s
-// `searchParams`) and the router *reads* them (`@barefootjs/router/seams.ts`),
+// `createSearchParams`) and the router *reads* them (`@barefootjs/router/seams.ts`),
 // in different packages — so the names live here as the single source of truth.
 // A rename is then a compile error on both sides instead of a silently-broken
 // seam (the router would otherwise fall back to a dynamic import and mask the
@@ -225,5 +225,17 @@ export const BF_SEAM_HYDRATE = '__bf_hydrate'
 export const BF_SEAM_HYDRATE_WITHIN = '__bf_hydrate_within'
 /** Dispose the islands in a subtree. `window[BF_SEAM_DISPOSE_WITHIN](root)`. */
 export const BF_SEAM_DISPOSE_WITHIN = '__bf_dispose_within'
-/** Push a new query string into the `searchParams()` env signal. `window[BF_SEAM_PUSH_SEARCH](search)`. */
+/** Push a new query string into the env-signal getter returned by
+ *  `createSearchParams()`. `window[BF_SEAM_PUSH_SEARCH](search)`. */
 export const BF_SEAM_PUSH_SEARCH = '__bf_pushSearch'
+/**
+ * Imperative query-only navigation for `setSearchParams(...)`
+ * (`createSearchParams()`, router v0.5). `window[BF_SEAM_NAV_SEARCH](search)`.
+ *
+ * The client's `setSearchParams` writes the new query through this seam so the
+ * router can perform a soft, same-route navigation (history push + region
+ * re-render) without `@barefootjs/client` importing the router. When no router
+ * has installed the seam, `setSearchParams` falls back to a hard navigation —
+ * "never worse than an MPA" — so the imperative write is correct standalone.
+ */
+export const BF_SEAM_NAV_SEARCH = '__bf_navSearch'