atom.io 0.33.2 → 0.33.3

package/src/main/logger.ts

@@ -59,14 +59,18 @@ export type TokenDenomination =
 	| `molecule`
 	| `mutable_atom_family`
 	| `mutable_atom`
-	| `readonly_selector_family`
-	| `readonly_selector`
-	| `selector_family`
-	| `selector`
+	| `readonly_held_selector_family`
+	| `readonly_held_selector`
+	| `readonly_pure_selector_family`
+	| `readonly_pure_selector`
 	| `state`
 	| `timeline`
 	| `transaction`
 	| `unknown`
+	| `writable_held_selector_family`
+	| `writable_held_selector`
+	| `writable_pure_selector_family`
+	| `writable_pure_selector`
 
 export const LOG_LEVELS = [`info`, `warn`, `error`] as const
 export type LogLevel = (typeof LOG_LEVELS)[number]
@@ -78,7 +82,9 @@ export type LogFn = (
 	message: string,
 	...rest: unknown[]
 ) => void
-export type LogFilter = (...params: Parameters<LogFn>) => boolean
+export type LogFilter = (
+	...params: Parameters<LogFn>
+) => Parameters<LogFn> | boolean
 
 export type Logger = Record<LogLevel, LogFn>
 
@@ -113,22 +119,33 @@ export class AtomIOLogger implements Logger {
 	}
 
 	public error: LogFn = (...args) => {
-		if ((this.filter?.(...args) ?? true) && this.logLevel !== null) {
-			this.logger.error(...args)
+		const filterResult = this.filter?.(...args) ?? true
+		if (this.logLevel !== null) {
+			if (filterResult === true) {
+				this.logger.error(...args)
+			} else if (filterResult !== false) {
+				this.logger.error(...filterResult)
+			}
 		}
 	}
 	public info: LogFn = (...args) => {
-		if ((this.filter?.(...args) ?? true) && this.logLevel === `info`) {
-			this.logger.info(...args)
+		const filterResult = this.filter?.(...args) ?? true
+		if (this.logLevel === `info`) {
+			if (filterResult === true) {
+				this.logger.info(...args)
+			} else if (filterResult !== false) {
+				this.logger.info(...filterResult)
+			}
 		}
 	}
 	public warn: LogFn = (...args) => {
-		if (
-			(this.filter?.(...args) ?? true) &&
-			this.logLevel !== `error` &&
-			this.logLevel !== null
-		) {
-			this.logger.warn(...args)
+		const filterResult = this.filter?.(...args) ?? true
+		if (this.logLevel !== `error` && this.logLevel !== null) {
+			if (filterResult === true) {
+				this.logger.warn(...args)
+			} else if (filterResult !== false) {
+				this.logger.warn(...filterResult)
+			}
 		}
 	}
 }

package/src/main/selector.ts

@@ -5,89 +5,223 @@ import {
 } from "atom.io/internal"
 import type { Canonical } from "atom.io/json"
 
-import type { ReadonlySelectorToken, WritableSelectorToken } from "."
+import type {
+	ReadonlyHeldSelectorToken,
+	ReadonlyPureSelectorToken,
+	WritableHeldSelectorToken,
+	WritablePureSelectorToken,
+} from "."
 import type { Read, Write } from "./transaction"
 
-export type WritableSelectorOptions<T> = {
+export type WritablePureSelectorOptions<T> = {
 	key: string
 	get: Read<() => T>
 	set: Write<(newValue: T) => void>
 }
-export type ReadonlySelectorOptions<T> = {
+export type ReadonlyPureSelectorOptions<T> = {
 	key: string
 	get: Read<() => T>
 }
+export type ReadonlyHeldSelectorOptions<T extends object> = {
+	key: string
+	const: T
+	get: Read<(permanent: T) => void>
+}
+export type WritableHeldSelectorOptions<T extends object> = {
+	key: string
+	const: T
+	get: Read<(permanent: T) => void>
+	set: Write<(newValue: T) => void>
+}
+
+/**
+ * @public
+ * Declare a selector. The value of a selector should depend
+ * on the value of atoms or other selectors in the store, and
+ * should be recycled when a root atom of the selector is set.
+ *
+ * A held selector's value must be some object.
+ * The reference to that object is permanent and will not be replaced.
+ *
+ * A writable selector can be "set" to a new value.
+ * It is advised to set its dependencies to values
+ * that would produce the new value of the selector.
+ *
+ * @param options - {@link WritableHeldSelectorOptions}.
+ * @returns
+ * The token for your selector.
+ * @overload WritableHeld
+ */
+export function selector<T extends object>(
+	options: WritableHeldSelectorOptions<T>,
+): WritableHeldSelectorToken<T>
+
+/**
+ * @public
+ * Declare a selector. The value of a selector should depend
+ * on the value of atoms or other selectors in the store,
+ * and should be recycled when a root atom of the selector is set.
+ *
+ * A held selector's value must be some object.
+ * The reference to that object is permanent and will not be replaced.
+ *
+ * A readonly selector can be "gotten" but not "set".
+ *
+ * @param options - {@link ReadonlyHeldSelectorOptions}.
+ * @returns
+ * The token for your selector.
+ * @overload ReadonlyHeld
+ */
+export function selector<T extends object>(
+	options: ReadonlyHeldSelectorOptions<T>,
+): ReadonlyHeldSelectorToken<T>
 
 /**
  * @public
  * Declare a selector. The value of a selector should depend
  * on the value of atoms or other selectors in the store.
  *
+ * A pure selector's current value is evicted from the store
+ * in order to be garbage collected when a root atom of the selector is set.
+ *
  * A writable selector can be "set" to a new value.
  * It is advised to set its dependencies to values
  * that would produce the new value of the selector.
- * @param options - {@link WritableSelectorOptions}.
+ *
+ * @param options - {@link TransientWritableSelectorOptions}.
  * @returns
  * The token for your selector.
- * @overload Writable
+ * @overload WritablePure
  */
 export function selector<T>(
-	options: WritableSelectorOptions<T>,
-): WritableSelectorToken<T>
+	options: WritablePureSelectorOptions<T>,
+): WritablePureSelectorToken<T>
 
 /**
  * @public
  * Declare a selector. The value of a selector should depend
  * on the value of atoms or other selectors in the store.
- * @param options - {@link ReadonlySelectorOptions}.
+ *
+ * A pure selector's current value is evicted from the store
+ * in order to be garbage collected when a root atom of the selector is set.
+ *
+ * A readonly selector can be "gotten" but not "set".
+ *
+ * @param options - {@link ReadonlyPureSelectorOptions}.
+ * @returns
+ * The token for your selector.
+ * @overload ReadonlyPure
  */
 export function selector<T>(
-	options: ReadonlySelectorOptions<T>,
-): ReadonlySelectorToken<T>
-export function selector<T>(
-	options: ReadonlySelectorOptions<T> | WritableSelectorOptions<T>,
-): ReadonlySelectorToken<T> | WritableSelectorToken<T> {
+	options: ReadonlyPureSelectorOptions<T>,
+): ReadonlyPureSelectorToken<T>
+
+export function selector(
+	options:
+		| ReadonlyHeldSelectorOptions<any>
+		| ReadonlyPureSelectorOptions<any>
+		| WritableHeldSelectorOptions<any>
+		| WritablePureSelectorOptions<any>,
+):
+	| ReadonlyHeldSelectorToken<any>
+	| ReadonlyPureSelectorToken<any>
+	| WritableHeldSelectorToken<any>
+	| WritablePureSelectorToken<any> {
 	return createStandaloneSelector(IMPLICIT.STORE, options)
 }
 
-export type WritableSelectorFamilyOptions<T, K extends Canonical> = {
+export type WritablePureSelectorFamilyOptions<T, K extends Canonical> = {
 	key: string
 	get: (key: K) => Read<() => T>
 	set: (key: K) => Write<(newValue: T) => void>
 }
-export type ReadonlySelectorFamilyOptions<T, K extends Canonical> = {
+export type ReadonlyPureSelectorFamilyOptions<T, K extends Canonical> = {
 	key: string
 	get: (key: K) => Read<() => T>
 }
+export type WritableHeldSelectorFamilyOptions<
+	T extends object,
+	K extends Canonical,
+> = {
+	key: string
+	const: (key: K) => T
+	get: (key: K) => Read<(permanent: T) => void>
+	set: (key: K) => Write<(newValue: T) => void>
+}
+export type ReadonlyHeldSelectorFamilyOptions<
+	T extends object,
+	K extends Canonical,
+> = {
+	key: string
+	const: (key: K) => T
+	get: (key: K) => Read<(permanent: T) => void>
+}
 
-export type WritableSelectorFamilyToken<T, K extends Canonical> = {
+export type WritablePureSelectorFamilyToken<T, K extends Canonical> = {
 	key: string
-	type: `selector_family`
+	type: `writable_pure_selector_family`
 	__T?: T
 	__K?: K
 }
-
-export type ReadonlySelectorFamilyToken<T, K extends Canonical> = {
+export type ReadonlyPureSelectorFamilyToken<T, K extends Canonical> = {
 	key: string
-	type: `readonly_selector_family`
+	type: `readonly_pure_selector_family`
+	__T?: T
+	__K?: K
+}
+export type WritableHeldSelectorFamilyToken<T, K extends Canonical> = {
+	key: string
+	type: `writable_held_selector_family`
+	__T?: T
+	__K?: K
+}
+export type ReadonlyHeldSelectorFamilyToken<T, K extends Canonical> = {
+	key: string
+	type: `readonly_held_selector_family`
 	__T?: T
 	__K?: K
 }
 
+export type PureSelectorFamilyToken<T, K extends Canonical> =
+	| ReadonlyPureSelectorFamilyToken<T, K>
+	| WritablePureSelectorFamilyToken<T, K>
+export type HeldSelectorFamilyToken<T, K extends Canonical> =
+	| ReadonlyHeldSelectorFamilyToken<T, K>
+	| WritableHeldSelectorFamilyToken<T, K>
+export type ReadonlySelectorFamilyToken<T, K extends Canonical> =
+	| ReadonlyHeldSelectorFamilyToken<T, K>
+	| ReadonlyPureSelectorFamilyToken<T, K>
+
+export type WritableSelectorFamilyToken<T, K extends Canonical> =
+	| WritableHeldSelectorFamilyToken<T, K>
+	| WritablePureSelectorFamilyToken<T, K>
+
 export type SelectorFamilyToken<T, K extends Canonical> =
-	| ReadonlySelectorFamilyToken<T, K>
-	| WritableSelectorFamilyToken<T, K>
+	| HeldSelectorFamilyToken<T, K>
+	| PureSelectorFamilyToken<T, K>
 
+export function selectorFamily<T extends object, K extends Canonical>(
+	options: WritableHeldSelectorFamilyOptions<T, K>,
+): WritableHeldSelectorFamilyToken<T, K>
+export function selectorFamily<T extends object, K extends Canonical>(
+	options: ReadonlyHeldSelectorFamilyOptions<T, K>,
+): ReadonlyHeldSelectorFamilyToken<T, K>
 export function selectorFamily<T, K extends Canonical>(
-	options: WritableSelectorFamilyOptions<T, K>,
-): WritableSelectorFamilyToken<T, K>
-export function selectorFamily<T, K extends Canonical>(
-	options: ReadonlySelectorFamilyOptions<T, K>,
-): ReadonlySelectorFamilyToken<T, K>
+	options: WritablePureSelectorFamilyOptions<T, K>,
+): WritablePureSelectorFamilyToken<T, K>
 export function selectorFamily<T, K extends Canonical>(
+	options: ReadonlyPureSelectorFamilyOptions<T, K>,
+): ReadonlyPureSelectorFamilyToken<T, K>
+export function selectorFamily(
 	options:
-		| ReadonlySelectorFamilyOptions<T, K>
-		| WritableSelectorFamilyOptions<T, K>,
-): ReadonlySelectorFamilyToken<T, K> | WritableSelectorFamilyToken<T, K> {
+		| ReadonlyHeldSelectorFamilyOptions<any, any>
+		| ReadonlyPureSelectorFamilyOptions<any, any>
+		| WritableHeldSelectorFamilyOptions<any, any>
+		| WritablePureSelectorFamilyOptions<any, any>,
+):
+	| ReadonlyHeldSelectorFamilyToken<any, any>
+	| ReadonlyPureSelectorFamilyToken<any, any>
+	| WritableHeldSelectorFamilyToken<any, any>
+	| WritablePureSelectorFamilyToken<any, any> {
 	return createSelectorFamily(IMPLICIT.STORE, options)
 }

package/src/main/transaction.ts

@@ -14,7 +14,7 @@ import type {
 	MutableAtomToken,
 	ReadableToken,
 	TokenType,
-	WritableSelectorToken,
+	WritablePureSelectorToken,
 } from "."
 
 export type TransactionToken<F extends Func> = {
@@ -88,7 +88,7 @@ export type SetterToolkit = Readonly<{
 	find: typeof findState
 	json: <T extends Transceiver<any>, J extends Json.Serializable>(
 		state: MutableAtomToken<T, J>,
-	) => WritableSelectorToken<J>
+	) => WritablePureSelectorToken<J>
 }>
 export type ActorToolkit = Readonly<{
 	get: typeof getState
@@ -96,7 +96,7 @@ export type ActorToolkit = Readonly<{
 	find: typeof findState
 	json: <T extends Transceiver<any>, J extends Json.Serializable>(
 		state: MutableAtomToken<T, J>,
-	) => WritableSelectorToken<J>
+	) => WritablePureSelectorToken<J>
 	dispose: typeof disposeState
 	run: typeof runTransaction
 	env: () => EnvironmentData

package/src/main/validators.ts

@@ -3,13 +3,13 @@ import type {
 	MutableAtomToken,
 	ReadableFamilyToken,
 	ReadableToken,
-	ReadonlySelectorFamilyToken,
-	ReadonlySelectorToken,
+	ReadonlyPureSelectorFamilyToken,
+	ReadonlyPureSelectorToken,
 	RegularAtomFamilyToken,
 	RegularAtomToken,
 	WritableFamilyToken,
-	WritableSelectorFamilyToken,
-	WritableSelectorToken,
+	WritablePureSelectorFamilyToken,
+	WritablePureSelectorToken,
 	WritableToken,
 } from "atom.io"
 
@@ -29,14 +29,14 @@ export function isToken<KnownToken extends MutableAtomToken<any, any>>(
 	knownToken: KnownToken,
 	unknownToken: ReadableToken<any>,
 ): unknownToken is MutableAtomToken<TokenType<KnownToken>, any>
-export function isToken<KnownToken extends WritableSelectorToken<any>>(
+export function isToken<KnownToken extends WritablePureSelectorToken<any>>(
 	knownToken: KnownToken,
 	unknownToken: ReadableToken<any>,
-): unknownToken is WritableSelectorToken<TokenType<KnownToken>>
-export function isToken<KnownToken extends ReadonlySelectorToken<any>>(
+): unknownToken is WritablePureSelectorToken<TokenType<KnownToken>>
+export function isToken<KnownToken extends ReadonlyPureSelectorToken<any>>(
 	knownToken: KnownToken,
 	unknownToken: ReadableToken<any>,
-): unknownToken is ReadonlySelectorToken<TokenType<KnownToken>>
+): unknownToken is ReadonlyPureSelectorToken<TokenType<KnownToken>>
 export function isToken<KnownToken extends WritableToken<any>>(
 	knownToken: KnownToken,
 	unknownToken: ReadableToken<any>,
@@ -60,14 +60,18 @@ export function belongsTo<Family extends MutableAtomFamilyToken<any, any, any>>(
 	family: Family,
 	unknownToken: ReadableToken<any>,
 ): unknownToken is MutableAtomToken<TokenType<Family>, any>
-export function belongsTo<Family extends WritableSelectorFamilyToken<any, any>>(
+export function belongsTo<
+	Family extends WritablePureSelectorFamilyToken<any, any>,
+>(
 	family: Family,
 	unknownToken: ReadableToken<any>,
-): unknownToken is WritableSelectorToken<TokenType<Family>>
-export function belongsTo<Family extends ReadonlySelectorFamilyToken<any, any>>(
+): unknownToken is WritablePureSelectorToken<TokenType<Family>>
+export function belongsTo<
+	Family extends ReadonlyPureSelectorFamilyToken<any, any>,
+>(
 	family: Family,
 	unknownToken: ReadableToken<any>,
-): unknownToken is ReadonlySelectorToken<TokenType<Family>>
+): unknownToken is ReadonlyPureSelectorToken<TokenType<Family>>
 export function belongsTo<Family extends WritableFamilyToken<any, any>>(
 	family: Family,
 	unknownToken: ReadableToken<any>,

package/src/react-devtools/StateEditor.tsx

@@ -1,4 +1,8 @@
-import type { ReadonlySelectorToken, WritableToken } from "atom.io"
+import type {
+	ReadonlyPureSelectorToken,
+	ReadonlySelectorToken,
+	WritableToken,
+} from "atom.io"
 import { useI, useO } from "atom.io/react"
 import type { FC } from "react"
 
@@ -31,8 +35,14 @@ export const ReadonlySelectorViewer: FC<{
 export const StoreEditor: FC<{
 	token: ReadonlySelectorToken<unknown> | WritableToken<unknown>
 }> = ({ token }) => {
-	if (token.type === `readonly_selector`) {
-		return <ReadonlySelectorViewer token={token} />
+	switch (token.type) {
+		case `readonly_pure_selector`:
+		case `readonly_held_selector`:
+			return <ReadonlySelectorViewer token={token} />
+		case `writable_pure_selector`:
+		case `writable_held_selector`:
+		case `atom`:
+		case `mutable_atom`:
+			return <StateEditor token={token} />
 	}
-	return <StateEditor token={token} />
 }

package/src/react-devtools/StateIndex.tsx

@@ -1,6 +1,6 @@
 import type {
 	ReadableToken,
-	ReadonlySelectorToken,
+	ReadonlyPureSelectorToken,
 	RegularAtomToken,
 } from "atom.io"
 import { getState } from "atom.io"
@@ -19,7 +19,7 @@ import { DevtoolsContext } from "./store"
 export const StateIndexLeafNode: FC<{
 	node: ReadableToken<unknown>
 	isOpenState: RegularAtomToken<boolean>
-	typeState: ReadonlySelectorToken<string>
+	typeState: ReadonlyPureSelectorToken<string>
 }> = ({ node, isOpenState, typeState }) => {
 	const setIsOpen = useI(isOpenState)
 	const isOpen = useO(isOpenState)
@@ -102,7 +102,7 @@ export const StateIndexTreeNode: FC<{
 export const StateIndexNode: FC<{
 	node: FamilyNode<ReadableToken<unknown>> | ReadableToken<unknown>
 	isOpenState: RegularAtomToken<boolean>
-	typeState: ReadonlySelectorToken<string>
+	typeState: ReadonlyPureSelectorToken<string>
 }> = ({ node, isOpenState, typeState }) => {
 	return (
 		<section className="node state" data-testid={`state-${node.key}`}>
@@ -120,7 +120,9 @@ export const StateIndexNode: FC<{
 }
 
 export const StateIndex: FC<{
-	tokenIndex: ReadonlySelectorToken<WritableTokenIndex<ReadableToken<unknown>>>
+	tokenIndex: ReadonlyPureSelectorToken<
+		WritableTokenIndex<ReadableToken<unknown>>
+	>
 }> = ({ tokenIndex }) => {
 	const tokenIds = useO(tokenIndex)
 

package/src/react-devtools/TimelineIndex.tsx

@@ -1,5 +1,5 @@
 import type {
-	ReadonlySelectorToken,
+	ReadonlyPureSelectorToken,
 	RegularAtomToken,
 	TimelineToken,
 } from "atom.io"
@@ -19,7 +19,7 @@ export const YouAreHere: FC = () => {
 export const TimelineLog: FC<{
 	token: TimelineToken<any>
 	isOpenState: RegularAtomToken<boolean>
-	timelineState: ReadonlySelectorToken<Timeline<any>>
+	timelineState: ReadonlyPureSelectorToken<Timeline<any>>
 }> = ({ token, isOpenState, timelineState }) => {
 	const timeline = useO(timelineState)
 	const isOpen = useO(isOpenState)

package/src/react-devtools/TransactionIndex.tsx

@@ -1,5 +1,5 @@
 import type {
-	ReadonlySelectorToken,
+	ReadonlyPureSelectorToken,
 	RegularAtomToken,
 	TransactionToken,
 	TransactionUpdate,
@@ -15,7 +15,7 @@ import { article } from "./Updates"
 export const TransactionLog: FC<{
 	token: TransactionToken<Func>
 	isOpenState: RegularAtomToken<boolean>
-	logState: ReadonlySelectorToken<TransactionUpdate<Func>[]>
+	logState: ReadonlyPureSelectorToken<TransactionUpdate<Func>[]>
 }> = ({ token, isOpenState, logState }) => {
 	const log = useO(logState)
 	const isOpen = useO(isOpenState)

package/src/realtime/shared-room-store.ts

@@ -2,8 +2,8 @@ import type {
 	AtomToken,
 	JoinToken,
 	MutableAtomToken,
-	ReadonlySelectorFamilyToken,
-	ReadonlySelectorToken,
+	ReadonlyPureSelectorFamilyToken,
+	ReadonlyPureSelectorToken,
 } from "atom.io"
 import { atom, getInternalRelations, join, selectorFamily } from "atom.io"
 import { Join } from "atom.io/internal"
@@ -56,7 +56,7 @@ export const usersInRooms: JoinToken<
 	DEFAULT_USER_IN_ROOM_META,
 )
 
-export const usersInMyRoomView: ReadonlySelectorFamilyToken<
+export const usersInMyRoomView: ReadonlyPureSelectorFamilyToken<
 	MutableAtomToken<SetRTX<string>, SetRTXJson<string>>[],
 	string
 > = selectorFamily<

package/src/realtime-client/realtime-client-stores/client-main-store.ts

@@ -6,7 +6,7 @@ export const myIdState__INTERNAL: AtomIO.RegularAtomToken<string | undefined> =
 		key: `mySocketId__INTERNAL`,
 		default: undefined,
 	})
-export const myIdState: AtomIO.ReadonlySelectorToken<string | undefined> =
+export const myIdState: AtomIO.ReadonlyPureSelectorToken<string | undefined> =
 	AtomIO.selector<string | undefined>({
 		key: `mySocketId`,
 		get: ({ get }) => get(myIdState__INTERNAL),

package/src/realtime-react/use-pull-selector-family-member.ts

@@ -17,5 +17,6 @@ export function usePullSelectorFamilyMember<
 	useRealtimeService(`pull:${token.key}`, (socket) =>
 		RTC.pullSelectorFamilyMember(store, socket, token),
 	)
+
 	return useO(token)
 }

package/src/realtime-server/realtime-server-stores/server-room-external-store.ts

@@ -3,7 +3,7 @@ import { spawn } from "node:child_process"
 
 import type {
 	Loadable,
-	ReadonlySelectorFamilyToken,
+	ReadonlyPureSelectorFamilyToken,
 	RegularAtomFamilyToken,
 } from "atom.io"
 import { atomFamily, selectorFamily } from "atom.io"
@@ -20,7 +20,7 @@ export const roomArgumentsAtoms: RegularAtomFamilyToken<RoomArguments, string> =
 		default: [`echo`, [`Hello World!`]],
 	})
 
-export const roomSelectors: ReadonlySelectorFamilyToken<
+export const roomSelectors: ReadonlyPureSelectorFamilyToken<
 	Loadable<ChildSocket<any, any>>,
 	string
 > = selectorFamily<Loadable<ChildSocket<any, any>>, string>({

package/dist/devtools-Jyn42mZm.css.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools-Jyn42mZm.css","names":[],"sources":["src/react-devtools/devtools.css"],"sourcesContent":["main[data-css=\"atom_io_devtools\"] {\n\t--fg-color: #eee;\n\t--bg-color: #111;\n\t--bg-tint1: #222;\n\t--fg-border: 1px solid var(--fg-color);\n\t@media (prefers-color-scheme: light) {\n\t\t--fg-color: #444;\n\t\t--bg-color: #ddd;\n\t\t--bg-tint1: #e3e3e3;\n\t}\n\t& {\n\t\tbox-sizing: border-box;\n\t\tcolor: var(--fg-color);\n\t\tbackground-color: var(--bg-color);\n\t\tborder: 2px solid var(--fg-color);\n\t\tposition: fixed;\n\t\tright: 0;\n\t\tbottom: 0;\n\t\theight: 100%;\n\t\tdisplay: flex;\n\t\tflex-flow: column;\n\t\tmax-height: 800px;\n\t\twidth: 100%;\n\t\tmax-width: 500px;\n\t\toverflow-y: scroll;\n\t}\n\t* {\n\t\tfont-size: 16px;\n\t\tfont-family: theia, monospace;\n\t}\n\t> header {\n\t\tpadding: 5px;\n\t\tpadding-left: 10px;\n\t\tpadding-bottom: 0;\n\t\tdisplay: flex;\n\t\tjustify-content: space-between;\n\t\th1 {\n\t\t\tfont-size: inherit;\n\t\t\tmargin: 0;\n\t\t\tfont-size: 24px;\n\t\t\tfont-family: charter, serif;\n\t\t}\n\t\tnav {\n\t\t\tdisplay: flex;\n\t\t\tflex-flow: row nowrap;\n\t\t\tbutton {\n\t\t\t\tcursor: pointer;\n\t\t\t\tbackground: none;\n\t\t\t\tborder: none;\n\t\t\t\tpadding: none;\n\t\t\t\tmargin-bottom: -2px;\n\t\t\t\tz-index: 1000;\n\t\t\t\t&:disabled {\n\t\t\t\t\tcursor: default;\n\t\t\t\t\tbackground-color: var(--bg-tint1);\n\t\t\t\t\tcolor: var(--fg-color);\n\t\t\t\t\tborder: var(--fg-border);\n\t\t\t\t\tborder-bottom: none;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\t> main {\n\t\tbackground: var(--bg-tint1);\n\t}\n\tmain {\n\t\toverflow-y: scroll;\n\t\tflex-grow: 1;\n\t\tdisplay: flex;\n\t\tflex-flow: column;\n\t\tgap: 0;\n\t\tarticle.index {\n\t\t\t.node .node {\n\t\t\t\tborder-right: var(--fg-border);\n\t\t\t\tpadding-right: 0;\n\t\t\t\tbackground: #fff3;\n\t\t\t}\n\t\t\t.node > .node {\n\t\t\t\tmargin: 5px 0;\n\t\t\t\tmargin-left: 12px;\n\t\t\t\tborder-left: var(--fg-border);\n\t\t\t}\n\t\t\t.node {\n\t\t\t\tborder-top: var(--fg-border);\n\t\t\t\toverflow-x: scroll;\n\t\t\t\tpadding: 5px;\n\t\t\t\t&:last-of-type {\n\t\t\t\t\tborder-bottom: var(--fg-border);\n\t\t\t\t}\n\t\t\t\t&.transaction_update {\n\t\t\t\t\tpadding: 0;\n\t\t\t\t}\n\t\t\t\theader {\n\t\t\t\t\tdisplay: flex;\n\t\t\t\t\tflex-flow: row;\n\t\t\t\t\tgap: 5px;\n\t\t\t\t\tposition: sticky;\n\t\t\t\t\tz-index: 999;\n\t\t\t\t\ttop: 0;\n\t\t\t\t\tbutton.carat {\n\t\t\t\t\t\tcursor: pointer;\n\t\t\t\t\t\tbackground: none;\n\t\t\t\t\t\tborder: none;\n\t\t\t\t\t\twidth: 20px;\n\t\t\t\t\t\t&.open {\n\t\t\t\t\t\t\ttransform: rotate(90deg);\n\t\t\t\t\t\t}\n\t\t\t\t\t\t&:disabled {\n\t\t\t\t\t\t\tcursor: default;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\t> main {\n\t\t\t\t\t\tdisplay: flex;\n\t\t\t\t\t\tflex-flow: row;\n\t\t\t\t\t\tgap: 5px;\n\t\t\t\t\t\tcursor: help;\n\t\t\t\t\t\th2 {\n\t\t\t\t\t\t\tdisplay: inline-block;\n\t\t\t\t\t\t\tmargin: 0;\n\t\t\t\t\t\t}\n\t\t\t\t\t\t.detail {\n\t\t\t\t\t\t\tcolor: #777;\n\t\t\t\t\t\t\t@media (prefers-color-scheme: light) {\n\t\t\t\t\t\t\t\tcolor: #999;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tmain {\n\t\t\t\t\tmargin-left: 15px;\n\t\t\t\t}\n\t\t\t}\n\t\t\tsection.transaction_log {\n\t\t\t\tmargin-top: 0;\n\t\t\t\tmain {\n\t\t\t\t\tdisplay: flex;\n\t\t\t\t\tflex-flow: row wrap;\n\t\t\t\t\tgap: 5px;\n\t\t\t\t\t.transaction_update {\n\t\t\t\t\t\twidth: 100%;\n\t\t\t\t\t\tdisplay: flex;\n\t\t\t\t\t\tflex-flow: row;\n\t\t\t\t\t\talign-items: flex-start;\n\t\t\t\t\t\tjustify-content: flex-start;\n\t\t\t\t\t\tjustify-items: flex-start;\n\t\t\t\t\t\talign-content: flex-start;\n\t\t\t\t\t\tborder-left: var(--fg-border);\n\t\t\t\t\t\tborder-top: var(--fg-border);\n\t\t\t\t\t\theader {\n\t\t\t\t\t\t\tpadding: 5px;\n\t\t\t\t\t\t\th4 {\n\t\t\t\t\t\t\t\tmargin: 0;\n\t\t\t\t\t\t\t\tpadding: 0;\n\t\t\t\t\t\t\t\tfont-size: inherit;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tmain {\n\t\t\t\t\t\t\tmargin-left: 0;\n\t\t\t\t\t\t\tdisplay: flex;\n\t\t\t\t\t\t\tflex-flow: column;\n\t\t\t\t\t\t\tgap: 0px;\n\t\t\t\t\t\t\tborder-left: 1px solid #333;\n\t\t\t\t\t\t\tsection ~ section {\n\t\t\t\t\t\t\t\tborder-top: 1px solid #333;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tsection {\n\t\t\t\t\t\t\t\tpadding: 5px;\n\t\t\t\t\t\t\t\t&.transaction_output {\n\t\t\t\t\t\t\t\t\tborder-right: none;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t&.transaction_impact {\n\t\t\t\t\t\t\t\t\tpadding: 5px;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tmargin: 0;\n\t\t\t\t\t\t\t\tarticle {\n\t\t\t\t\t\t\t\t\tborder-left: var(--fg-border);\n\t\t\t\t\t\t\t\t\tborder-right: var(--fg-border);\n\t\t\t\t\t\t\t\t\t.summary {\n\t\t\t\t\t\t\t\t\t\twhite-space: nowrap;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tsection.timeline_log {\n\t\t\t\theader {\n\t\t\t\t\tdisplay: flex;\n\t\t\t\t\t> main {\n\t\t\t\t\t\tdisplay: flex;\n\t\t\t\t\t\twidth: 100%;\n\t\t\t\t\t\tflex-grow: 1;\n\t\t\t\t\t\t.gap {\n\t\t\t\t\t\t\tflex-grow: 1;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tnav {\n\t\t\t\t\t\t\tdisplay: flex;\n\t\t\t\t\t\t\tflex-flow: row nowrap;\n\t\t\t\t\t\t\tgap: 5px;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t.timeline_update {\n\t\t\t\t\tpadding: 5px;\n\t\t\t\t\tborder-left: var(--fg-border);\n\t\t\t\t\th4 {\n\t\t\t\t\t\tmargin: 0;\n\t\t\t\t\t\tpadding: 0;\n\t\t\t\t\t\tfont-size: inherit;\n\t\t\t\t\t}\n\t\t\t\t\tmain {\n\t\t\t\t\t\tmargin: 0;\n\t\t\t\t\t\t.node.atom_update {\n\t\t\t\t\t\t\tborder-left: var(--fg-border);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t.you_are_here {\n\t\t\t\t\tbackground: var(--fg-color);\n\t\t\t\t\tcolor: var(--bg-color);\n\t\t\t\t\ttext-align: center;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\tfooter {\n\t\tdisplay: flex;\n\t\tjustify-content: flex-end;\n\t\tbutton {\n\t\t\tcursor: pointer;\n\t\t\tbackground: none;\n\t\t\tborder: none;\n\t\t\tpadding: none;\n\t\t\tposition: absolute;\n\t\t\tright: 0;\n\t\t\tbottom: 0;\n\t\t}\n\t}\n\n\t.json_editor {\n\t\tinput {\n\t\t\tfont-family: theia, monospace;\n\t\t\tborder: none;\n\t\t\tborder-bottom: 1px solid;\n\t\t\tbackground: none;\n\t\t\t&:disabled {\n\t\t\t\tborder: none;\n\t\t\t}\n\t\t}\n\t\tbutton {\n\t\t\tbackground: none;\n\t\t\tcolor: #777;\n\t\t\tborder: none;\n\t\t\tfont-family: theia, monospace;\n\t\t\tfont-size: 14px;\n\t\t\tmargin: none;\n\t\t\tpadding: 4px;\n\t\t\tpadding-bottom: 6px;\n\t\t\tcursor: pointer;\n\t\t\t&:hover {\n\t\t\t\tcolor: #333;\n\t\t\t\tbackground-color: #aaa;\n\t\t\t}\n\t\t}\n\t\tselect {\n\t\t\tfont-family: theia, monospace;\n\t\t\tfont-size: 14px;\n\t\t\tbackground: none;\n\t\t\tborder: none;\n\t\t\tcolor: #777;\n\t\t\t@media (prefers-color-scheme: light) {\n\t\t\t\tcolor: #999;\n\t\t\t}\n\t\t}\n\t\t.json_editor_unofficial {\n\t\t\tbackground-color: #777;\n\t\t\tbutton {\n\t\t\t\tcolor: #333;\n\t\t\t}\n\t\t}\n\t\t.json_editor_missing {\n\t\t\tbackground-color: #f055;\n\t\t}\n\t\t.json_editor_key {\n\t\t\tpadding-right: 10px;\n\t\t\tinput {\n\t\t\t\tcolor: #999;\n\t\t\t\t@media (prefers-color-scheme: light) {\n\t\t\t\t\tcolor: #777;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t.json_editor_object {\n\t\t\tborder-left: 2px solid #333;\n\t\t\tpadding-left: 20px;\n\t\t\t@media (prefers-color-scheme: light) {\n\t\t\t\tborder-color: #ccc;\n\t\t\t}\n\t\t\t.json_editor_properties {\n\t\t\t\t> * {\n\t\t\t\t\tborder-bottom: var(--fg-border);\n\t\t\t\t\tmargin-bottom: 2px;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}

package/src/internal/selector/create-readonly-selector.ts

@@ -1,55 +0,0 @@
-import type {
-	FamilyMetadata,
-	ReadonlySelectorOptions,
-	ReadonlySelectorToken,
-} from "atom.io"
-
-import type { ReadonlySelector } from ".."
-import { cacheValue } from "../caching"
-import { newest } from "../lineage"
-import type { Store } from "../store"
-import { Subject } from "../subject"
-import { registerSelector } from "./register-selector"
-
-export const createReadonlySelector = <T>(
-	store: Store,
-	options: ReadonlySelectorOptions<T>,
-	family: FamilyMetadata | undefined,
-): ReadonlySelectorToken<T> => {
-	const target = newest(store)
-	const subject = new Subject<{ newValue: T; oldValue: T }>()
-	const covered = new Set<string>()
-	const { get, find, json } = registerSelector(options.key, covered, target)
-	const getSelf = () => {
-		const value = options.get({ get, find, json })
-		cacheValue(newest(store), options.key, value, subject)
-		covered.clear()
-		return value
-	}
-
-	const readonlySelector: ReadonlySelector<T> = {
-		...options,
-		subject,
-		install: (s: Store) => createReadonlySelector(s, options, family),
-		get: getSelf,
-		type: `readonly_selector`,
-		...(family && { family }),
-	}
-	target.readonlySelectors.set(options.key, readonlySelector)
-	const initialValue = getSelf()
-	store.logger.info(
-		`✨`,
-		readonlySelector.type,
-		readonlySelector.key,
-		`=`,
-		initialValue,
-	)
-	const token: ReadonlySelectorToken<T> = {
-		key: options.key,
-		type: `readonly_selector`,
-	}
-	if (family) {
-		token.family = family
-	}
-	return token
-}