Added defaultEqualityCheck to createFacet, and introduced createStaticFacet

packages/@react-facet/core/src/createFacetContext.tsx

@@ -1,17 +1,8 @@
+import { createStaticFacet } from './facet/createStaticFacet'
 import { createContext } from 'react'
-import { Facet } from './types'
 
 export function createFacetContext<T>(initialValue: T) {
-  const facet: Facet<T> = {
-    get: () => initialValue,
-    observe: (listener) => {
-      if (process.env.NODE_ENV !== 'production') {
-        console.log('Missing Provider')
-      }
-      listener(initialValue)
-      return () => {}
-    },
-  }
+  const facet = createStaticFacet(initialValue)
   const context = createContext(facet)
   return context
 }

packages/@react-facet/core/src/facet/createFacet.ts

@@ -12,8 +12,14 @@ export interface FacetOptions<V> {
   startSubscription?: StartSubscription<V>
   equalityCheck?: EqualityCheck<V>
 }
-
-export function createFacet<V>({ initialValue, startSubscription, equalityCheck }: FacetOptions<V>): WritableFacet<V> {
+/**
+ * The low level function to create a Facet, not recommended to be used if you can use any of the react facet hooks to create facets instead (Ex: useFacetState, useFacetWrap)
+ */
+export function createFacet<V>({
+  initialValue,
+  startSubscription,
+  equalityCheck = defaultEqualityCheck,
+}: FacetOptions<V>): WritableFacet<V> {
   const listeners: Set<Listener<V>> = new Set()
   let currentValue = initialValue
   let cleanupSubscription: Cleanup | undefined

packages/@react-facet/core/src/facet/createStaticFacet.ts

@@ -0,0 +1,18 @@
+import { Facet } from '..'
+/**
+ * Creates a nonwritable barebones static facet to be used when you need an initial facet value outside the react context
+ * that's meant to be replaced later by a real facet. Ex: with `createContext()`
+ */
+export function createStaticFacet<T>(value: T): Facet<T> {
+  const facet: Facet<T> = {
+    get: () => value,
+    observe: (listener) => {
+      if (process.env.NODE_ENV !== 'production') {
+        console.log(`Accessing a static facet, perhaps you're missing a Context Provider?`)
+      }
+      listener(value)
+      return () => {}
+    },
+  }
+  return facet
+}

packages/@react-facet/core/src/facet/index.ts

@@ -1,2 +1,3 @@
 export * from './createFacet'
 export * from './createReadOnlyFacet'
+export * from './createStaticFacet'