@jfdevelops/react-layout 0.2.0 → 0.3.0

package/dist/create-config.mjs

@@ -1,101 +0,0 @@
-import { pick, resolvePropDefinitionValues } from "./utils.mjs";
-import { makeComposable, resolveLayoutComposables } from "./composable.mjs";
-import { createPrimitivePropBuilder, createProp } from "./validators/builders.mjs";
-import { validateProps } from "./validators/validate-props.mjs";
-import { normalizeResources, toResourceEnum } from "./resource.mjs";
-import { capitalize } from "./utils/capitalize.mjs";
-import { Fragment, jsx } from "react/jsx-runtime";
-
-//#region src/create-config.tsx
-function isBuiltPropDefinition(value) {
-	return typeof value === "function" && value !== null && "visibility" in value;
-}
-function isSplitLayoutInPropDefinition(value) {
-	return value !== null && typeof value === "object" && "render" in value && value.render !== void 0;
-}
-function splitLayoutInProps(inProps) {
-	const resolvedInProps = {};
-	const splitInProps = {};
-	for (const [key, value] of Object.entries(inProps)) {
-		if (isBuiltPropDefinition(value)) {
-			resolvedInProps[key] = value;
-			continue;
-		}
-		if (isSplitLayoutInPropDefinition(value)) {
-			splitInProps[key] = value.render;
-			if (value.props && typeof value.props === "object") Object.assign(resolvedInProps, value.props);
-		}
-	}
-	return {
-		resolvedInProps,
-		splitInProps
-	};
-}
-function defineResourceLayout(options) {
-	const { options: inProps, resources, layout } = options;
-	const normalizedResources = normalizeResources(resources);
-	const resourcesEnum = createPrimitivePropBuilder("string").enum(toResourceEnum(normalizedResources));
-	const definedResourceLayout = (layoutOptions) => {
-		const { name, props: instancePropDefinitions, ...layoutOptionProps } = layoutOptions;
-		const createComposableLayout = makeComposable();
-		const nameProp = createProp.string().literal(name);
-		const { resolvedInProps, splitInProps } = splitLayoutInProps({
-			...typeof inProps === "function" ? inProps({
-				resource: resourcesEnum,
-				name: nameProp
-			}) : inProps,
-			...instancePropDefinitions,
-			...layoutOptionProps
-		});
-		const { composables, render, props: layoutProps } = layout;
-		const customLayoutProps = layoutProps?.custom;
-		const includeLayoutProps = layoutProps?.include;
-		const resolvedLayoutProps = {
-			...pick(resolvedInProps, Object.keys(includeLayoutProps ?? {})),
-			...customLayoutProps
-		};
-		const layoutContext = {
-			resource: layoutOptions.resource,
-			name,
-			capitalize
-		};
-		const resolvedComposables = composables ? resolveLayoutComposables(composables, layoutContext) : void 0;
-		const mergedRenderContext = {
-			composables: resolvedComposables,
-			resource: layoutContext.resource,
-			name: layoutContext.name,
-			inProps: splitInProps
-		};
-		function Component(props) {
-			const validatedProps = validateProps(resolvedLayoutProps, props);
-			const includedPropKeys = Object.keys(includeLayoutProps ?? {});
-			const includedPropDefinitions = pick(resolvedInProps, includedPropKeys);
-			const validatedIncludedProps = validateProps(includedPropDefinitions, {
-				...resolvePropDefinitionValues(includedPropDefinitions),
-				...pick(splitInProps, includedPropKeys),
-				...pick(layoutOptionProps, includedPropKeys)
-			});
-			return /* @__PURE__ */ jsx(Fragment, { children: render({
-				...validatedProps,
-				...validatedIncludedProps
-			}, mergedRenderContext) });
-		}
-		function createComposition(compositionOptions) {
-			if (!compositionOptions.components) return {};
-			return { makeComposable: createComposableLayout(compositionOptions) };
-		}
-		return Object.assign(Component, {
-			displayName: name,
-			props: void 0,
-			...createComposition({
-				components: resolvedComposables,
-				name
-			})
-		});
-	};
-	return definedResourceLayout;
-}
-
-//#endregion
-export { defineResourceLayout };
-//# sourceMappingURL=create-config.mjs.map

package/dist/create-config.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-config.mjs","names":[],"sources":["../src/create-config.tsx"],"sourcesContent":["import type { JSX } from 'react';\nimport {\n  type ComposableComponents,\n  type ComposableNameContext,\n  type CreateLayoutComposable,\n  MakeComposable,\n  makeComposable,\n  MakeComposableOptions,\n  resolveLayoutComposables,\n} from './composable';\nimport {\n  type AnyBuiltPropDefinition,\n  createPrimitivePropBuilder,\n  createProp,\n  type ResolveLayoutProps,\n  type ResolveProps,\n  validateProps,\n} from './validators';\nimport {\n  IncludedProps,\n  InferredInProps,\n  InPropsDefinition,\n  InPropsObject,\n  LayoutRenderProps,\n} from './props';\nimport {\n  normalizeResources,\n  toResourceEnum,\n  type LayoutResourceKey,\n  type NormalizeResources,\n  type ResourceDefinition,\n} from './resource';\nimport {\n  BaseComponent,\n  pick,\n  resolvePropDefinitionValues,\n  Show,\n} from './utils';\nimport { capitalize } from './utils/capitalize';\n\ntype LayoutProps<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {},\n  CustomProps extends InPropsObject = {},\n> = {\n  /**\n   * Props to include in the layout.\n   */\n  include?: IncludeProps;\n  /**\n   * Custom props that the layout will receive.\n   */\n  custom?: CustomProps;\n};\n\ntype LayoutRenderContext<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Composables extends ComposableComponents,\n> = {\n  composables: LayoutRenderComposables<Composables>;\n  inProps: Record<string, unknown>;\n  resource: LayoutResourceKey<Resources>;\n  name: string;\n};\ntype LayoutRenderComposables<Composables extends ComposableComponents> = [\n  keyof Composables,\n] extends [never]\n  ? undefined\n  : Composables;\n\ntype SplitLayoutInPropDefinition<\n  Props extends InPropsObject = {},\n  Content = unknown,\n> = {\n  props?: Props;\n  render: ((props: ResolveProps<Props>) => Content) | Content;\n};\n\nfunction isBuiltPropDefinition(\n  value: unknown,\n): value is AnyBuiltPropDefinition {\n  return typeof value === 'function' && value !== null && 'visibility' in value;\n}\n\nfunction isSplitLayoutInPropDefinition(\n  value: unknown,\n): value is SplitLayoutInPropDefinition {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'render' in value &&\n    (value as { render?: unknown }).render !== undefined\n  );\n}\n\nfunction splitLayoutInProps(inProps: Record<string, unknown>) {\n  const resolvedInProps: Record<string, AnyBuiltPropDefinition> = {};\n  const splitInProps: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(inProps)) {\n    if (isBuiltPropDefinition(value)) {\n      resolvedInProps[key] = value;\n      continue;\n    }\n\n    if (isSplitLayoutInPropDefinition(value)) {\n      splitInProps[key] = value.render;\n\n      if (value.props && typeof value.props === 'object') {\n        Object.assign(resolvedInProps, value.props);\n      }\n    }\n  }\n\n  return {\n    resolvedInProps,\n    splitInProps,\n  };\n}\n\ntype CreateViewMapOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  Options extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, Options>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = {\n  /**\n   * An array of valid resource names to support.\n   */\n  resources: Resources;\n  /**\n   * The options that are passed into the created resource layout.\n   */\n  options: Options;\n  layout: {\n    /**\n     * The props to pass to the layout.\n     */\n    props?: LayoutProps<Resources, Options, IncludeProps, CustomProps>;\n    /**\n     * Components used to compose the layout. Invoked per layout instance with\n     * a scoped `create` that resolves composable `name` callbacks using the\n     * layout's `resource` and `name`.\n     */\n    composables?: (\n      create: CreateLayoutComposable<LayoutResourceKey<Resources>>,\n    ) => Composables;\n    /**\n     * The render function for the layout.\n     */\n    render: (\n      props: LayoutRenderProps<Resources, Options, IncludeProps, CustomProps>,\n      context: LayoutRenderContext<Resources, Composables>,\n    ) => JSX.Element;\n  };\n};\n\ntype ResourceLayoutComposition<\n  Name extends string,\n  Composables extends ComposableComponents,\n> = [keyof Composables] extends [never]\n  ? {}\n  : {\n      makeComposable: MakeComposable<Composables, Name>;\n    };\ntype ResourceLayoutComponent<\n  Name extends string,\n  Props extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = ResourceLayoutComposition<Name, Composables> &\n  BaseComponent<Name, ResolveProps<Props>> & {\n    (props: Show<ResolveProps<Props>>): JSX.Element;\n  };\n\ntype DefinedResourceLayoutOptions<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n> = ResolveLayoutProps<InferredInProps<Resources, InProps>> & {\n  name: Name;\n  resource: Resource;\n  props?: Props;\n};\ntype DefinedResourceLayout<\n  Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n> = <\n  Name extends string,\n  Resource extends LayoutResourceKey<Resources>,\n  Props extends InPropsObject = {},\n>(\n  options: DefinedResourceLayoutOptions<\n    Resources,\n    InProps,\n    Name,\n    Resource,\n    Props\n  >,\n) => ResourceLayoutComponent<Name, CustomProps, Composables>;\n\nexport function defineResourceLayout<\n  const Resources extends ReadonlyArray<ResourceDefinition>,\n  InProps extends InPropsDefinition<Resources>,\n  IncludeProps extends IncludedProps<InferredInProps<Resources, InProps>> = {},\n  CustomProps extends InPropsObject = {},\n  Composables extends ComposableComponents = {},\n>(\n  options: CreateViewMapOptions<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  >,\n) {\n  const { options: inProps, resources, layout } = options;\n  const normalizedResources = normalizeResources(resources);\n  const resourcesEnum = createPrimitivePropBuilder('string').enum(\n    toResourceEnum(normalizedResources),\n  );\n  const definedResourceLayout: DefinedResourceLayout<\n    Resources,\n    InProps,\n    IncludeProps,\n    CustomProps,\n    Composables\n  > = (layoutOptions) => {\n    const {\n      name,\n      props: instancePropDefinitions,\n      ...layoutOptionProps\n    } = layoutOptions;\n    const createComposableLayout =\n      makeComposable<\n        LayoutRenderProps<Resources, InProps, IncludeProps, CustomProps>\n      >();\n    const nameProp = createProp.string().literal(name);\n    const rawResolvedOptions =\n      typeof inProps === 'function'\n        ? inProps({\n            resource: resourcesEnum,\n            name: nameProp,\n          })\n        : inProps;\n    const { resolvedInProps, splitInProps } = splitLayoutInProps({\n      ...(rawResolvedOptions as Record<string, unknown>),\n      ...(instancePropDefinitions as Record<string, unknown> | undefined),\n      ...layoutOptionProps,\n    });\n    const { composables, render, props: layoutProps } = layout;\n    const customLayoutProps = layoutProps?.custom;\n    const includeLayoutProps = layoutProps?.include;\n    const resolvedIncludedProps = pick(\n      resolvedInProps,\n      Object.keys(includeLayoutProps ?? {}),\n    );\n    const resolvedLayoutProps = {\n      ...resolvedIncludedProps,\n      ...customLayoutProps,\n    };\n    const layoutContext: ComposableNameContext<\n      LayoutResourceKey<Resources>,\n      typeof name\n    > = {\n      resource: layoutOptions.resource,\n      name,\n      capitalize,\n    };\n    const resolvedComposables = composables\n      ? resolveLayoutComposables(composables, layoutContext)\n      : undefined;\n    const mergedRenderContext = {\n      composables: resolvedComposables as LayoutRenderComposables<Composables>,\n      resource: layoutContext.resource,\n      name: layoutContext.name,\n      inProps: splitInProps,\n    } as LayoutRenderContext<Resources, Composables>;\n\n    function Component(props: Show<ResolveProps<CustomProps>>) {\n      const validatedProps = validateProps(resolvedLayoutProps, props);\n      const includedPropKeys = Object.keys(includeLayoutProps ?? {});\n      const includedPropDefinitions = pick(\n        resolvedInProps,\n        includedPropKeys,\n      ) as Record<string, unknown>;\n      const includedPropValues = {\n        ...resolvePropDefinitionValues(includedPropDefinitions),\n        ...pick(\n          splitInProps,\n          includedPropKeys as (keyof typeof splitInProps)[],\n        ),\n        ...pick(\n          layoutOptionProps,\n          includedPropKeys as (keyof typeof layoutOptionProps)[],\n        ),\n      };\n      const validatedIncludedProps = validateProps(\n        includedPropDefinitions as Record<string, AnyBuiltPropDefinition>,\n        includedPropValues,\n      );\n      const layoutRenderProps = {\n        ...validatedProps,\n        ...validatedIncludedProps,\n      } as unknown as LayoutRenderProps<\n        Resources,\n        InProps,\n        IncludeProps,\n        CustomProps\n      >;\n\n      return <>{render(layoutRenderProps, mergedRenderContext)}</>;\n    }\n\n    function createComposition<LayoutName extends string>(\n      compositionOptions: MakeComposableOptions<Composables, LayoutName>,\n    ) {\n      if (!compositionOptions.components) {\n        return {} as ResourceLayoutComposition<LayoutName, Composables>;\n      }\n\n      return {\n        makeComposable: createComposableLayout(compositionOptions),\n      };\n    }\n\n    return Object.assign(Component, {\n      displayName: name,\n      props: undefined as unknown as ResolveProps<CustomProps>,\n      ...createComposition({\n        components: resolvedComposables as Composables | undefined,\n        name,\n      }),\n    });\n  };\n\n  return definedResourceLayout;\n}\n"],"mappings":";;;;;;;;;AA+EA,SAAS,sBACP,OACiC;CACjC,OAAO,OAAO,UAAU,cAAc,UAAU,QAAQ,gBAAgB;AAC1E;AAEA,SAAS,8BACP,OACsC;CACtC,OACE,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACX,MAA+B,WAAW;AAE/C;AAEA,SAAS,mBAAmB,SAAkC;CAC5D,MAAM,kBAA0D,CAAC;CACjE,MAAM,eAAwC,CAAC;CAE/C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAAG;EAClD,IAAI,sBAAsB,KAAK,GAAG;GAChC,gBAAgB,OAAO;GACvB;EACF;EAEA,IAAI,8BAA8B,KAAK,GAAG;GACxC,aAAa,OAAO,MAAM;GAE1B,IAAI,MAAM,SAAS,OAAO,MAAM,UAAU,UACxC,OAAO,OAAO,iBAAiB,MAAM,KAAK;EAE9C;CACF;CAEA,OAAO;EACL;EACA;CACF;AACF;AAwFA,SAAgB,qBAOd,SAOA;CACA,MAAM,EAAE,SAAS,SAAS,WAAW,WAAW;CAChD,MAAM,sBAAsB,mBAAmB,SAAS;CACxD,MAAM,gBAAgB,2BAA2B,QAAQ,EAAE,KACzD,eAAe,mBAAmB,CACpC;CACA,MAAM,yBAMD,kBAAkB;EACrB,MAAM,EACJ,MACA,OAAO,yBACP,GAAG,sBACD;EACJ,MAAM,yBACJ,eAEE;EACJ,MAAM,WAAW,WAAW,OAAO,EAAE,QAAQ,IAAI;EAQjD,MAAM,EAAE,iBAAiB,iBAAiB,mBAAmB;GAC3D,GAPA,OAAO,YAAY,aACf,QAAQ;IACN,UAAU;IACV,MAAM;GACR,CAAC,IACD;GAGJ,GAAI;GACJ,GAAG;EACL,CAAC;EACD,MAAM,EAAE,aAAa,QAAQ,OAAO,gBAAgB;EACpD,MAAM,oBAAoB,aAAa;EACvC,MAAM,qBAAqB,aAAa;EAKxC,MAAM,sBAAsB;GAC1B,GAL4B,KAC5B,iBACA,OAAO,KAAK,sBAAsB,CAAC,CAAC,CAGb;GACvB,GAAG;EACL;EACA,MAAM,gBAGF;GACF,UAAU,cAAc;GACxB;GACA;EACF;EACA,MAAM,sBAAsB,cACxB,yBAAyB,aAAa,aAAa,IACnD;EACJ,MAAM,sBAAsB;GAC1B,aAAa;GACb,UAAU,cAAc;GACxB,MAAM,cAAc;GACpB,SAAS;EACX;EAEA,SAAS,UAAU,OAAwC;GACzD,MAAM,iBAAiB,cAAc,qBAAqB,KAAK;GAC/D,MAAM,mBAAmB,OAAO,KAAK,sBAAsB,CAAC,CAAC;GAC7D,MAAM,0BAA0B,KAC9B,iBACA,gBACF;GAYA,MAAM,yBAAyB,cAC7B,yBACA;IAZA,GAAG,4BAA4B,uBAAuB;IACtD,GAAG,KACD,cACA,gBACF;IACA,GAAG,KACD,mBACA,gBACF;GAIiB,CACnB;GAWA,OAAO,0CAAG,OAAO;IATf,GAAG;IACH,GAAG;GAQ4B,GAAG,mBAAmB,EAAI;EAC7D;EAEA,SAAS,kBACP,oBACA;GACA,IAAI,CAAC,mBAAmB,YACtB,OAAO,CAAC;GAGV,OAAO,EACL,gBAAgB,uBAAuB,kBAAkB,EAC3D;EACF;EAEA,OAAO,OAAO,OAAO,WAAW;GAC9B,aAAa;GACb,OAAO;GACP,GAAG,kBAAkB;IACnB,YAAY;IACZ;GACF,CAAC;EACH,CAAC;CACH;CAEA,OAAO;AACT"}