@contember/react-multipass-rendering 0.0.0

package/src/nodeSpecs/Leaf.ts

@@ -0,0 +1,59 @@
+import type { ElementType } from 'react'
+import type {
+	ConstrainedLeafRepresentationFactory,
+	UnconstrainedLeafRepresentationFactory,
+	ValidFactoryName,
+} from './types'
+
+class Leaf<
+	Props extends {} = {},
+	StaticContext = any,
+	FactoryMethodName extends ValidFactoryName = string,
+	Representation = any,
+> {
+	public readonly specification: Leaf.Specification<FactoryMethodName, Representation, Props, StaticContext>
+
+	public constructor(factoryMethodName: FactoryMethodName)
+	public constructor(staticFactory: UnconstrainedLeafRepresentationFactory<Props, Representation, StaticContext>)
+	public constructor(
+		staticFactory: ConstrainedLeafRepresentationFactory<Props, Representation, StaticContext>,
+		ComponentType: ElementType<Props>,
+	)
+	public constructor(
+		factory: FactoryMethodName | UnconstrainedLeafRepresentationFactory<Props, Representation, StaticContext>,
+		ComponentType?: ElementType<Props>,
+	) {
+		if (typeof factory === 'function') {
+			this.specification = {
+				type: 'useSite',
+				ComponentType,
+				factory,
+			}
+		} else {
+			this.specification = {
+				type: 'declarationSite',
+				factoryMethodName: factory,
+			}
+		}
+	}
+}
+
+namespace Leaf {
+	export type Specification<
+		FactoryMethodName extends ValidFactoryName,
+		Representation,
+		Props extends {},
+		StaticContext,
+	> =
+		| {
+				type: 'declarationSite'
+				factoryMethodName: FactoryMethodName
+		  }
+		| {
+				type: 'useSite'
+				factory: UnconstrainedLeafRepresentationFactory<Props, Representation, StaticContext>
+				ComponentType?: ElementType<Props>
+		  }
+}
+
+export { Leaf }

package/src/nodeSpecs/RawNodeRepresentation.ts

@@ -0,0 +1,5 @@
+export type RawNodeRepresentation<AllLeavesRepresentation, AllBranchNodesRepresentation = AllLeavesRepresentation> =
+	| AllLeavesRepresentation
+	| AllBranchNodesRepresentation
+	| Array<AllLeavesRepresentation | AllBranchNodesRepresentation>
+	| undefined

package/src/nodeSpecs/index.ts

@@ -0,0 +1,6 @@
+export * from './types'
+
+export * from './BranchNode'
+export * from './BranchNodeOptions'
+export * from './Leaf'
+export * from './RawNodeRepresentation'

package/src/nodeSpecs/types/ChildrenRepresentationReducer.ts

@@ -0,0 +1,3 @@
+export type ChildrenRepresentationReducer<ChildrenRepresentation, ReducedChildrenRepresentation> = (
+	childrenRepresentations: ChildrenRepresentation,
+) => ReducedChildrenRepresentation

package/src/nodeSpecs/types/ConstrainedLeafRepresentationFactory.ts

@@ -0,0 +1,6 @@
+import type { ReactElement } from 'react'
+
+export type ConstrainedLeafRepresentationFactory<Props extends {}, Representation, StaticContext> = (
+	node: ReactElement<Props, any>,
+	staticContext: StaticContext,
+) => Representation

package/src/nodeSpecs/types/DeclarationSiteNodeRepresentationFactory.ts

@@ -0,0 +1,10 @@
+export type DeclarationSiteNodeRepresentationFactory<
+	Props extends {},
+	ReducedChildrenRepresentation,
+	Representation,
+	StaticContext,
+> = (
+	props: Props,
+	reducedChildrenRepresentation: ReducedChildrenRepresentation,
+	staticContext: StaticContext,
+) => Representation

package/src/nodeSpecs/types/RepresentationFactorySite.ts

@@ -0,0 +1 @@
+export type RepresentationFactorySite = 'declarationSite' | 'useSite'

package/src/nodeSpecs/types/StaticContextFactory.ts

@@ -0,0 +1,4 @@
+export type StaticContextFactory<Props extends {}, StaticContext> = (
+	props: Props,
+	staticContext: StaticContext,
+) => StaticContext

package/src/nodeSpecs/types/SyntheticChildrenFactory.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from 'react'
+
+export type SyntheticChildrenFactory<Props extends {}, StaticContext> = (
+	props: Props,
+	staticContext: StaticContext,
+) => ReactNode

package/src/nodeSpecs/types/UnconstrainedLeafRepresentationFactory.ts

@@ -0,0 +1,6 @@
+import type { ReactElement, ReactText } from 'react'
+
+export type UnconstrainedLeafRepresentationFactory<Props extends {}, Representation, StaticContext> = (
+	node: ReactText | ReactElement<Props, any> | boolean | null | undefined,
+	staticContext: StaticContext,
+) => Representation

package/src/nodeSpecs/types/UseSiteBranchNodeRepresentationFactory.ts

@@ -0,0 +1,12 @@
+import type { ReactElement } from 'react'
+
+export type UseSiteBranchNodeRepresentationFactory<
+	Props extends {},
+	ChildrenRepresentation,
+	Representation,
+	StaticContext,
+> = (
+	node: ReactElement<Props, any>,
+	childrenRepresentation: ChildrenRepresentation,
+	staticContext: StaticContext,
+) => Representation

package/src/nodeSpecs/types/ValidFactoryName.ts

@@ -0,0 +1 @@
+export type ValidFactoryName = string | number

package/src/nodeSpecs/types/index.ts

@@ -0,0 +1,9 @@
+export * from './ChildrenRepresentationReducer'
+export * from './ConstrainedLeafRepresentationFactory'
+export * from './DeclarationSiteNodeRepresentationFactory'
+export * from './RepresentationFactorySite'
+export * from './StaticContextFactory'
+export * from './SyntheticChildrenFactory'
+export * from './UnconstrainedLeafRepresentationFactory'
+export * from './UseSiteBranchNodeRepresentationFactory'
+export * from './ValidFactoryName'

package/src/tsconfig.json

@@ -0,0 +1,9 @@
+{
+	"extends": "../../../tsconfig.settings.json",
+	"compilerOptions": {
+		"outDir": "../dist/types"
+	},
+	"references": [
+		{ "path": "../../utilities/src" }
+	]
+}