@quilted/quilt 0.8.12 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @quilted/quilt
 
+## 0.9.1
+
+### Patch Changes
+
+- [`e6fa47e`](https://github.com/lemonmade/quilt/commit/e6fa47e93981ce0eaebbe1546659aaa08cc22689) Thanks [@lemonmade](https://github.com/lemonmade)! - Update Preact and Signal dependencies
+
+- Updated dependencies [[`b1df5da`](https://github.com/lemonmade/quilt/commit/b1df5daff8441f8435a62b02b4ad3676d3ddcc3b), [`06b43bc`](https://github.com/lemonmade/quilt/commit/06b43bc44d271ce30798dc0b582870208bae1572), [`e6fa47e`](https://github.com/lemonmade/quilt/commit/e6fa47e93981ce0eaebbe1546659aaa08cc22689)]:
+  - @quilted/preact-browser@0.2.6
+  - @quilted/assets@0.1.11
+  - @quilted/preact-router@0.2.15
+  - @quilted/preact-performance@0.1.2
+  - @quilted/preact-localize@0.4.1
+  - @quilted/preact-context@0.1.4
+  - @quilted/preact-graphql@0.1.9
+  - @quilted/preact-signals@0.1.3
+  - @quilted/preact-testing@0.1.9
+  - @quilted/preact-workers@0.2.2
+  - @quilted/preact-async@0.1.22
+  - @quilted/react-dom@19.0.2
+  - @quilted/graphql@3.3.10
+  - @quilted/signals@0.2.4
+  - @quilted/threads@4.0.2
+  - @quilted/events@2.1.4
+
+## 0.9.0
+
+### Minor Changes
+
+- [#872](https://github.com/lemonmade/quilt/pull/872) [`8bf65e7`](https://github.com/lemonmade/quilt/commit/8bf65e797f929ee95730323426c229409e65c9a4) Thanks [@lemonmade](https://github.com/lemonmade)! - Replace @quilted/request-router with Hono
+
+### Patch Changes
+
+- Updated dependencies [[`8bf65e7`](https://github.com/lemonmade/quilt/commit/8bf65e797f929ee95730323426c229409e65c9a4)]:
+  - @quilted/preact-localize@0.4.0
+  - @quilted/preact-browser@0.2.0
+  - @quilted/hono@0.2.0
+  - @quilted/preact-async@0.1.21
+  - @quilted/preact-router@0.2.13
+
 ## 0.8.12
 
 ### Patch Changes

package/build/esm/context/QuiltFrameworkContext.mjs

@@ -0,0 +1,109 @@
+import { useContext, useMemo, useLayoutEffect } from 'preact/hooks';
+import { QuiltFrameworkContextPreact } from '@quilted/preact-context';
+import { HTMLAttributes } from '@quilted/preact-browser';
+import { signal } from '@quilted/preact-signals';
+import { useAsyncActionCacheSerialization } from '@quilted/preact-async';
+import { jsxs, Fragment, jsx } from 'preact/jsx-runtime';
+
+/**
+ * Provides a `QuiltContext` value to the component tree. Accepts any declared
+ * `QuiltContext` fields as props and memoizes the context object so that
+ * consumers only re-render when a field they use actually changes.
+ *
+ * Also manages async hydration tracking and optional async action cache
+ * serialization — no separate `<AsyncContext>` needed.
+ *
+ * Use this component at the root of your application to provide navigation,
+ * localization, browser details, and other app-wide context.
+ *
+ * @example
+ * <QuiltFrameworkContext navigation={context.navigation} localization={context.localization}>
+ *   <App />
+ * </QuiltFrameworkContext>
+ */
+function QuiltFrameworkContext({
+  navigation,
+  navigationEntry,
+  localization,
+  browser,
+  assets,
+  performance,
+  async: asyncProp,
+  graphql,
+  children
+}) {
+  const parentContext = useContext(QuiltFrameworkContextPreact);
+  const asyncValue = useAsyncContext(asyncProp);
+  const memoizedValue = useMemo(() => ({
+    ...parentContext,
+    ...(navigation == null ? undefined : {
+      navigation
+    }),
+    ...(navigationEntry == null ? undefined : {
+      navigationEntry
+    }),
+    ...(localization == null ? undefined : {
+      localization
+    }),
+    ...(browser == null ? undefined : {
+      browser
+    }),
+    ...(assets == null ? undefined : {
+      assets
+    }),
+    ...(performance == null ? undefined : {
+      performance
+    }),
+    async: asyncValue,
+    ...(graphql == null ? undefined : {
+      graphql
+    })
+  }), [parentContext, navigation, navigationEntry, localization, browser, assets, performance, asyncValue, graphql]);
+  if (typeof document !== 'object') {
+    if (navigation?.cache) {
+      // Serialize the navigation cache for server-side rendering.
+      useAsyncActionCacheSerialization(navigation.cache, {
+        name: 'quilt:router'
+      });
+    }
+  }
+  return jsxs(Fragment, {
+    children: [localization && jsx(HTMLAttributes, {
+      lang: localization.locale,
+      dir: localization.direction
+    }), jsx(QuiltFrameworkContextPreact.Provider, {
+      value: memoizedValue,
+      children: children
+    })]
+  });
+}
+function useAsyncContext({
+  cache: asyncCache,
+  components: asyncComponents,
+  serialize: asyncSerialize = true
+} = {}) {
+  // Hydration signal: starts false on the server, flips to true after
+  // the first client-side render. Stable across re-renders via useRef.
+  const hydratedSignal = useMemo(() => signal(false), []);
+  if (typeof document === 'object') {
+    useLayoutEffect(() => {
+      hydratedSignal.value = true;
+    }, []);
+  }
+  if (typeof document !== 'object') {
+    // Serialize the async action cache for server-side rendering.
+    useAsyncActionCacheSerialization(asyncSerialize ? asyncCache : undefined, {
+      name: 'quilt:async',
+      optional: true
+    });
+  }
+  return useMemo(() => ({
+    cache: asyncCache,
+    components: asyncComponents,
+    get isHydrated() {
+      return hydratedSignal.value;
+    }
+  }), [asyncCache, asyncComponents, hydratedSignal]);
+}
+
+export { QuiltFrameworkContext };

package/build/esm/context/testing.mjs

@@ -0,0 +1,40 @@
+import { useMemo } from 'preact/hooks';
+import { QuiltFrameworkContextPreact } from '@quilted/preact-context';
+import { TestNavigation } from '@quilted/preact-router/testing';
+import { TestBrowser } from '@quilted/preact-browser/testing';
+import { Localization } from '@quilted/preact-localize';
+import { jsx } from 'preact/jsx-runtime';
+
+/**
+ * Provides a `QuiltContext` configured with test-friendly instances of
+ * navigation, localization, and browser details. Use this in unit tests
+ * to wrap components that need Quilt context.
+ *
+ * @example
+ * const navigation = new TestNavigation('/my-page');
+ * render(
+ *   <QuiltFrameworkTestContext navigation={navigation} localization={new Localization('fr')}>
+ *     <MyComponent />
+ *   </QuiltFrameworkTestContext>
+ * );
+ */
+function QuiltFrameworkTestContext({
+  navigation,
+  localization = new Localization('en'),
+  browser,
+  children
+}) {
+  const resolvedNavigation = useMemo(() => navigation ?? new TestNavigation(), [navigation]);
+  const resolvedBrowser = useMemo(() => browser ?? new TestBrowser(), [browser]);
+  const value = useMemo(() => ({
+    navigation: resolvedNavigation,
+    localization,
+    browser: resolvedBrowser
+  }), [resolvedNavigation, localization, resolvedBrowser]);
+  return jsx(QuiltFrameworkContextPreact.Provider, {
+    value: value,
+    children: children
+  });
+}
+
+export { QuiltFrameworkTestContext };

package/build/esm/context.mjs

@@ -1 +1,2 @@
-export * from '@quilted/preact-context';
+export { QuiltFrameworkContextPreact, createOptionalContext, useQuiltContext } from '@quilted/preact-context';
+export { QuiltFrameworkContext } from './context/QuiltFrameworkContext.mjs';

package/build/esm/hono/node.mjs

@@ -0,0 +1 @@
+export * from '@quilted/hono/node';

package/build/esm/hono.mjs

@@ -0,0 +1 @@
+export * from '@quilted/hono';

package/build/esm/server.mjs

@@ -2,4 +2,3 @@ export { renderToStaticMarkup, renderToString, renderToStringAsync } from 'preac
 export * from '@quilted/preact-browser/server';
 export * from '@quilted/assets';
 export { parseAcceptLanguageHeader } from '@quilted/preact-localize';
-export { createRequestRouterLocalization } from '@quilted/preact-localize/request-router';

package/build/esnext/context/QuiltFrameworkContext.esnext

@@ -0,0 +1,92 @@
+import { jsxs, Fragment, jsx } from 'preact/jsx-runtime';
+import { useContext, useMemo, useLayoutEffect } from 'preact/hooks';
+import { QuiltFrameworkContextPreact } from '@quilted/preact-context';
+import { HTMLAttributes } from '@quilted/preact-browser';
+import { signal } from '@quilted/preact-signals';
+import { useAsyncActionCacheSerialization } from '@quilted/preact-async';
+
+function QuiltFrameworkContext({
+  navigation,
+  navigationEntry,
+  localization,
+  browser,
+  assets,
+  performance,
+  async: asyncProp,
+  graphql,
+  children
+}) {
+  const parentContext = useContext(QuiltFrameworkContextPreact);
+  const asyncValue = useAsyncContext(asyncProp);
+  const memoizedValue = useMemo(
+    () => ({
+      ...parentContext,
+      ...navigation == null ? void 0 : { navigation },
+      ...navigationEntry == null ? void 0 : { navigationEntry },
+      ...localization == null ? void 0 : { localization },
+      ...browser == null ? void 0 : { browser },
+      ...assets == null ? void 0 : { assets },
+      ...performance == null ? void 0 : { performance },
+      async: asyncValue,
+      ...graphql == null ? void 0 : { graphql }
+    }),
+    [
+      parentContext,
+      navigation,
+      navigationEntry,
+      localization,
+      browser,
+      assets,
+      performance,
+      asyncValue,
+      graphql
+    ]
+  );
+  if (typeof document !== "object") {
+    if (navigation?.cache) {
+      useAsyncActionCacheSerialization(navigation.cache, {
+        name: "quilt:router"
+      });
+    }
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    localization && /* @__PURE__ */ jsx(
+      HTMLAttributes,
+      {
+        lang: localization.locale,
+        dir: localization.direction
+      }
+    ),
+    /* @__PURE__ */ jsx(QuiltFrameworkContextPreact.Provider, { value: memoizedValue, children })
+  ] });
+}
+function useAsyncContext({
+  cache: asyncCache,
+  components: asyncComponents,
+  serialize: asyncSerialize = true
+} = {}) {
+  const hydratedSignal = useMemo(() => signal(false), []);
+  if (typeof document === "object") {
+    useLayoutEffect(() => {
+      hydratedSignal.value = true;
+    }, []);
+  }
+  if (typeof document !== "object") {
+    useAsyncActionCacheSerialization(asyncSerialize ? asyncCache : void 0, {
+      name: "quilt:async",
+      optional: true
+    });
+  }
+  return useMemo(
+    () => ({
+      cache: asyncCache,
+      components: asyncComponents,
+      get isHydrated() {
+        return hydratedSignal.value;
+      }
+    }),
+    [asyncCache, asyncComponents, hydratedSignal]
+  );
+}
+
+export { QuiltFrameworkContext };

package/build/esnext/context/testing.esnext

@@ -0,0 +1,33 @@
+import { jsx } from 'preact/jsx-runtime';
+import { useMemo } from 'preact/hooks';
+import { QuiltFrameworkContextPreact } from '@quilted/preact-context';
+import { TestNavigation } from '@quilted/preact-router/testing';
+import { TestBrowser } from '@quilted/preact-browser/testing';
+import { Localization } from '@quilted/preact-localize';
+
+function QuiltFrameworkTestContext({
+  navigation,
+  localization = new Localization("en"),
+  browser,
+  children
+}) {
+  const resolvedNavigation = useMemo(
+    () => navigation ?? new TestNavigation(),
+    [navigation]
+  );
+  const resolvedBrowser = useMemo(
+    () => browser ?? new TestBrowser(),
+    [browser]
+  );
+  const value = useMemo(
+    () => ({
+      navigation: resolvedNavigation,
+      localization,
+      browser: resolvedBrowser
+    }),
+    [resolvedNavigation, localization, resolvedBrowser]
+  );
+  return /* @__PURE__ */ jsx(QuiltFrameworkContextPreact.Provider, { value, children });
+}
+
+export { QuiltFrameworkTestContext };

package/build/esnext/context.esnext

@@ -1 +1,2 @@
-export * from '@quilted/preact-context';
+export { QuiltFrameworkContextPreact, createOptionalContext, useQuiltContext } from '@quilted/preact-context';
+export { QuiltFrameworkContext } from './context/QuiltFrameworkContext.esnext';

package/build/esnext/hono/node.esnext

@@ -0,0 +1 @@
+export * from '@quilted/hono/node';

package/build/esnext/hono.esnext

@@ -0,0 +1 @@
+export * from '@quilted/hono';

package/build/esnext/server.esnext

@@ -2,4 +2,3 @@ export { renderToStaticMarkup, renderToString, renderToStringAsync } from 'preac
 export * from '@quilted/preact-browser/server';
 export * from '@quilted/assets';
 export { parseAcceptLanguageHeader } from '@quilted/preact-localize';
-export { createRequestRouterLocalization } from '@quilted/preact-localize/request-router';