@jfdevelops/react-layout-composables 0.6.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/composable.cjs +129 -16
- package/dist/composable.cjs.map +1 -1
- package/dist/composable.d.cts +104 -16
- package/dist/composable.d.cts.map +1 -1
- package/dist/composable.d.mts +104 -16
- package/dist/composable.d.mts.map +1 -1
- package/dist/composable.mjs +130 -17
- package/dist/composable.mjs.map +1 -1
- package/dist/custom-props.cjs +20 -0
- package/dist/custom-props.cjs.map +1 -0
- package/dist/custom-props.d.cts +36 -0
- package/dist/custom-props.d.cts.map +1 -0
- package/dist/custom-props.d.mts +36 -0
- package/dist/custom-props.d.mts.map +1 -0
- package/dist/custom-props.mjs +20 -0
- package/dist/custom-props.mjs.map +1 -0
- package/dist/errors.cjs +28 -4
- package/dist/errors.cjs.map +1 -1
- package/dist/errors.d.cts +152 -21
- package/dist/errors.d.cts.map +1 -1
- package/dist/errors.d.mts +152 -21
- package/dist/errors.d.mts.map +1 -1
- package/dist/errors.mjs +26 -5
- package/dist/errors.mjs.map +1 -1
- package/dist/index.cjs +17 -2
- package/dist/index.d.cts +6 -5
- package/dist/index.d.mts +6 -5
- package/dist/index.mjs +3 -3
- package/dist/{utils → packages/internals/src}/capitalize.d.cts +1 -1
- package/dist/packages/internals/src/capitalize.d.cts.map +1 -0
- package/dist/{utils → packages/internals/src}/capitalize.d.mts +1 -1
- package/dist/packages/internals/src/capitalize.d.mts.map +1 -0
- package/dist/packages/internals/src/types.d.cts +25 -0
- package/dist/packages/internals/src/types.d.cts.map +1 -0
- package/dist/packages/internals/src/types.d.mts +25 -0
- package/dist/packages/internals/src/types.d.mts.map +1 -0
- package/dist/types.d.cts +2 -2
- package/dist/types.d.cts.map +1 -1
- package/dist/types.d.mts +2 -2
- package/dist/types.d.mts.map +1 -1
- package/package.json +17 -16
- package/dist/utils/capitalize.d.cts.map +0 -1
- package/dist/utils/capitalize.d.mts.map +0 -1
- package/dist/utils.d.cts +0 -10
- package/dist/utils.d.cts.map +0 -1
- package/dist/utils.d.mts +0 -10
- package/dist/utils.d.mts.map +0 -1
package/dist/composable.cjs
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
const require_errors = require('./errors.cjs');
|
|
2
|
-
|
|
2
|
+
const require_custom_props = require('./custom-props.cjs');
|
|
3
3
|
let react = require("react");
|
|
4
|
+
let _jfdevelops_react_layout_validator = require("@jfdevelops/react-layout-validator");
|
|
4
5
|
let react_jsx_runtime = require("react/jsx-runtime");
|
|
5
6
|
|
|
6
7
|
//#region src/composable.tsx
|
|
@@ -18,11 +19,24 @@ function useComposablePresetProps(key) {
|
|
|
18
19
|
}
|
|
19
20
|
function collectComposablePresetEntries(composables) {
|
|
20
21
|
if (!composables) return [];
|
|
22
|
+
const declared = /* @__PURE__ */ new Map();
|
|
21
23
|
return Object.entries(composables).flatMap(([objectKey, component]) => {
|
|
22
24
|
const meta = component[composablePresetMetaKey];
|
|
23
25
|
if (!meta) return [];
|
|
26
|
+
const key = meta.key ?? objectKey;
|
|
27
|
+
for (const [prop, definition] of Object.entries(meta.props)) {
|
|
28
|
+
const existing = declared.get(prop);
|
|
29
|
+
if (existing && existing.definition !== definition) throw new require_errors.ConflictingPresetPropError({
|
|
30
|
+
prop,
|
|
31
|
+
composables: [existing.composable, key]
|
|
32
|
+
});
|
|
33
|
+
declared.set(prop, {
|
|
34
|
+
composable: key,
|
|
35
|
+
definition
|
|
36
|
+
});
|
|
37
|
+
}
|
|
24
38
|
return [{
|
|
25
|
-
key
|
|
39
|
+
key,
|
|
26
40
|
props: meta.props
|
|
27
41
|
}];
|
|
28
42
|
});
|
|
@@ -67,7 +81,8 @@ function createComposableComponent(options) {
|
|
|
67
81
|
const wrapperProps = { ...propsRecord };
|
|
68
82
|
for (const key of inPropsKeys) delete wrapperProps[key];
|
|
69
83
|
const mergedValues = (0, _jfdevelops_react_layout_validator.resolvePropDefinitionValues)(mergedInProps);
|
|
70
|
-
const
|
|
84
|
+
const alreadyValidated = options[validatedComposableProps];
|
|
85
|
+
const mergedResolved = (0, _jfdevelops_react_layout_validator.validateProps)(alreadyValidated ? {} : inProps, mergedValues);
|
|
71
86
|
const resolvedProps = outProps ? outProps(mergedResolved) : {};
|
|
72
87
|
const resolvedChildren = children == null ? reactNodeFromSingleFieldOutProps(resolvedProps) : resolveComponent(children, resolvedProps);
|
|
73
88
|
if (wrapWith) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(wrapWith, {
|
|
@@ -89,26 +104,63 @@ function createComposableComponent(options) {
|
|
|
89
104
|
props: void 0
|
|
90
105
|
});
|
|
91
106
|
}
|
|
107
|
+
function getRenamedName(prop, rename) {
|
|
108
|
+
if (rename === void 0) return prop;
|
|
109
|
+
return typeof rename === "string" ? rename : rename.name;
|
|
110
|
+
}
|
|
111
|
+
function renamePropDefinitions(composable, props, renames) {
|
|
112
|
+
for (const prop of Object.keys(renames)) if (renames[prop] !== void 0 && !Object.hasOwn(props, prop)) throw new require_errors.InvalidPropRenameError({
|
|
113
|
+
composable,
|
|
114
|
+
prop,
|
|
115
|
+
name: getRenamedName(prop, renames[prop]),
|
|
116
|
+
reason: "unknown"
|
|
117
|
+
});
|
|
118
|
+
const renamed = {};
|
|
119
|
+
for (const [prop, definition] of Object.entries(props)) {
|
|
120
|
+
const rename = renames[prop];
|
|
121
|
+
const name = getRenamedName(prop, rename);
|
|
122
|
+
if (rename !== void 0 && name === "children") throw new require_errors.InvalidPropRenameError({
|
|
123
|
+
composable,
|
|
124
|
+
prop,
|
|
125
|
+
name,
|
|
126
|
+
reason: "reserved"
|
|
127
|
+
});
|
|
128
|
+
if (Object.hasOwn(renamed, name)) throw new require_errors.InvalidPropRenameError({
|
|
129
|
+
composable,
|
|
130
|
+
prop,
|
|
131
|
+
name,
|
|
132
|
+
reason: "duplicate"
|
|
133
|
+
});
|
|
134
|
+
renamed[name] = rename !== void 0 && typeof rename !== "string" ? rename.schema : definition;
|
|
135
|
+
}
|
|
136
|
+
return renamed;
|
|
137
|
+
}
|
|
92
138
|
function resolvePresetComposableCallProps(presetKey, propDefinitions, callProps) {
|
|
93
139
|
const presetKeys = Object.keys(propDefinitions);
|
|
94
140
|
const contextValues = useComposablePresetProps(presetKey) ?? {};
|
|
95
|
-
const presetValues = Object.fromEntries(presetKeys.map((key) => [key,
|
|
96
|
-
return (0, _jfdevelops_react_layout_validator.validateProps)(Object.fromEntries(Object.entries(propDefinitions).filter(([key
|
|
141
|
+
const presetValues = Object.fromEntries(presetKeys.map((key) => [key, Object.hasOwn(callProps, key) ? callProps[key] : contextValues[key]]));
|
|
142
|
+
return (0, _jfdevelops_react_layout_validator.validateProps)(Object.fromEntries(Object.entries(propDefinitions).filter(([key]) => Object.hasOwn(callProps, key) || !Object.hasOwn(contextValues, key))), presetValues);
|
|
97
143
|
}
|
|
98
144
|
function defineComposableComponent(options) {
|
|
99
|
-
const { name,
|
|
145
|
+
const { name, wrapWith } = options;
|
|
146
|
+
const props = require_custom_props.normalizeComposableProps(options.props ?? {});
|
|
147
|
+
function extend(customization) {
|
|
148
|
+
const customName = customization.name ?? name;
|
|
149
|
+
const overrides = typeof customization.props === "function" ? customization.props(props) : customization.props;
|
|
150
|
+
return defineComposableComponent({
|
|
151
|
+
...options,
|
|
152
|
+
name: customName,
|
|
153
|
+
props: {
|
|
154
|
+
...renamePropDefinitions(customName, props, customization.rename ?? {}),
|
|
155
|
+
...overrides
|
|
156
|
+
},
|
|
157
|
+
wrapWith: "wrapWith" in customization ? customization.wrapWith : wrapWith
|
|
158
|
+
});
|
|
159
|
+
}
|
|
100
160
|
const factory = (definition) => {
|
|
101
161
|
if (typeof definition !== "function") {
|
|
102
|
-
const
|
|
103
|
-
return
|
|
104
|
-
...options,
|
|
105
|
-
name: definition.name ?? name,
|
|
106
|
-
props: {
|
|
107
|
-
...props,
|
|
108
|
-
...overrides
|
|
109
|
-
},
|
|
110
|
-
wrapWith: "wrapWith" in definition ? definition.wrapWith : wrapWith
|
|
111
|
-
})(definition.render);
|
|
162
|
+
const { render: customRender, ...customization } = definition;
|
|
163
|
+
return extend(customization)(customRender);
|
|
112
164
|
}
|
|
113
165
|
const render = definition;
|
|
114
166
|
const component = createComposableComponent({
|
|
@@ -150,8 +202,69 @@ function defineComposableComponent(options) {
|
|
|
150
202
|
enumerable: true,
|
|
151
203
|
value: props
|
|
152
204
|
});
|
|
205
|
+
Object.defineProperty(factory, "extend", { value: extend });
|
|
153
206
|
return factory;
|
|
154
207
|
}
|
|
208
|
+
function resolveComposableContext(entries, options) {
|
|
209
|
+
const rest = { ...options };
|
|
210
|
+
let isCustomized = false;
|
|
211
|
+
const values = Object.fromEntries(Object.entries(entries).map(([key, entry]) => {
|
|
212
|
+
if (!Object.hasOwn(options, key) || options[key] === void 0) return [key, entry.value];
|
|
213
|
+
const option = options[key];
|
|
214
|
+
const supplied = typeof option === "function" ? option(entry.value) : option;
|
|
215
|
+
delete rest[key];
|
|
216
|
+
isCustomized = true;
|
|
217
|
+
return [key, entry.handler ? entry.handler({
|
|
218
|
+
value: entry.value,
|
|
219
|
+
supplied
|
|
220
|
+
}) : supplied];
|
|
221
|
+
}));
|
|
222
|
+
return {
|
|
223
|
+
isCustomized,
|
|
224
|
+
rest,
|
|
225
|
+
values
|
|
226
|
+
};
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* Starts a defined composable whose definition depends on values a caller
|
|
230
|
+
* may change. `handler` receives those values and returns the definition.
|
|
231
|
+
*/
|
|
232
|
+
function defineContext(entries) {
|
|
233
|
+
const contextEntries = entries;
|
|
234
|
+
return {
|
|
235
|
+
/**
|
|
236
|
+
* Defines the composable from the context values. It runs with the
|
|
237
|
+
* defaults, and again for a caller that changes a value.
|
|
238
|
+
*/
|
|
239
|
+
handler(define) {
|
|
240
|
+
function createFactory(values) {
|
|
241
|
+
return defineComposableComponent(define(values));
|
|
242
|
+
}
|
|
243
|
+
const base = createFactory(resolveComposableContext(contextEntries, {}).values);
|
|
244
|
+
function select(options) {
|
|
245
|
+
const { isCustomized, rest, values } = resolveComposableContext(contextEntries, options);
|
|
246
|
+
return {
|
|
247
|
+
factory: isCustomized ? createFactory(values) : base,
|
|
248
|
+
rest
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
const contextual = (definition) => {
|
|
252
|
+
if (typeof definition === "function") return base(definition);
|
|
253
|
+
const { factory, rest } = select(definition);
|
|
254
|
+
return factory(rest);
|
|
255
|
+
};
|
|
256
|
+
Object.defineProperty(contextual, "props", {
|
|
257
|
+
enumerable: true,
|
|
258
|
+
value: base.props
|
|
259
|
+
});
|
|
260
|
+
Object.defineProperty(contextual, "extend", { value: (customization) => {
|
|
261
|
+
const { factory, rest } = select(customization);
|
|
262
|
+
return factory.extend(rest);
|
|
263
|
+
} });
|
|
264
|
+
return contextual;
|
|
265
|
+
} };
|
|
266
|
+
}
|
|
267
|
+
defineComposableComponent.defineContext = defineContext;
|
|
155
268
|
function makeComposable() {
|
|
156
269
|
return function(options) {
|
|
157
270
|
const { components, name: layoutName } = options;
|
package/dist/composable.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"composable.cjs","names":["Comp","InvalidComponentsError","EmptyComponentsError"],"sources":["../src/composable.tsx"],"sourcesContent":["import { ComponentType, createContext, ReactNode, useContext, cloneElement, isValidElement } from 'react';\nimport { EmptyComponentsError, InvalidComponentsError } from './errors';\nimport {\n AnyBuiltPropDefinition,\n type PropValidationContext,\n ResolveLayoutProps,\n ResolveProps,\n ResolveInputProps,\n ResolveLayoutInputProps,\n type StandardSchemaV1,\n isStandardSchema,\n resolvePropDefinitionValues,\n validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport { InPropsObject, type WithChildren } from './types';\nimport { BaseComponent, Show, UnionToIntersection } from './utils';\nimport { CapitalizeFn } from './utils/capitalize';\n\nexport const composablePresetMetaKey = Symbol.for(\n 'view-map.composable-preset-meta'\n);\n\nconst validatedComposableProps = Symbol('validatedComposableProps');\n\nexport type ComposablePresetMeta<Props extends InPropsObject = InPropsObject> =\n {\n key: string;\n props: Props;\n };\n\nexport type ComposablePresetProps = Record<string, Record<string, unknown>>;\n\nconst composablePresetPropsContext = createContext<\n ComposablePresetProps | undefined\n>(undefined);\n\nexport function LayoutComposablePresetProvider({\n value,\n children,\n}: {\n value: ComposablePresetProps;\n children: ReactNode;\n}) {\n return (\n <composablePresetPropsContext.Provider value={value}>\n {children}\n </composablePresetPropsContext.Provider>\n );\n}\n\nfunction useComposablePresetProps(key: string) {\n return useContext(composablePresetPropsContext)?.[key];\n}\n\nexport function collectComposablePresetEntries(\n composables: ComposableComponents | undefined\n) {\n if (!composables) {\n return [] as Array<{\n key: string;\n props: InPropsObject;\n }>;\n }\n\n return Object.entries(composables).flatMap(([objectKey, component]) => {\n const meta = (component as ComposablePresetComponent)[\n composablePresetMetaKey\n ];\n\n if (!meta) {\n return [];\n }\n\n return [\n {\n key: meta.key ?? objectKey,\n props: meta.props,\n },\n ];\n });\n}\n\nexport function resolveComposablePresetProps(\n composables: ComposableComponents | undefined,\n layoutOptions: Record<string, unknown>,\n context?: PropValidationContext\n) {\n const resolved: ComposablePresetProps = {};\n\n for (const { key, props } of collectComposablePresetEntries(composables)) {\n const propKeys = Object.keys(props);\n const values = Object.fromEntries(\n propKeys.flatMap((propKey) => {\n if (!(propKey in layoutOptions)) {\n return [];\n }\n\n return [[propKey, layoutOptions[propKey]]];\n })\n );\n\n resolved[key] = validateProps(\n props as Record<string, AnyBuiltPropDefinition>,\n values,\n context\n );\n }\n\n return resolved;\n}\n\nexport type ComposableNameContext<\n Resource extends string,\n LayoutName extends string = string\n> = {\n resource: Resource;\n name: LayoutName;\n capitalize: CapitalizeFn;\n};\n\ntype ComposableComponentName<\n Name extends string,\n Resource extends string,\n LayoutName extends string = string\n> = Name | ((ctx: ComposableNameContext<Resource, LayoutName>) => Name);\n\ntype CreateComposableComponentOptions<\n Name extends string,\n Wrapper,\n Resource extends string,\n LayoutName extends string = string,\n InProps extends InPropsObject = {},\n OutProps = {}\n> = {\n name: ComposableComponentName<Name, Resource, LayoutName>;\n inProps?: InProps;\n outProps?: (props: Show<ResolveProps<InProps>>) => OutProps;\n wrapWith?: Wrapper;\n};\n\ntype ResolvedCreateComposableComponentOptions<\n Name extends string,\n Wrapper,\n Resource extends string,\n LayoutName extends string = string,\n InProps extends InPropsObject = {},\n OutProps = {}\n> = Omit<\n CreateComposableComponentOptions<\n Name,\n Wrapper,\n Resource,\n LayoutName,\n InProps,\n OutProps\n >,\n 'name'\n> & {\n name: Name;\n};\n\nexport type CreateLayoutComposable<\n Resources extends string,\n LayoutName extends string = string\n> = <\n const Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {}\n>(\n options: CreateComposableComponentOptions<\n Name,\n Wrapper,\n Resources,\n LayoutName,\n InProps,\n OutProps\n >\n) => ComposableComponent<Name, Wrapper, InProps, OutProps>;\n\nexport type LayoutComposablesFactory<\n Resources extends string,\n LayoutName extends string = string\n> = (\n create: CreateLayoutComposable<Resources, LayoutName>\n) => ComposableComponents;\n\nexport type ResolveLayoutComposables<\n Factory extends LayoutComposablesFactory<string> | undefined\n> = Factory extends LayoutComposablesFactory<string> ? ReturnType<Factory> : {};\n\ntype ComposableComponentWrapperProps<Wrapper> = Wrapper extends ComponentType<\n infer Props\n>\n ? Omit<Props, 'children'>\n : {};\n\ntype ComposableComponentProps<\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {}\n> = ComposableComponentWrapperProps<Wrapper> &\n (keyof InProps extends never ? {} : ResolveInputProps<InProps>) & {\n children?: [keyof InProps] extends [never]\n ? ReactNode\n : ((props: OutProps) => JSX.Element) | ReactNode;\n };\n\nexport type ComposableComponent<\n Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {}\n> = BaseComponent<Name, ResolveInputProps<InProps>> & {\n (props: ComposableComponentProps<Wrapper, InProps, OutProps>): ReactNode;\n};\n\nexport type ComposableResourceLayout<\n Composables extends ComposableComponents,\n Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {}\n> = Composables & ComposableComponent<Name, Wrapper, InProps, OutProps>;\n\nexport type AnyComposableComponent = ComposableComponent<\n string,\n any,\n InPropsObject,\n any\n>;\n\n/**\n * Minimal callable shape shared by layout and preset composables.\n * Used as the record value so preset components keep their own prop types.\n */\nexport type ComposableComponentCallable = {\n displayName: string;\n props: unknown;\n (...args: any[]): ReactNode;\n};\n\n// Separate installed versions declare distinct unique symbols for the same\n// Symbol.for key. Read the metadata structurally so their presets interoperate.\ntype PresetPropsFromMetadata<Component> = {\n [Key in keyof Component]-?: Key extends symbol\n ? Component[Key] extends ComposablePresetMeta<infer Props>\n ? Props\n : never\n : never;\n}[keyof Component];\n\nexport type PresetPropsFromComposable<Component> = Component extends {\n [composablePresetMetaKey]: ComposablePresetMeta<infer Props>;\n}\n ? Props\n : [PresetPropsFromMetadata<Component>] extends [never]\n ? {}\n : PresetPropsFromMetadata<Component>;\n\nexport type MergePresetProps<Composables extends ComposableComponents> = Show<\n UnionToIntersection<PresetPropsFromComposable<Composables[keyof Composables]>>\n>;\n\nexport type RequiredPresetRenderProps<Props extends InPropsObject> = {\n [K in keyof ResolveProps<Props> & string]-?: ResolveProps<Props>[K];\n};\n\ntype SchemaDefinitions<Props extends InPropsObject> = {\n [Key in keyof Props as Props[Key] extends StandardSchemaV1 ? Key : never]: Props[Key];\n};\n\ntype PresetInputProps<Props extends InPropsObject> =\n ResolveInputProps<SchemaDefinitions<Props>> &\n RequiredPresetRenderProps<Omit<Props, keyof SchemaDefinitions<Props>>>;\n\nexport type ComposablePresetComponentCallProps<\n Props extends InPropsObject,\n Wrapper = undefined\n> = WithChildren<PresetInputProps<Props>> &\n (Wrapper extends undefined ? {} : ComposableComponentWrapperProps<Wrapper>);\n\nexport type ComposablePresetComponent<\n Name extends string = string,\n Props extends InPropsObject = InPropsObject,\n Wrapper = undefined\n> = BaseComponent<Name, Show<WithChildren<ResolveInputProps<Props>>>> & {\n [composablePresetMetaKey]: ComposablePresetMeta<Props>;\n} & ((props: ComposablePresetComponentCallProps<Props, Wrapper>) => ReactNode);\n\ntype PresetPropDefinitions<Composables extends ComposableComponents> =\n MergePresetProps<Composables> extends InPropsObject\n ? MergePresetProps<Composables>\n : {};\n\ntype PresetLayoutInputProps<Props extends InPropsObject> =\n ResolveLayoutInputProps<SchemaDefinitions<Props>> & {\n [Key in keyof ResolveLayoutProps<Omit<Props, keyof SchemaDefinitions<Props>>>]-?:\n ResolveLayoutProps<Omit<Props, keyof SchemaDefinitions<Props>>>[Key];\n };\n\nexport type RequiredPresetLayoutProps<Composables extends ComposableComponents> =\n PresetLayoutInputProps<PresetPropDefinitions<Composables>>;\n\nexport type ComposableComponents = Record<string, ComposableComponentCallable>;\n\nexport type ResolvedComposableComponents<\n Components extends ComposableComponents\n> = [keyof Components] extends [never]\n ? never\n : Components extends { Layout: infer _ }\n ? Components\n : 'The Layout composable is required';\n\nfunction resolveComponent<Props>(\n component: ((props: Props) => JSX.Element | ReactNode) | ReactNode,\n props: Props\n) {\n return typeof component === 'function' ? component(props) : component;\n}\n\nfunction reactNodeFromSingleFieldOutProps(resolved: unknown): ReactNode {\n if (resolved === null || typeof resolved !== 'object') {\n return null;\n }\n\n const values = Object.values(resolved);\n\n if (values.length !== 1) {\n return null;\n }\n\n return values[0] as ReactNode;\n}\n\nfunction resolveComposableComponentName<\n Name extends string,\n Resource extends string,\n LayoutName extends string\n>(\n name: ComposableComponentName<Name, Resource, LayoutName>,\n ctx: ComposableNameContext<Resource, LayoutName>\n): Name {\n return typeof name === 'function' ? name(ctx) : name;\n}\n\nexport function createLayoutComposableFactory<\n Resources extends string,\n LayoutName extends string\n>(ctx: ComposableNameContext<Resources, LayoutName>) {\n const create: CreateLayoutComposable<Resources, LayoutName> = <\n const Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {}\n >(\n options: CreateComposableComponentOptions<\n Name,\n Wrapper,\n Resources,\n LayoutName,\n InProps,\n OutProps\n >\n ) =>\n createComposableComponent({\n ...options,\n name: resolveComposableComponentName(options.name, ctx),\n } as ResolvedCreateComposableComponentOptions<Name, Wrapper, Resources, LayoutName, InProps, OutProps>);\n\n return create;\n}\n\nexport function resolveLayoutComposables<\n Resources extends string,\n LayoutName extends string,\n Composables extends ComposableComponents\n>(\n factory: (\n create: CreateLayoutComposable<Resources, LayoutName>\n ) => Composables,\n ctx: ComposableNameContext<Resources, LayoutName>\n): Composables {\n return factory(createLayoutComposableFactory(ctx));\n}\n\nexport function createComposableComponent<\n const Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {}\n>(\n options: ResolvedCreateComposableComponentOptions<\n Name,\n Wrapper,\n string,\n string,\n InProps,\n OutProps\n >\n) {\n const { name, inProps = {} as InProps, outProps, wrapWith } = options;\n\n function Composable({\n children,\n ...props\n }: ComposableComponentProps<Wrapper, InProps, OutProps>) {\n const inPropsKeys = Object.keys(inProps as object) as (keyof InProps &\n string)[];\n const mergedInProps = { ...inProps };\n const propsRecord = props as Record<string, unknown>;\n\n for (const key of inPropsKeys) {\n if (key in propsRecord) {\n (mergedInProps as Record<string, unknown>)[key] = propsRecord[key];\n }\n }\n\n const wrapperProps = {\n ...propsRecord,\n } as ComposableComponentWrapperProps<Wrapper>;\n\n for (const key of inPropsKeys) {\n delete (wrapperProps as Record<string, unknown>)[key];\n }\n\n const mergedValues = resolvePropDefinitionValues(mergedInProps as Record<string, unknown>);\n const alreadyValidated = (options as unknown as Record<symbol, unknown>)[validatedComposableProps];\n const schemaDefinitions = alreadyValidated ? {} : Object.fromEntries(\n Object.entries(inProps ?? {}).filter(([, definition]) => isStandardSchema(definition)),\n );\n const mergedResolved = validateProps(schemaDefinitions, mergedValues) as Show<ResolveProps<InProps>>;\n\n const resolvedProps = outProps\n ? outProps(mergedResolved)\n : ({} as OutProps);\n const resolvedChildren =\n children == null\n ? reactNodeFromSingleFieldOutProps(resolvedProps)\n : resolveComponent(children, resolvedProps);\n\n if (wrapWith) {\n const Comp = wrapWith as ComponentType<\n ComposableComponentWrapperProps<Wrapper>\n >;\n\n return <Comp {...wrapperProps}>{resolvedChildren}</Comp>;\n }\n\n // A single intrinsic child is the composable's root without adding a wrapper.\n if (propsRecord['data-rl-node'] && isValidElement(resolvedChildren) && typeof resolvedChildren.type === 'string') {\n return cloneElement(resolvedChildren, {\n 'data-rl-node': propsRecord['data-rl-node'],\n 'data-rl-composable': propsRecord['data-rl-composable'],\n 'data-rl-owners': propsRecord['data-rl-owners'],\n } as Record<string, unknown>);\n }\n return resolvedChildren;\n }\n\n Composable.displayName = name;\n\n const debugKey = Symbol.for('@jfdevelops/react-layout/debug');\n const debug = (options as unknown as Record<symbol, unknown>)[debugKey];\n\n return Object.assign(Composable, {\n ...(debug ? { [debugKey]: debug } : {}),\n props: undefined as unknown as ResolveProps<InProps>,\n }) as unknown as ComposableComponent<Name, Wrapper, InProps, OutProps>;\n}\n\ntype DefineComposableComponentOptions<\n Name extends string,\n Props extends InPropsObject,\n Wrapper = undefined\n> = {\n name: Name;\n props?: Props;\n wrapWith?: Wrapper;\n};\n\nexport type DefinedComposableComponentRecord<\n Name extends string,\n Props extends InPropsObject = {},\n Wrapper = undefined\n> = {\n [K in Name]: ComposablePresetComponent<Name, Props, Wrapper>;\n};\n\ntype DefinedComposableComponentFactory<\n Name extends string,\n Props extends InPropsObject,\n Wrapper = undefined,\n> = {\n props: Props;\n (\n render: (props: Show<WithChildren<ResolveProps<Props>>>) => ReactNode,\n ): DefinedComposableComponentRecord<Name, Props, Wrapper>;\n /** Customize this instance without changing the factory's defaults. */\n <\n const Overrides extends InPropsObject = {},\n const CustomName extends string = Name,\n CustomWrapper = Wrapper,\n >(options: {\n name?: CustomName;\n props?: Overrides | ((defaults: Props) => Overrides);\n wrapWith?: CustomWrapper;\n render: (\n props: Show<\n WithChildren<ResolveProps<Omit<Props, keyof Overrides> & Overrides>>\n >,\n ) => ReactNode;\n }): DefinedComposableComponentRecord<\n CustomName,\n Omit<Props, keyof Overrides> & Overrides,\n CustomWrapper\n >;\n};\n\nfunction resolvePresetComposableCallProps<Props extends InPropsObject>(\n presetKey: string,\n propDefinitions: Props,\n callProps: Record<string, unknown>\n) {\n const presetKeys = Object.keys(propDefinitions) as (keyof Props & string)[];\n const contextValues = useComposablePresetProps(presetKey) ?? {};\n const presetValues = Object.fromEntries(\n presetKeys.map((key) => [key,\n isStandardSchema(propDefinitions[key]) && Object.hasOwn(callProps, key)\n ? callProps[key]\n : callProps[key] ?? contextValues[key],\n ])\n );\n // Context values have already been validated by the owning layout.\n const definitions = Object.fromEntries(\n Object.entries(propDefinitions).filter(([key, definition]) =>\n !isStandardSchema(definition) || Object.hasOwn(callProps, key) || !Object.hasOwn(contextValues, key),\n ),\n );\n\n return validateProps(\n definitions,\n presetValues\n ) as Show<WithChildren<ResolveProps<Props>>>;\n}\n\nexport function defineComposableComponent<\n const Name extends string,\n Props extends InPropsObject = {},\n Wrapper = undefined\n>(\n options: DefineComposableComponentOptions<Name, Props, Wrapper>\n): DefinedComposableComponentFactory<Name, Props, Wrapper> {\n const { name, props = {} as Props, wrapWith } = options;\n\n const factory = (\n definition:\n | ((props: Show<WithChildren<ResolveProps<Props>>>) => ReactNode)\n | {\n name?: string;\n props?: InPropsObject | ((defaults: Props) => InPropsObject);\n wrapWith?: unknown;\n render: (props: any) => ReactNode;\n }\n ): DefinedComposableComponentRecord<Name, Props, Wrapper> => {\n if (typeof definition !== 'function') {\n const overrides =\n typeof definition.props === 'function'\n ? definition.props(props)\n : definition.props;\n\n return defineComposableComponent({\n ...options,\n name: definition.name ?? name,\n props: { ...props, ...overrides },\n wrapWith: 'wrapWith' in definition ? definition.wrapWith : wrapWith,\n })(definition.render) as unknown as DefinedComposableComponentRecord<\n Name,\n Props,\n Wrapper\n >;\n }\n\n const render = definition;\n const component = createComposableComponent<\n Name,\n Wrapper,\n Props,\n Show<WithChildren<ResolveProps<Props>>>\n >({\n name,\n wrapWith,\n inProps: props,\n outProps: (resolved) => resolved,\n ...{ [validatedComposableProps]: true },\n });\n\n function PresetComposable(\n callProps: ComposablePresetComponentCallProps<Props, Wrapper>\n ) {\n const callPropsRecord = callProps as Record<string, unknown>;\n const presetKeys = Object.keys(props) as (keyof Props & string)[];\n const validatedPresetProps = resolvePresetComposableCallProps(\n name,\n props,\n callPropsRecord\n );\n const wrapperProps = { ...callPropsRecord };\n\n for (const key of presetKeys) {\n delete wrapperProps[key];\n }\n\n return component({\n ...(wrapperProps as ComposableComponentWrapperProps<Wrapper>),\n ...validatedPresetProps,\n children: (resolved: Show<WithChildren<ResolveProps<Props>>>) => render({\n ...resolved,\n children: 'children' in props\n ? (validatedPresetProps as Record<string, unknown>).children\n : callPropsRecord.children,\n } as Show<WithChildren<ResolveProps<Props>>>),\n } as unknown as ComposableComponentProps<Wrapper, Props, Show<WithChildren<ResolveProps<Props>>>>);\n }\n\n PresetComposable.displayName = name;\n\n const debugKey = Symbol.for('@jfdevelops/react-layout/debug');\n const debug = (options as unknown as Record<symbol, unknown>)[debugKey];\n const presetComponent = Object.assign(PresetComposable, {\n ...(debug ? { [debugKey]: debug } : {}),\n props: undefined as unknown as Show<WithChildren<ResolveProps<Props>>>,\n [composablePresetMetaKey]: {\n key: name,\n props,\n } satisfies ComposablePresetMeta<Props>,\n }) as unknown as DefinedComposableComponentRecord<\n Name,\n Props,\n Wrapper\n >[Name];\n\n return {\n [name]: presetComponent,\n } as DefinedComposableComponentRecord<Name, Props, Wrapper>;\n };\n\n Object.defineProperty(factory, 'props', {\n enumerable: true,\n value: props,\n });\n\n return factory as DefinedComposableComponentFactory<Name, Props, Wrapper>;\n}\n\nexport type MakeComposableOptions<\n Composables extends ComposableComponents,\n Name extends string\n> = { components: Composables | undefined; name: Name };\n\nexport type MakeComposable<\n Composables extends ComposableComponents,\n Name extends string\n> = <OverrideName extends string = Name>(\n options?: Partial<\n Pick<MakeComposableOptions<Composables, OverrideName>, 'name'>\n >\n) => ComposableResourceLayout<Composables, Name, any, any, any>;\n\nexport function makeComposable<Props>() {\n return function <\n Composables extends ComposableComponents,\n Name extends string\n >(options: MakeComposableOptions<Composables, Name>) {\n const { components, name: layoutName } = options;\n\n if (!components || typeof components !== 'object') {\n throw new InvalidComponentsError('components must be an object');\n }\n\n const componentNames = Object.keys(components);\n\n if (componentNames.length === 0) {\n throw new EmptyComponentsError(\n 'components must have at least one component'\n );\n }\n\n const create: MakeComposable<Composables, Name> = (overrideOptions) => {\n const resolvedName = overrideOptions?.name ?? layoutName;\n const { Layout, ...rest } = components;\n\n return Object.assign(Layout, {\n displayName: resolvedName,\n props: undefined as unknown as Props,\n ...rest,\n }) as unknown as ComposableResourceLayout<\n Composables,\n Name,\n any,\n any,\n any\n >;\n };\n\n return create;\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"composable.cjs","names":["ConflictingPresetPropError","Comp","InvalidPropRenameError","normalizeComposableProps","InvalidComponentsError","EmptyComponentsError"],"sources":["../src/composable.tsx"],"sourcesContent":["import {\n ComponentType,\n createContext,\n ReactNode,\n useContext,\n cloneElement,\n isValidElement,\n} from 'react';\nimport {\n ConflictingPresetPropError,\n EmptyComponentsError,\n InvalidComponentsError,\n InvalidPropRenameError,\n} from './errors';\nimport {\n type NormalizePropDefinitions,\n PropDefinition,\n type PropValidationContext,\n type PropValidator,\n ResolveProps,\n ResolveInputProps,\n type StandardSchemaV1,\n resolvePropDefinitionValues,\n validateProps,\n} from '@jfdevelops/react-layout-validator';\nimport {\n type ComposableProps,\n type ComposablePropDefinition,\n type ComposablePropsInput,\n type NormalizeComposableProps,\n normalizeComposableProps,\n} from './custom-props';\nimport { InPropsObject, type WithChildren } from './types';\nimport type {\n BaseComponent,\n CapitalizeFn,\n Show,\n UnionToIntersection,\n} from '@jfdevelops/react-layout-internals';\n\nexport const composablePresetMetaKey = Symbol.for(\n 'view-map.composable-preset-meta',\n);\n\nconst validatedComposableProps = Symbol('validatedComposableProps');\n\nexport type ComposablePresetMeta<Props extends InPropsObject = InPropsObject> =\n {\n key: string;\n props: Props;\n };\n\nexport type ComposablePresetProps = Record<string, Record<string, unknown>>;\n\nconst composablePresetPropsContext = createContext<\n ComposablePresetProps | undefined\n>(undefined);\n\nexport function LayoutComposablePresetProvider({\n value,\n children,\n}: {\n value: ComposablePresetProps;\n children: ReactNode;\n}) {\n return (\n <composablePresetPropsContext.Provider value={value}>\n {children}\n </composablePresetPropsContext.Provider>\n );\n}\n\nfunction useComposablePresetProps(key: string) {\n return useContext(composablePresetPropsContext)?.[key];\n}\n\nexport function collectComposablePresetEntries(\n composables: ComposableComponents | undefined,\n) {\n if (!composables) {\n return [] as Array<{\n key: string;\n props: InPropsObject;\n }>;\n }\n\n const declared = new Map<\n string,\n {\n composable: string;\n definition: PropDefinition;\n }\n >();\n\n return Object.entries(composables).flatMap(([objectKey, component]) => {\n const meta = (component as ComposablePresetComponent)[\n composablePresetMetaKey\n ];\n\n if (!meta) {\n return [];\n }\n\n const key = meta.key ?? objectKey;\n\n // One page value feeds every preset declaring a prop, so the definitions\n // must be the same one.\n for (const [prop, definition] of Object.entries(meta.props)) {\n const existing = declared.get(prop);\n\n if (existing && existing.definition !== definition) {\n throw new ConflictingPresetPropError({\n prop,\n composables: [existing.composable, key],\n });\n }\n\n declared.set(prop, {\n composable: key,\n definition,\n });\n }\n\n return [\n {\n key,\n props: meta.props,\n },\n ];\n });\n}\n\nexport function resolveComposablePresetProps(\n composables: ComposableComponents | undefined,\n layoutOptions: Record<string, unknown>,\n context?: PropValidationContext,\n) {\n const resolved: ComposablePresetProps = {};\n\n for (const { key, props } of collectComposablePresetEntries(composables)) {\n const propKeys = Object.keys(props);\n const values = Object.fromEntries(\n propKeys.flatMap((propKey) => {\n if (!(propKey in layoutOptions)) {\n return [];\n }\n\n return [[propKey, layoutOptions[propKey]]];\n }),\n );\n\n resolved[key] = validateProps(\n props as Record<string, PropDefinition>,\n values,\n context,\n );\n }\n\n return resolved;\n}\n\nexport type ComposableNameContext<\n Resource extends string,\n LayoutName extends string = string,\n> = {\n resource: Resource;\n name: LayoutName;\n capitalize: CapitalizeFn;\n};\n\ntype ComposableComponentName<\n Name extends string,\n Resource extends string,\n LayoutName extends string = string,\n> = Name | ((ctx: ComposableNameContext<Resource, LayoutName>) => Name);\n\ntype CreateComposableComponentOptions<\n Name extends string,\n Wrapper,\n Resource extends string,\n LayoutName extends string = string,\n InProps extends InPropsObject = {},\n OutProps = {},\n> = {\n name: ComposableComponentName<Name, Resource, LayoutName>;\n inProps?: InProps;\n outProps?: (props: Show<ResolveProps<InProps>>) => OutProps;\n wrapWith?: Wrapper;\n};\n\ntype ResolvedCreateComposableComponentOptions<\n Name extends string,\n Wrapper,\n Resource extends string,\n LayoutName extends string = string,\n InProps extends InPropsObject = {},\n OutProps = {},\n> = Omit<\n CreateComposableComponentOptions<\n Name,\n Wrapper,\n Resource,\n LayoutName,\n InProps,\n OutProps\n >,\n 'name'\n> & {\n name: Name;\n};\n\nexport type CreateLayoutComposable<\n Resources extends string,\n LayoutName extends string = string,\n> = <\n const Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {},\n>(\n options: CreateComposableComponentOptions<\n Name,\n Wrapper,\n Resources,\n LayoutName,\n InProps,\n OutProps\n >,\n) => ComposableComponent<Name, Wrapper, InProps, OutProps>;\n\nexport type LayoutComposablesFactory<\n Resources extends string,\n LayoutName extends string = string,\n> = (\n create: CreateLayoutComposable<Resources, LayoutName>,\n) => ComposableComponents;\n\nexport type ResolveLayoutComposables<\n Factory extends LayoutComposablesFactory<string> | undefined,\n> = Factory extends LayoutComposablesFactory<string> ? ReturnType<Factory> : {};\n\ntype ComposableComponentWrapperProps<Wrapper> =\n Wrapper extends ComponentType<infer Props> ? Omit<Props, 'children'> : {};\n\ntype ComposableComponentProps<\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {},\n> = ComposableComponentWrapperProps<Wrapper> &\n (keyof InProps extends never ? {} : ResolveInputProps<InProps>) & {\n children?: [keyof InProps] extends [never]\n ? ReactNode\n : ((props: OutProps) => JSX.Element) | ReactNode;\n };\n\nexport type ComposableComponent<\n Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {},\n> = BaseComponent<Name, ResolveInputProps<InProps>> & {\n (props: ComposableComponentProps<Wrapper, InProps, OutProps>): ReactNode;\n};\n\nexport type ComposableResourceLayout<\n Composables extends ComposableComponents,\n Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {},\n> = Composables & ComposableComponent<Name, Wrapper, InProps, OutProps>;\n\nexport type AnyComposableComponent = ComposableComponent<\n string,\n any,\n InPropsObject,\n any\n>;\n\n/**\n * Minimal callable shape shared by layout and preset composables.\n * Used as the record value so preset components keep their own prop types.\n */\nexport type ComposableComponentCallable = {\n displayName: string;\n props: unknown;\n (...args: any[]): ReactNode;\n};\n\n// Separate installed versions declare distinct unique symbols for the same\n// Symbol.for key. Read the metadata structurally so their presets interoperate.\ntype PresetPropsFromMetadata<Component> = {\n [Key in keyof Component]-?: Key extends symbol\n ? Component[Key] extends ComposablePresetMeta<infer Props>\n ? Props\n : never\n : never;\n}[keyof Component];\n\nexport type PresetPropsFromComposable<Component> = Component extends {\n [composablePresetMetaKey]: ComposablePresetMeta<infer Props>;\n}\n ? Props\n : [PresetPropsFromMetadata<Component>] extends [never]\n ? {}\n : PresetPropsFromMetadata<Component>;\n\nexport type MergePresetProps<Composables extends ComposableComponents> = Show<\n UnionToIntersection<PresetPropsFromComposable<Composables[keyof Composables]>>\n>;\n\nexport type RequiredPresetRenderProps<Props extends InPropsObject> = {\n [K in keyof ResolveProps<Props> & string]-?: ResolveProps<Props>[K];\n};\n\ntype SchemaDefinitions<Props extends InPropsObject> = {\n [\n Key in keyof Props as Props[Key] extends StandardSchemaV1 ? Key : never\n ]: Props[Key];\n};\n\ntype PresetInputProps<Props extends InPropsObject> = ResolveInputProps<\n SchemaDefinitions<Props>\n> &\n RequiredPresetRenderProps<Omit<Props, keyof SchemaDefinitions<Props>>>;\n\nexport type ComposablePresetComponentCallProps<\n Props extends InPropsObject,\n Wrapper = undefined,\n> = WithChildren<PresetInputProps<Props>> &\n (Wrapper extends undefined ? {} : ComposableComponentWrapperProps<Wrapper>);\n\nexport type ComposablePresetComponent<\n Name extends string = string,\n Props extends InPropsObject = InPropsObject,\n Wrapper = undefined,\n> = BaseComponent<Name, Show<WithChildren<ResolveInputProps<Props>>>> & {\n [composablePresetMetaKey]: ComposablePresetMeta<Props>;\n} & ((props: ComposablePresetComponentCallProps<Props, Wrapper>) => ReactNode);\n\ntype PresetPropDefinitions<Composables extends ComposableComponents> =\n MergePresetProps<Composables> extends InPropsObject\n ? MergePresetProps<Composables>\n : {};\n\ntype PresetLayoutInputProps<Props extends InPropsObject> = ResolveInputProps<\n SchemaDefinitions<Props>\n> & {\n [\n Key in keyof ResolveProps<Omit<Props, keyof SchemaDefinitions<Props>>>\n ]-?: ResolveProps<Omit<Props, keyof SchemaDefinitions<Props>>>[Key];\n};\n\nexport type RequiredPresetLayoutProps<\n Composables extends ComposableComponents,\n> = PresetLayoutInputProps<PresetPropDefinitions<Composables>>;\n\nexport type ComposableComponents = Record<string, ComposableComponentCallable>;\n\nexport type ResolvedComposableComponents<\n Components extends ComposableComponents,\n> = [keyof Components] extends [never]\n ? never\n : Components extends { Layout: infer _ }\n ? Components\n : 'The Layout composable is required';\n\nfunction resolveComponent<Props>(\n component: ((props: Props) => JSX.Element | ReactNode) | ReactNode,\n props: Props,\n) {\n return typeof component === 'function' ? component(props) : component;\n}\n\nfunction reactNodeFromSingleFieldOutProps(resolved: unknown): ReactNode {\n if (resolved === null || typeof resolved !== 'object') {\n return null;\n }\n\n const values = Object.values(resolved);\n\n if (values.length !== 1) {\n return null;\n }\n\n return values[0] as ReactNode;\n}\n\nfunction resolveComposableComponentName<\n Name extends string,\n Resource extends string,\n LayoutName extends string,\n>(\n name: ComposableComponentName<Name, Resource, LayoutName>,\n ctx: ComposableNameContext<Resource, LayoutName>,\n): Name {\n return typeof name === 'function' ? name(ctx) : name;\n}\n\nexport function createLayoutComposableFactory<\n Resources extends string,\n LayoutName extends string,\n>(ctx: ComposableNameContext<Resources, LayoutName>) {\n const create: CreateLayoutComposable<Resources, LayoutName> = <\n const Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {},\n >(\n options: CreateComposableComponentOptions<\n Name,\n Wrapper,\n Resources,\n LayoutName,\n InProps,\n OutProps\n >,\n ) =>\n createComposableComponent({\n ...options,\n name: resolveComposableComponentName(options.name, ctx),\n } as ResolvedCreateComposableComponentOptions<\n Name,\n Wrapper,\n Resources,\n LayoutName,\n InProps,\n OutProps\n >);\n\n return create;\n}\n\nexport function resolveLayoutComposables<\n Resources extends string,\n LayoutName extends string,\n Composables extends ComposableComponents,\n>(\n factory: (\n create: CreateLayoutComposable<Resources, LayoutName>,\n ) => Composables,\n ctx: ComposableNameContext<Resources, LayoutName>,\n): Composables {\n return factory(createLayoutComposableFactory(ctx));\n}\n\nexport function createComposableComponent<\n const Name extends string,\n Wrapper,\n InProps extends InPropsObject = {},\n OutProps = {},\n>(\n options: ResolvedCreateComposableComponentOptions<\n Name,\n Wrapper,\n string,\n string,\n InProps,\n OutProps\n >,\n) {\n const { name, inProps = {} as InProps, outProps, wrapWith } = options;\n\n function Composable({\n children,\n ...props\n }: ComposableComponentProps<Wrapper, InProps, OutProps>) {\n const inPropsKeys = Object.keys(inProps as object) as (keyof InProps &\n string)[];\n const mergedInProps = {\n ...inProps,\n };\n const propsRecord = props as Record<string, unknown>;\n\n for (const key of inPropsKeys) {\n if (key in propsRecord) {\n (mergedInProps as Record<string, unknown>)[key] = propsRecord[key];\n }\n }\n\n const wrapperProps = {\n ...propsRecord,\n } as ComposableComponentWrapperProps<Wrapper>;\n\n for (const key of inPropsKeys) {\n delete (wrapperProps as Record<string, unknown>)[key];\n }\n\n const mergedValues = resolvePropDefinitionValues(\n mergedInProps as Record<string, unknown>,\n );\n const alreadyValidated = (options as unknown as Record<symbol, unknown>)[\n validatedComposableProps\n ];\n const mergedResolved = validateProps(\n alreadyValidated ? {} : inProps,\n mergedValues,\n ) as Show<ResolveProps<InProps>>;\n\n const resolvedProps = outProps\n ? outProps(mergedResolved)\n : ({} as OutProps);\n const resolvedChildren =\n children == null\n ? reactNodeFromSingleFieldOutProps(resolvedProps)\n : resolveComponent(children, resolvedProps);\n\n if (wrapWith) {\n const Comp = wrapWith as ComponentType<\n ComposableComponentWrapperProps<Wrapper>\n >;\n\n return <Comp {...wrapperProps}>{resolvedChildren}</Comp>;\n }\n\n // A single intrinsic child is the composable's root without adding a wrapper.\n if (\n propsRecord['data-rl-node'] &&\n isValidElement(resolvedChildren) &&\n typeof resolvedChildren.type === 'string'\n ) {\n return cloneElement(resolvedChildren, {\n 'data-rl-node': propsRecord['data-rl-node'],\n 'data-rl-composable': propsRecord['data-rl-composable'],\n 'data-rl-owners': propsRecord['data-rl-owners'],\n } as Record<string, unknown>);\n }\n\n return resolvedChildren;\n }\n\n Composable.displayName = name;\n\n const debugKey = Symbol.for('@jfdevelops/react-layout/debug');\n const debug = (options as unknown as Record<symbol, unknown>)[debugKey];\n\n return Object.assign(Composable, {\n ...(debug\n ? {\n [debugKey]: debug,\n }\n : {}),\n props: undefined as unknown as ResolveProps<InProps>,\n }) as unknown as ComposableComponent<Name, Wrapper, InProps, OutProps>;\n}\n\ntype DefineComposableComponentOptions<\n Name extends string,\n Props extends ComposableProps,\n Wrapper = undefined,\n> = {\n name: Name;\n /**\n * The composable's custom props. This is the same object as `props.custom`\n * elsewhere in the library; a composable has no shared options to\n * `include`, so the `custom` key is left out. Each prop is a Standard\n * Schema or an inline validator, and `children: 'required'` is accepted.\n */\n props?: Props & ComposableProps & ComposablePropsInput<Props>;\n wrapWith?: Wrapper;\n};\n\nexport type DefinedComposableComponentRecord<\n Name extends string,\n Props extends InPropsObject = {},\n Wrapper = undefined,\n> = {\n [K in Name]: ComposablePresetComponent<Name, Props, Wrapper>;\n};\n\n/** A new name for a prop, or a new name together with a new definition. */\nexport type PropRename =\n | string\n | {\n name: string;\n schema: PropDefinition | PropValidator;\n };\n\n/** New names for a defined composable's props, keyed by their current names. */\nexport type PropRenames<Props extends InPropsObject> = {\n [Key in keyof Props]?: PropRename;\n};\n\ntype RenamedPropName<Key, Rename> = Rename extends string\n ? Rename\n : Rename extends { name: infer Name extends string }\n ? Name\n : Key;\n\ntype RenamedPropDefinition<Definition, Rename> = Rename extends {\n schema: infer Schema;\n}\n ? Schema extends PropDefinition\n ? Schema\n : NormalizePropDefinitions<{\n schema: Schema;\n }>['schema']\n : Definition;\n\n/** Applies a rename map to a defined composable's prop definitions. */\nexport type RenameProps<Props extends InPropsObject, Renames> = [\n keyof Renames,\n] extends [never]\n ? Props\n : {\n [\n Key in keyof Props as Key extends keyof Renames\n ? RenamedPropName<Key, Renames[Key]>\n : Key\n ]: Key extends keyof Renames\n ? RenamedPropDefinition<Props[Key], Renames[Key]>\n : Props[Key];\n };\n\ntype CustomizedProps<Props extends InPropsObject, Renames, Overrides> = Omit<\n RenameProps<Props, Renames>,\n keyof Overrides\n> &\n NormalizeComposableProps<Overrides>;\n\n// Lists the default props so an editor suggests them, and allows new ones.\ntype PropOverrides<Props extends InPropsObject> = {\n [Key in keyof Props]?: ComposablePropDefinition;\n} & ComposableProps;\n\n// Options every defined composable accepts; a context value cannot use them.\ntype ReservedComposableOption =\n | 'name'\n | 'props'\n | 'rename'\n | 'render'\n | 'wrapWith';\n\n// A default such as `['a', 'b'] as const` only shows the kind of value, so its\n// literals widen: a caller may supply any value of that kind.\ntype WidenContextValue<Value> = Value extends string\n ? string\n : Value extends number\n ? number\n : Value extends boolean\n ? boolean\n : Value extends bigint\n ? bigint\n : Value extends (...input: never[]) => unknown\n ? Value\n : Value extends ReadonlyArray<infer Item>\n ? ReadonlyArray<WidenContextValue<Item>>\n : Value extends object\n ? {\n [Key in keyof Value]: WidenContextValue<Value[Key]>;\n }\n : Value;\n\n/**\n * The context values a defined composable works with, typed from the\n * defaults it declares.\n */\nexport type ComposableContextValues<Defaults> = {\n [Key in keyof Defaults]: WidenContextValue<Defaults[Key]>;\n};\n\n/** One value a caller may change where a defined composable is used. */\nexport type ComposableContextEntry<Value> = {\n /**\n * The value used when the caller supplies none.\n */\n value: Value;\n /**\n * Decides the value to use from the default and what the caller supplied.\n * Without it, a supplied value replaces the default.\n */\n handler?: (input: {\n value: WidenContextValue<Value>;\n supplied: WidenContextValue<Value>;\n }) => WidenContextValue<Value>;\n};\n\n/** The context entries of a defined composable, keyed by option name. */\nexport type ComposableContextEntries<Values> = {\n [Key in keyof Values]: Key extends ReservedComposableOption\n ? never\n : ComposableContextEntry<Values[Key]>;\n};\n\n// A supplied function is always called with the default, so a value that is\n// itself a function can only be supplied by returning it from one.\ntype ComposableContextOption<Value> = Value extends (\n ...input: never[]\n) => unknown\n ? (value: Value) => Value\n : Value | ((value: Value) => Value);\n\n/**\n * What a caller may pass for each context value: the value itself, or a\n * function that receives the default and returns the value. A context value\n * that is a function is supplied the second way only.\n */\nexport type ComposableContextOptions<Context> = {\n [Key in keyof Context]?: ComposableContextOption<Context[Key]>;\n};\n\ntype CustomizeComposableOptions<\n Props extends InPropsObject,\n Renames,\n Overrides,\n CustomName extends string,\n CustomWrapper,\n Context = {},\n> = ComposableContextOptions<Context> & {\n name?: CustomName;\n /**\n * Rename default props. A string keeps the definition; an object also\n * replaces it.\n */\n rename?: Renames & PropRenames<Props>;\n /**\n * Replace default props or add new ones. A function receives the defaults.\n */\n props?: (Overrides & PropOverrides<Props>) | ((defaults: Props) => Overrides);\n wrapWith?: CustomWrapper;\n};\n\nexport type DefinedComposableComponentFactory<\n Name extends string,\n Props extends InPropsObject,\n Wrapper = undefined,\n Context = {},\n> = {\n props: Props;\n /**\n * Customize this instance without changing the factory's defaults.\n */\n <\n const Overrides extends ComposableProps = {},\n const CustomName extends string = Name,\n CustomWrapper = Wrapper,\n const Renames extends PropRenames<Props> = {},\n >(\n options: CustomizeComposableOptions<\n Props,\n Renames,\n Overrides,\n CustomName,\n CustomWrapper,\n Context\n > & {\n render: (\n props: Show<\n WithChildren<ResolveProps<CustomizedProps<Props, Renames, Overrides>>>\n >,\n ) => ReactNode;\n },\n ): DefinedComposableComponentRecord<\n CustomName,\n CustomizedProps<Props, Renames, Overrides>,\n CustomWrapper\n >;\n (\n render: (props: Show<WithChildren<ResolveProps<Props>>>) => ReactNode,\n ): DefinedComposableComponentRecord<Name, Props, Wrapper>;\n /**\n * Derive a factory with its own name, props, or wrapper. The original\n * factory is unchanged.\n */\n extend<\n const Renames extends PropRenames<Props> = {},\n const Overrides extends ComposableProps = {},\n const CustomName extends string = Name,\n CustomWrapper = Wrapper,\n >(\n options: CustomizeComposableOptions<\n Props,\n Renames,\n Overrides,\n CustomName,\n CustomWrapper,\n Context\n >,\n ): DefinedComposableComponentFactory<\n CustomName,\n CustomizedProps<Props, Renames, Overrides>,\n CustomWrapper\n >;\n};\n\nfunction getRenamedName(prop: string, rename: PropRename | undefined) {\n if (rename === undefined) {\n return prop;\n }\n\n return typeof rename === 'string' ? rename : rename.name;\n}\n\nfunction renamePropDefinitions(\n composable: string,\n props: InPropsObject,\n renames: Record<string, PropRename | undefined>,\n) {\n for (const prop of Object.keys(renames)) {\n if (renames[prop] !== undefined && !Object.hasOwn(props, prop)) {\n throw new InvalidPropRenameError({\n composable,\n prop,\n name: getRenamedName(prop, renames[prop]),\n reason: 'unknown',\n });\n }\n }\n\n const renamed: ComposableProps = {};\n\n for (const [prop, definition] of Object.entries(props)) {\n const rename = renames[prop];\n const name = getRenamedName(prop, rename);\n\n if (rename !== undefined && name === 'children') {\n throw new InvalidPropRenameError({\n composable,\n prop,\n name,\n reason: 'reserved',\n });\n }\n\n if (Object.hasOwn(renamed, name)) {\n throw new InvalidPropRenameError({\n composable,\n prop,\n name,\n reason: 'duplicate',\n });\n }\n\n renamed[name] =\n rename !== undefined && typeof rename !== 'string'\n ? rename.schema\n : definition;\n }\n\n return renamed;\n}\n\nfunction resolvePresetComposableCallProps<Props extends InPropsObject>(\n presetKey: string,\n propDefinitions: Props,\n callProps: Record<string, unknown>,\n) {\n const presetKeys = Object.keys(propDefinitions) as (keyof Props & string)[];\n const contextValues = useComposablePresetProps(presetKey) ?? {};\n const presetValues = Object.fromEntries(\n presetKeys.map((key) => [\n key,\n Object.hasOwn(callProps, key) ? callProps[key] : contextValues[key],\n ]),\n );\n // Context values have already been validated by the owning layout.\n const definitions = Object.fromEntries(\n Object.entries(propDefinitions).filter(\n ([key]) =>\n Object.hasOwn(callProps, key) || !Object.hasOwn(contextValues, key),\n ),\n );\n\n return validateProps(definitions, presetValues) as Show<\n WithChildren<ResolveProps<Props>>\n >;\n}\n\nexport function defineComposableComponent<\n const Name extends string,\n Definitions extends ComposableProps = {},\n Wrapper = undefined,\n>(\n options: DefineComposableComponentOptions<Name, Definitions, Wrapper>,\n): DefinedComposableComponentFactory<\n Name,\n NormalizeComposableProps<Definitions>,\n Wrapper\n>;\n\nexport function defineComposableComponent<\n const Name extends string,\n Props extends InPropsObject = {},\n Wrapper = undefined,\n>(\n options: DefineComposableComponentOptions<Name, Props, Wrapper>,\n): DefinedComposableComponentFactory<Name, Props, Wrapper> {\n const { name, wrapWith } = options;\n // Inline validators become definitions once, so every composable derived\n // from this factory shares them.\n const props = normalizeComposableProps(options.props ?? {}) as Props;\n\n function extend(customization: {\n name?: string;\n rename?: Record<string, PropRename | undefined>;\n props?: ComposableProps | ((defaults: Props) => ComposableProps);\n wrapWith?: unknown;\n }) {\n const customName = customization.name ?? name;\n const overrides =\n typeof customization.props === 'function'\n ? customization.props(props)\n : customization.props;\n\n return defineComposableComponent({\n ...options,\n name: customName,\n // Already-checked definitions; the checked input type is for callers.\n props: {\n ...renamePropDefinitions(customName, props, customization.rename ?? {}),\n ...overrides,\n } as {},\n wrapWith: 'wrapWith' in customization ? customization.wrapWith : wrapWith,\n });\n }\n\n const factory = (\n definition:\n | ((props: Show<WithChildren<ResolveProps<Props>>>) => ReactNode)\n | {\n name?: string;\n rename?: Record<string, PropRename | undefined>;\n props?: ComposableProps | ((defaults: Props) => ComposableProps);\n wrapWith?: unknown;\n render: (props: any) => ReactNode;\n },\n ): DefinedComposableComponentRecord<Name, Props, Wrapper> => {\n if (typeof definition !== 'function') {\n const { render: customRender, ...customization } = definition;\n\n return extend(customization)(\n customRender,\n ) as unknown as DefinedComposableComponentRecord<Name, Props, Wrapper>;\n }\n\n const render = definition;\n const component = createComposableComponent<\n Name,\n Wrapper,\n Props,\n Show<WithChildren<ResolveProps<Props>>>\n >({\n name,\n wrapWith,\n inProps: props,\n outProps: (resolved) => resolved as never,\n ...{\n [validatedComposableProps]: true,\n },\n });\n\n function PresetComposable(\n callProps: ComposablePresetComponentCallProps<Props, Wrapper>,\n ) {\n const callPropsRecord = callProps as Record<string, unknown>;\n const presetKeys = Object.keys(props) as (keyof Props & string)[];\n const validatedPresetProps = resolvePresetComposableCallProps(\n name,\n props,\n callPropsRecord,\n );\n const wrapperProps = {\n ...callPropsRecord,\n };\n\n for (const key of presetKeys) {\n delete wrapperProps[key];\n }\n\n return component({\n ...(wrapperProps as ComposableComponentWrapperProps<Wrapper>),\n ...validatedPresetProps,\n children: (resolved: Show<WithChildren<ResolveProps<Props>>>) =>\n render({\n ...resolved,\n children:\n 'children' in props\n ? (validatedPresetProps as Record<string, unknown>).children\n : callPropsRecord.children,\n } as Show<WithChildren<ResolveProps<Props>>>),\n } as unknown as ComposableComponentProps<\n Wrapper,\n Props,\n Show<WithChildren<ResolveProps<Props>>>\n >);\n }\n\n PresetComposable.displayName = name;\n\n const debugKey = Symbol.for('@jfdevelops/react-layout/debug');\n const debug = (options as unknown as Record<symbol, unknown>)[debugKey];\n const presetComponent = Object.assign(PresetComposable, {\n ...(debug\n ? {\n [debugKey]: debug,\n }\n : {}),\n props: undefined as unknown as Show<WithChildren<ResolveProps<Props>>>,\n [composablePresetMetaKey]: {\n key: name,\n props,\n } satisfies ComposablePresetMeta<Props>,\n }) as unknown as DefinedComposableComponentRecord<\n Name,\n Props,\n Wrapper\n >[Name];\n\n return {\n [name]: presetComponent,\n } as DefinedComposableComponentRecord<Name, Props, Wrapper>;\n };\n\n Object.defineProperty(factory, 'props', {\n enumerable: true,\n value: props,\n });\n Object.defineProperty(factory, 'extend', {\n value: extend,\n });\n\n return factory as DefinedComposableComponentFactory<Name, Props, Wrapper>;\n}\n\nfunction resolveComposableContext(\n entries: Record<string, ComposableContextEntry<unknown>>,\n options: Record<string, unknown>,\n) {\n const rest = {\n ...options,\n };\n let isCustomized = false;\n const values = Object.fromEntries(\n Object.entries(entries).map(([key, entry]) => {\n if (!Object.hasOwn(options, key) || options[key] === undefined) {\n return [key, entry.value];\n }\n\n const option = options[key];\n // A function is how a caller derives its value from the default.\n const supplied =\n typeof option === 'function' ? option(entry.value) : option;\n\n delete rest[key];\n isCustomized = true;\n\n return [\n key,\n entry.handler\n ? entry.handler({\n value: entry.value,\n supplied,\n })\n : supplied,\n ];\n }),\n );\n\n return {\n isCustomized,\n rest,\n values,\n };\n}\n\n/**\n * Starts a defined composable whose definition depends on values a caller\n * may change. `handler` receives those values and returns the definition.\n */\nfunction defineContext<Values extends Record<string, unknown>>(\n entries: ComposableContextEntries<Values>,\n) {\n const contextEntries = entries as Record<\n string,\n ComposableContextEntry<unknown>\n >;\n\n return {\n /**\n * Defines the composable from the context values. It runs with the\n * defaults, and again for a caller that changes a value.\n */\n handler<\n const Name extends string,\n Definitions extends ComposableProps = {},\n Wrapper = undefined,\n >(\n define: (context: ComposableContextValues<Values>) => {\n name: Name;\n props?: Definitions & ComposableProps;\n wrapWith?: Wrapper;\n },\n ) {\n type Factory = DefinedComposableComponentFactory<\n Name,\n NormalizeComposableProps<Definitions>,\n Wrapper\n >;\n\n // The definition is checked where `handler` is called.\n function createFactory(values: Record<string, unknown>) {\n return defineComposableComponent(\n define(values as ComposableContextValues<Values>) as never,\n ) as unknown as Factory;\n }\n\n const base = createFactory(\n resolveComposableContext(contextEntries, {}).values,\n );\n\n // A customized call gets a factory defined from its own values.\n function select(options: Record<string, unknown>) {\n const { isCustomized, rest, values } = resolveComposableContext(\n contextEntries,\n options,\n );\n\n return {\n factory: isCustomized ? createFactory(values) : base,\n rest,\n };\n }\n\n const contextual = (definition: unknown) => {\n if (typeof definition === 'function') {\n return base(definition as never);\n }\n\n const { factory, rest } = select(definition as Record<string, unknown>);\n\n return factory(rest as never);\n };\n\n Object.defineProperty(contextual, 'props', {\n enumerable: true,\n value: base.props,\n });\n Object.defineProperty(contextual, 'extend', {\n value: (customization: Record<string, unknown>) => {\n const { factory, rest } = select(customization);\n\n return factory.extend(rest);\n },\n });\n\n return contextual as unknown as DefinedComposableComponentFactory<\n Name,\n NormalizeComposableProps<Definitions>,\n Wrapper,\n ComposableContextValues<Values>\n >;\n },\n };\n}\n\ndefineComposableComponent.defineContext = defineContext;\n\nexport type MakeComposableOptions<\n Composables extends ComposableComponents,\n Name extends string,\n> = {\n components: Composables | undefined;\n name: Name;\n};\n\nexport type MakeComposable<\n Composables extends ComposableComponents,\n Name extends string,\n> = <OverrideName extends string = Name>(\n options?: Partial<\n Pick<MakeComposableOptions<Composables, OverrideName>, 'name'>\n >,\n) => ComposableResourceLayout<Composables, Name, any, any, any>;\n\nexport function makeComposable<Props>() {\n return function <\n Composables extends ComposableComponents,\n Name extends string,\n >(options: MakeComposableOptions<Composables, Name>) {\n const { components, name: layoutName } = options;\n\n if (!components || typeof components !== 'object') {\n throw new InvalidComponentsError('components must be an object');\n }\n\n const componentNames = Object.keys(components);\n\n if (componentNames.length === 0) {\n throw new EmptyComponentsError(\n 'components must have at least one component',\n );\n }\n\n const create: MakeComposable<Composables, Name> = (overrideOptions) => {\n const resolvedName = overrideOptions?.name ?? layoutName;\n const { Layout, ...rest } = components;\n\n return Object.assign(Layout, {\n displayName: resolvedName,\n props: undefined as unknown as Props,\n ...rest,\n }) as unknown as ComposableResourceLayout<\n Composables,\n Name,\n any,\n any,\n any\n >;\n };\n\n return create;\n };\n}\n"],"mappings":"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"}
|
package/dist/composable.d.cts
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
|
+
import { ComposablePropDefinition, ComposableProps, ComposablePropsInput, NormalizeComposableProps } from "./custom-props.cjs";
|
|
1
2
|
import { InPropsObject, WithChildren } from "./types.cjs";
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import { PropValidationContext, ResolveInputProps, ResolveLayoutInputProps, ResolveLayoutProps, ResolveProps, StandardSchemaV1 } from "@jfdevelops/react-layout-validator";
|
|
3
|
+
import { CapitalizeFn } from "./packages/internals/src/capitalize.cjs";
|
|
4
|
+
import { BaseComponent, Show, UnionToIntersection } from "./packages/internals/src/types.cjs";
|
|
5
5
|
import { ComponentType, ReactNode } from "react";
|
|
6
|
+
import { NormalizePropDefinitions, PropDefinition, PropValidationContext, PropValidator, ResolveInputProps, ResolveProps, StandardSchemaV1 } from "@jfdevelops/react-layout-validator";
|
|
6
7
|
|
|
7
8
|
//#region src/composable.d.ts
|
|
8
9
|
declare const composablePresetMetaKey: unique symbol;
|
|
@@ -72,29 +73,116 @@ type ComposablePresetComponent<Name extends string = string, Props extends InPro
|
|
|
72
73
|
[composablePresetMetaKey]: ComposablePresetMeta<Props>;
|
|
73
74
|
} & ((props: ComposablePresetComponentCallProps<Props, Wrapper>) => ReactNode);
|
|
74
75
|
type PresetPropDefinitions<Composables extends ComposableComponents> = MergePresetProps<Composables> extends InPropsObject ? MergePresetProps<Composables> : {};
|
|
75
|
-
type PresetLayoutInputProps<Props extends InPropsObject> =
|
|
76
|
+
type PresetLayoutInputProps<Props extends InPropsObject> = ResolveInputProps<SchemaDefinitions<Props>> & { [Key in keyof ResolveProps<Omit<Props, keyof SchemaDefinitions<Props>>>]-?: ResolveProps<Omit<Props, keyof SchemaDefinitions<Props>>>[Key] };
|
|
76
77
|
type RequiredPresetLayoutProps<Composables extends ComposableComponents> = PresetLayoutInputProps<PresetPropDefinitions<Composables>>;
|
|
77
78
|
type ComposableComponents = Record<string, ComposableComponentCallable>;
|
|
78
79
|
declare function createLayoutComposableFactory<Resources extends string, LayoutName extends string>(ctx: ComposableNameContext<Resources, LayoutName>): CreateLayoutComposable<Resources, LayoutName>;
|
|
79
80
|
declare function resolveLayoutComposables<Resources extends string, LayoutName extends string, Composables extends ComposableComponents>(factory: (create: CreateLayoutComposable<Resources, LayoutName>) => Composables, ctx: ComposableNameContext<Resources, LayoutName>): Composables;
|
|
80
81
|
declare function createComposableComponent<const Name extends string, Wrapper, InProps extends InPropsObject = {}, OutProps = {}>(options: ResolvedCreateComposableComponentOptions<Name, Wrapper, string, string, InProps, OutProps>): ComposableComponent<Name, Wrapper, InProps, OutProps>;
|
|
81
|
-
type DefineComposableComponentOptions<Name extends string, Props extends
|
|
82
|
+
type DefineComposableComponentOptions<Name extends string, Props extends ComposableProps, Wrapper = undefined> = {
|
|
82
83
|
name: Name;
|
|
83
|
-
|
|
84
|
+
/**
|
|
85
|
+
* The composable's custom props. This is the same object as `props.custom`
|
|
86
|
+
* elsewhere in the library; a composable has no shared options to
|
|
87
|
+
* `include`, so the `custom` key is left out. Each prop is a Standard
|
|
88
|
+
* Schema or an inline validator, and `children: 'required'` is accepted.
|
|
89
|
+
*/
|
|
90
|
+
props?: Props & ComposableProps & ComposablePropsInput<Props>;
|
|
84
91
|
wrapWith?: Wrapper;
|
|
85
92
|
};
|
|
86
93
|
type DefinedComposableComponentRecord<Name extends string, Props extends InPropsObject = {}, Wrapper = undefined> = { [K in Name]: ComposablePresetComponent<Name, Props, Wrapper> };
|
|
87
|
-
|
|
94
|
+
/** A new name for a prop, or a new name together with a new definition. */
|
|
95
|
+
type PropRename = string | {
|
|
96
|
+
name: string;
|
|
97
|
+
schema: PropDefinition | PropValidator;
|
|
98
|
+
};
|
|
99
|
+
/** New names for a defined composable's props, keyed by their current names. */
|
|
100
|
+
type PropRenames<Props extends InPropsObject> = { [Key in keyof Props]?: PropRename };
|
|
101
|
+
type RenamedPropName<Key, Rename> = Rename extends string ? Rename : Rename extends {
|
|
102
|
+
name: infer Name extends string;
|
|
103
|
+
} ? Name : Key;
|
|
104
|
+
type RenamedPropDefinition<Definition, Rename> = Rename extends {
|
|
105
|
+
schema: infer Schema;
|
|
106
|
+
} ? Schema extends PropDefinition ? Schema : NormalizePropDefinitions<{
|
|
107
|
+
schema: Schema;
|
|
108
|
+
}>['schema'] : Definition;
|
|
109
|
+
/** Applies a rename map to a defined composable's prop definitions. */
|
|
110
|
+
type RenameProps<Props extends InPropsObject, Renames> = [keyof Renames] extends [never] ? Props : { [Key in keyof Props as Key extends keyof Renames ? RenamedPropName<Key, Renames[Key]> : Key]: Key extends keyof Renames ? RenamedPropDefinition<Props[Key], Renames[Key]> : Props[Key] };
|
|
111
|
+
type CustomizedProps<Props extends InPropsObject, Renames, Overrides> = Omit<RenameProps<Props, Renames>, keyof Overrides> & NormalizeComposableProps<Overrides>;
|
|
112
|
+
type PropOverrides<Props extends InPropsObject> = { [Key in keyof Props]?: ComposablePropDefinition } & ComposableProps;
|
|
113
|
+
type ReservedComposableOption = 'name' | 'props' | 'rename' | 'render' | 'wrapWith';
|
|
114
|
+
type WidenContextValue<Value> = Value extends string ? string : Value extends number ? number : Value extends boolean ? boolean : Value extends bigint ? bigint : Value extends ((...input: never[]) => unknown) ? Value : Value extends ReadonlyArray<infer Item> ? ReadonlyArray<WidenContextValue<Item>> : Value extends object ? { [Key in keyof Value]: WidenContextValue<Value[Key]> } : Value;
|
|
115
|
+
/**
|
|
116
|
+
* The context values a defined composable works with, typed from the
|
|
117
|
+
* defaults it declares.
|
|
118
|
+
*/
|
|
119
|
+
type ComposableContextValues<Defaults> = { [Key in keyof Defaults]: WidenContextValue<Defaults[Key]> };
|
|
120
|
+
/** One value a caller may change where a defined composable is used. */
|
|
121
|
+
type ComposableContextEntry<Value> = {
|
|
122
|
+
/**
|
|
123
|
+
* The value used when the caller supplies none.
|
|
124
|
+
*/
|
|
125
|
+
value: Value;
|
|
126
|
+
/**
|
|
127
|
+
* Decides the value to use from the default and what the caller supplied.
|
|
128
|
+
* Without it, a supplied value replaces the default.
|
|
129
|
+
*/
|
|
130
|
+
handler?: (input: {
|
|
131
|
+
value: WidenContextValue<Value>;
|
|
132
|
+
supplied: WidenContextValue<Value>;
|
|
133
|
+
}) => WidenContextValue<Value>;
|
|
134
|
+
};
|
|
135
|
+
/** The context entries of a defined composable, keyed by option name. */
|
|
136
|
+
type ComposableContextEntries<Values> = { [Key in keyof Values]: Key extends ReservedComposableOption ? never : ComposableContextEntry<Values[Key]> };
|
|
137
|
+
type ComposableContextOption<Value> = Value extends ((...input: never[]) => unknown) ? (value: Value) => Value : Value | ((value: Value) => Value);
|
|
138
|
+
/**
|
|
139
|
+
* What a caller may pass for each context value: the value itself, or a
|
|
140
|
+
* function that receives the default and returns the value. A context value
|
|
141
|
+
* that is a function is supplied the second way only.
|
|
142
|
+
*/
|
|
143
|
+
type ComposableContextOptions<Context> = { [Key in keyof Context]?: ComposableContextOption<Context[Key]> };
|
|
144
|
+
type CustomizeComposableOptions<Props extends InPropsObject, Renames, Overrides, CustomName extends string, CustomWrapper, Context = {}> = ComposableContextOptions<Context> & {
|
|
145
|
+
name?: CustomName;
|
|
146
|
+
/**
|
|
147
|
+
* Rename default props. A string keeps the definition; an object also
|
|
148
|
+
* replaces it.
|
|
149
|
+
*/
|
|
150
|
+
rename?: Renames & PropRenames<Props>;
|
|
151
|
+
/**
|
|
152
|
+
* Replace default props or add new ones. A function receives the defaults.
|
|
153
|
+
*/
|
|
154
|
+
props?: (Overrides & PropOverrides<Props>) | ((defaults: Props) => Overrides);
|
|
155
|
+
wrapWith?: CustomWrapper;
|
|
156
|
+
};
|
|
157
|
+
type DefinedComposableComponentFactory<Name extends string, Props extends InPropsObject, Wrapper = undefined, Context = {}> = {
|
|
88
158
|
props: Props;
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
159
|
+
/**
|
|
160
|
+
* Customize this instance without changing the factory's defaults.
|
|
161
|
+
*/
|
|
162
|
+
<const Overrides extends ComposableProps = {}, const CustomName extends string = Name, CustomWrapper = Wrapper, const Renames extends PropRenames<Props> = {}>(options: CustomizeComposableOptions<Props, Renames, Overrides, CustomName, CustomWrapper, Context> & {
|
|
163
|
+
render: (props: Show<WithChildren<ResolveProps<CustomizedProps<Props, Renames, Overrides>>>>) => ReactNode;
|
|
164
|
+
}): DefinedComposableComponentRecord<CustomName, CustomizedProps<Props, Renames, Overrides>, CustomWrapper>;
|
|
165
|
+
(render: (props: Show<WithChildren<ResolveProps<Props>>>) => ReactNode): DefinedComposableComponentRecord<Name, Props, Wrapper>;
|
|
166
|
+
/**
|
|
167
|
+
* Derive a factory with its own name, props, or wrapper. The original
|
|
168
|
+
* factory is unchanged.
|
|
169
|
+
*/
|
|
170
|
+
extend<const Renames extends PropRenames<Props> = {}, const Overrides extends ComposableProps = {}, const CustomName extends string = Name, CustomWrapper = Wrapper>(options: CustomizeComposableOptions<Props, Renames, Overrides, CustomName, CustomWrapper, Context>): DefinedComposableComponentFactory<CustomName, CustomizedProps<Props, Renames, Overrides>, CustomWrapper>;
|
|
96
171
|
};
|
|
97
|
-
declare function defineComposableComponent<const Name extends string,
|
|
172
|
+
declare function defineComposableComponent<const Name extends string, Definitions extends ComposableProps = {}, Wrapper = undefined>(options: DefineComposableComponentOptions<Name, Definitions, Wrapper>): DefinedComposableComponentFactory<Name, NormalizeComposableProps<Definitions>, Wrapper>;
|
|
173
|
+
declare namespace defineComposableComponent {
|
|
174
|
+
var defineContext: <Values extends Record<string, unknown>>(entries: ComposableContextEntries<Values>) => {
|
|
175
|
+
/**
|
|
176
|
+
* Defines the composable from the context values. It runs with the
|
|
177
|
+
* defaults, and again for a caller that changes a value.
|
|
178
|
+
*/
|
|
179
|
+
handler<const Name extends string, Definitions extends ComposableProps = {}, Wrapper = undefined>(define: (context: ComposableContextValues<Values>) => {
|
|
180
|
+
name: Name;
|
|
181
|
+
props?: Definitions & ComposableProps;
|
|
182
|
+
wrapWith?: Wrapper;
|
|
183
|
+
}): DefinedComposableComponentFactory<Name, NormalizeComposableProps<Definitions>, Wrapper, ComposableContextValues<Values>>;
|
|
184
|
+
};
|
|
185
|
+
}
|
|
98
186
|
type MakeComposableOptions<Composables extends ComposableComponents, Name extends string> = {
|
|
99
187
|
components: Composables | undefined;
|
|
100
188
|
name: Name;
|
|
@@ -102,5 +190,5 @@ type MakeComposableOptions<Composables extends ComposableComponents, Name extend
|
|
|
102
190
|
type MakeComposable<Composables extends ComposableComponents, Name extends string> = <OverrideName extends string = Name>(options?: Partial<Pick<MakeComposableOptions<Composables, OverrideName>, 'name'>>) => ComposableResourceLayout<Composables, Name, any, any, any>;
|
|
103
191
|
declare function makeComposable<Props>(): <Composables extends ComposableComponents, Name extends string>(options: MakeComposableOptions<Composables, Name>) => MakeComposable<Composables, Name>;
|
|
104
192
|
//#endregion
|
|
105
|
-
export { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, composablePresetMetaKey, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables };
|
|
193
|
+
export { AnyComposableComponent, ComposableComponent, ComposableComponentCallable, ComposableComponents, ComposableContextEntry, ComposableContextOptions, ComposableContextValues, ComposableNameContext, ComposablePresetComponent, ComposablePresetComponentCallProps, ComposablePresetMeta, ComposablePresetProps, ComposableResourceLayout, CreateLayoutComposable, DefinedComposableComponentFactory, DefinedComposableComponentRecord, LayoutComposablePresetProvider, LayoutComposablesFactory, MakeComposable, MakeComposableOptions, MergePresetProps, PresetPropsFromComposable, PropRename, PropRenames, RenameProps, RequiredPresetLayoutProps, RequiredPresetRenderProps, ResolveLayoutComposables, collectComposablePresetEntries, composablePresetMetaKey, createComposableComponent, createLayoutComposableFactory, defineComposableComponent, makeComposable, resolveComposablePresetProps, resolveLayoutComposables };
|
|
106
194
|
//# sourceMappingURL=composable.d.cts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"composable.d.cts","names":[],"sources":["../src/composable.tsx"],"mappings":"
|
|
1
|
+
{"version":3,"file":"composable.d.cts","names":[],"sources":["../src/composable.tsx"],"mappings":"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"}
|