betterstart-cli 0.0.103 → 0.0.104

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/build-default-value-from-sync-functions.ts

@@ -0,0 +1,41 @@
+export function renderBuildDefaultValueFromSyncFunctionsGeneratedValueTemplate({
+  currentValueName,
+  targetName,
+  canSyncExpression,
+  previousValueExpression,
+  nextValueExpression
+}: {
+  currentValueName: string
+  targetName: string
+  canSyncExpression: string
+  previousValueExpression: string
+  nextValueExpression: string
+}): string {
+  return `    const ${currentValueName} = form.getValues('${targetName}') as unknown
+    if (${canSyncExpression}(
+      ${currentValueName} === '' ||
+      ${currentValueName} === undefined ||
+      ${currentValueName} === null ||
+      ${currentValueName} === ${previousValueExpression}
+    )) {
+      form.setValue('${targetName}', ${nextValueExpression} as never, {
+        shouldDirty: false,
+        shouldValidate: true
+      })
+    }`
+}
+
+export function renderBuildDefaultValueFromSyncFunctionsPreviousValueTemplate({
+  defaultValueFromHandlerName,
+  sourceName,
+  targetSync
+}: {
+  defaultValueFromHandlerName: string
+  sourceName: string
+  targetSync: string
+}): string {
+  return `  function ${defaultValueFromHandlerName}(nextValue: unknown) {
+    const previousValue = form.getValues('${sourceName}') as unknown
+${targetSync}
+  }`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/build-ui-imports.ts

@@ -0,0 +1,58 @@
+export function renderBuildUiImportsImportsTemplate({ join }: { join: string }): string {
+  return `import {
+  ${join}
+} from '@admin/components/ui/form'`
+}
+
+export function renderBuildUiImportsImportsDetailsTemplate(): string {
+  return `import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger
+} from '@admin/components/ui/select'`
+}
+
+export function renderBuildUiImportsImportsDetailsBranchTemplate({
+  join
+}: {
+  join: string
+}): string {
+  return `import {
+  ${join}
+} from '@admin/components/ui/command'`
+}
+
+export function renderBuildUiImportsImportsDetailsBranchBodyTemplate(): string {
+  return `import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger
+} from '@admin/components/ui/popover'`
+}
+
+export function renderBuildUiImportsImportsDetailsBranchBodyFragmentTemplate(): string {
+  return `import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger
+} from '@admin/components/ui/tooltip'`
+}
+
+export function renderBuildUiImportsImportsDetailsBranchBodyFragmentSectionTemplate(): string {
+  return `import {
+  Tabs,
+  TabsList,
+  TabsTrigger,
+  TabsContent
+} from '@admin/components/ui/tabs'`
+}
+
+export function renderBuildUiImportsImportsDetailsBranchBodyFragmentSectionVariantTemplate(): string {
+  return `import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger
+} from '@admin/components/ui/accordion'`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/generate-default-value.ts

@@ -0,0 +1,67 @@
+export function renderDefaultValueContentTemplate({
+  fName,
+  targetValuesExpression,
+  sourceValuesExpression,
+  fallback
+}: {
+  fName: string
+  targetValuesExpression: string
+  sourceValuesExpression: string
+  fallback: string
+}): string {
+  return `      ${fName}: ${targetValuesExpression}.length > 0
+        ? ${targetValuesExpression}
+        : ${sourceValuesExpression}.length > 0
+          ? ${sourceValuesExpression}
+          : ${fallback}`
+}
+
+export function renderDefaultValueContentDetailsTemplate({
+  fName,
+  hasInitialValueExpression,
+  dataSource,
+  hasInitialValueExpressionText,
+  sourceName,
+  defaultFallbackValue
+}: {
+  fName: string
+  hasInitialValueExpression: string
+  dataSource: string
+  hasInitialValueExpressionText: string
+  sourceName: string
+  defaultFallbackValue: string
+}): string {
+  return `      ${fName}: ${hasInitialValueExpression}
+        ? ${dataSource}.${fName}
+        : ${hasInitialValueExpressionText}
+          ? (${dataSource}.${sourceName} as never)
+          : ${defaultFallbackValue}`
+}
+
+export function renderDefaultValueContentDetailsBranchTemplate({
+  fName,
+  dataSource
+}: {
+  fName: string
+  dataSource: string
+}): string {
+  return `      ${fName}: ${dataSource}?.${fName}
+        ? (typeof ${dataSource}?.${fName} === 'object' ? String(${dataSource}?.${fName}.id) : String(${dataSource}?.${fName}))
+        : ''`
+}
+
+export function renderDefaultValueContentDetailsBranchBodyTemplate({
+  fName,
+  selectedValuesExpression,
+  validValuesExpression,
+  fallback
+}: {
+  fName: string
+  selectedValuesExpression: string
+  validValuesExpression: string
+  fallback: string
+}): string {
+  return `      ${fName}: ${selectedValuesExpression}.length > 0
+        ? ${selectedValuesExpression}.filter((value) => ${validValuesExpression}.includes(value))
+        : ${fallback}`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/generate-nested-list-default-value.ts

@@ -0,0 +1,13 @@
+export function renderNestedListDefaultValueContentTemplate({
+  fName,
+  dataSource,
+  join
+}: {
+  fName: string
+  dataSource: string
+  join: string
+}): string {
+  return `      ${fName}: (${dataSource}?.${fName} ?? []).map((item) => ({
+${join}
+      }))`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/label-with-description.ts

@@ -0,0 +1,14 @@
+export function renderLabelWithDescriptionLayoutTemplate({
+  indent,
+  labelJsx,
+  descriptionJsx
+}: {
+  indent: string
+  labelJsx: string
+  descriptionJsx: string
+}): string {
+  return `<div className="flex flex-col gap-1">
+${indent}  ${labelJsx}
+${indent}  ${descriptionJsx}
+${indent}</div>`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/render-tabs-trigger.ts

@@ -0,0 +1,18 @@
+export function renderTabsTriggerTabsLayoutTemplate({
+  indent,
+  tabName,
+  className,
+  iconName,
+  tabLabel
+}: {
+  indent: string
+  tabName: string
+  className: string
+  iconName: string
+  tabLabel: string
+}): string {
+  return `${indent}<TabsTrigger value="${tabName}"${className}>
+${indent}  <${iconName} className="size-4 shrink-0" />
+${indent}  <span>${tabLabel}</span>
+${indent}</TabsTrigger>`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-shared/select-read-values-expression.ts

@@ -0,0 +1,21 @@
+export function renderSelectReadValuesExpressionSelectValueTemplate({
+  dataSource,
+  fieldName
+}: {
+  dataSource: string
+  fieldName: string
+}): string {
+  return `(() => {
+        const selectValue = ${dataSource}?.${fieldName} as unknown
+        const values = Array.isArray(selectValue) ? selectValue : [selectValue]
+        return values
+          .map((option) => {
+            if (typeof option === 'string') return option
+            if (option && typeof option === 'object' && 'value' in option) {
+              return String(option.value)
+            }
+            return null
+          })
+          .filter((value): value is string => typeof value === 'string' && value.length > 0)
+      })()`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-single/build-group-creatable-select-handlers.ts

@@ -0,0 +1,67 @@
+export function renderBuildGroupCreatableSelectHandlersCurrentValueTemplate({
+  fieldName,
+  defaultValueFromHandlerContent
+}: {
+  fieldName: string
+  defaultValueFromHandlerContent: string
+}): string {
+  return `const currentValue = form.getValues('${fieldName}')
+      const selectedValues = Array.isArray(currentValue) ? currentValue : []
+      const nextValues = [...new Set([...selectedValues, result.option.value])]
+      ${defaultValueFromHandlerContent}form.setValue('${fieldName}', nextValues, {
+        shouldDirty: true,
+        shouldValidate: true
+      })`
+}
+
+export function renderBuildGroupCreatableSelectHandlersContentTemplate({
+  defaultValueFromHandlerContent,
+  fieldName
+}: {
+  defaultValueFromHandlerContent: string
+  fieldName: string
+}): string {
+  return `${defaultValueFromHandlerContent}form.setValue('${fieldName}', result.option.value, {
+        shouldDirty: true,
+        shouldValidate: true
+      })`
+}
+
+export function renderBuildGroupCreatableSelectHandlersTrimmedLabelTemplate({
+  fieldPascal,
+  singular,
+  fieldName,
+  schemaName,
+  setCreatedOptionValue
+}: {
+  fieldPascal: string
+  singular: string
+  fieldName: string
+  schemaName: string
+  setCreatedOptionValue: string
+}): string {
+  return `  function handleCreate${fieldPascal}Option(label: string) {
+    const trimmedLabel = label.trim()
+    if (!trimmedLabel) return
+
+    startCreate${fieldPascal}OptionTransition(async () => {
+      const result = await create${singular}SelectOption({
+        fieldName: '${fieldName}',
+        label: trimmedLabel
+      })
+
+      if (!result.success || !result.option) {
+        toast.error(result.error || 'Failed to create option')
+        return
+      }
+
+      await queryClient.invalidateQueries({
+        queryKey: ['${schemaName}', 'select-options', '${fieldName}']
+      })
+      ${setCreatedOptionValue}
+      set${fieldPascal}Search('')
+      set${fieldPascal}Open(false)
+      toast.success('Option created')
+    })
+  }`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-single/build-group-creatable-select-state.ts

@@ -0,0 +1,29 @@
+export function renderBuildGroupCreatableSelectStateStaticOptionsTemplate({
+  fieldName,
+  fieldPascal,
+  singular,
+  schemaName,
+  staticOptions
+}: {
+  fieldName: string
+  fieldPascal: string
+  singular: string
+  schemaName: string
+  staticOptions: string
+}): string {
+  return `  const [${fieldName}Open, set${fieldPascal}Open] = React.useState(false)
+  const [${fieldName}Search, set${fieldPascal}Search] = React.useState('')
+  const [create${fieldPascal}OptionPending, startCreate${fieldPascal}OptionTransition] = React.useTransition()
+  const { data: ${fieldName}CreatedOptions = [] as ${singular}SelectOption[] } = useQuery<${singular}SelectOption[]>({
+    queryKey: ['${schemaName}', 'select-options', '${fieldName}'],
+    queryFn: () => get${singular}SelectOptions('${fieldName}')
+  })
+  const ${fieldName}StaticOptions: Array<{ label: string; value: string }> = [${staticOptions}]
+  const ${fieldName}Options = [
+    ...${fieldName}StaticOptions,
+    ...${fieldName}CreatedOptions.filter(
+      (createdOption: ${singular}SelectOption) =>
+        !${fieldName}StaticOptions.some((option) => option.value === createdOption.value)
+    )
+  ]`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-single/build-group-field-array-hooks.ts

@@ -0,0 +1,13 @@
+export function renderBuildGroupFieldArrayHooksFieldArrayTemplate({
+  fieldName,
+  pascalFieldName
+}: {
+  fieldName: string
+  pascalFieldName: string
+}): string {
+  return `  const [${fieldName}Expanded, set${pascalFieldName}Expanded] = React.useState('')
+  const ${fieldName}FieldArray = useFieldArray({
+    control: form.control,
+    name: '${fieldName}'
+  })`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-single/build-group-fields-jsx.ts

@@ -0,0 +1,30 @@
+export function renderBuildGroupFieldsJsxTabContentTemplate({
+  tName,
+  tabFields
+}: {
+  tName: string
+  tabFields: string
+}): string {
+  return `              <TabsContent value="${tName}" className="space-y-6">
+${tabFields}
+              </TabsContent>`
+}
+
+export function renderBuildGroupFieldsJsxTabsLayoutTemplate({
+  indent,
+  toPascalCase,
+  tabsList,
+  tabsContent
+}: {
+  indent: string
+  toPascalCase: string
+  tabsList: string
+  tabsContent: string
+}): string {
+  return `${indent}<Tabs value={activeTab} onValueChange={(value) => void setActiveTab(value as ${toPascalCase}TabValue)} className="w-full">
+              <TabsList>
+${tabsList}
+              </TabsList>
+${tabsContent}
+${indent}</Tabs>`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-single/generate-card-component.ts

@@ -0,0 +1,129 @@
+export function renderCardComponentTabValuesTemplate({
+  groupVarPrefix,
+  map,
+  toPascalCase
+}: {
+  groupVarPrefix: string
+  map: string
+  toPascalCase: string
+}): string {
+  return `
+const ${groupVarPrefix}TabValues = [${map}] as const
+const ${groupVarPrefix}TabParser = parseAsStringLiteral(${groupVarPrefix}TabValues).withDefault(${groupVarPrefix}TabValues[0])
+
+type ${toPascalCase}TabValue = (typeof ${groupVarPrefix}TabValues)[number]
+`
+}
+
+export function renderCardComponentCardHeaderTemplate({
+  groupVarPrefix,
+  zodFields,
+  tabParserConst,
+  groupComponentName,
+  singular,
+  analysisHasTabsFieldTab,
+  relStateContent,
+  creatableSelectStateContent,
+  selectStateContent,
+  defaultValues,
+  savedValueName,
+  toCamelCase,
+  resetValues,
+  groupTitle,
+  schemaName,
+  defaultValueFromSyncFunctionsContent,
+  fieldArrayHooksContent,
+  creatableSelectHandlersContent,
+  descriptionLine,
+  fieldsJsx,
+  groupHintText
+}: {
+  groupVarPrefix: string
+  zodFields: string
+  tabParserConst: string
+  groupComponentName: string
+  singular: string
+  analysisHasTabsFieldTab: string
+  relStateContent: string
+  creatableSelectStateContent: string
+  selectStateContent: string
+  defaultValues: string
+  savedValueName: string
+  toCamelCase: string
+  resetValues: string
+  groupTitle: string
+  schemaName: string
+  defaultValueFromSyncFunctionsContent: string
+  fieldArrayHooksContent: string
+  creatableSelectHandlersContent: string
+  descriptionLine: string
+  fieldsJsx: string
+  groupHintText: string
+}): string {
+  return `const ${groupVarPrefix}Schema = z.object({
+${zodFields}
+})
+${tabParserConst}
+
+function ${groupComponentName}({ initialData }: { initialData?: ${singular} | null }) {
+  const queryClient = useQueryClient()${analysisHasTabsFieldTab}${relStateContent}${creatableSelectStateContent}${selectStateContent}
+
+  const form = useForm<z.infer<typeof ${groupVarPrefix}Schema>>({
+    resolver: standardSchemaResolver(${groupVarPrefix}Schema),
+    mode: 'onBlur',
+    reValidateMode: 'onChange',
+    defaultValues: {
+${defaultValues}
+    }
+  })
+
+  const mutation = useMutation({
+    mutationFn: (data: ${singular}UpsertInput) => upsert${singular}(data),
+    onSuccess: async (result) => {
+      const ${savedValueName} = result.${toCamelCase}
+      if (${savedValueName}) {
+        form.reset({
+${resetValues}
+        })
+      }
+      toast.success('${groupTitle} saved')
+      void queryClient.invalidateQueries({ queryKey: ['${schemaName}'] })
+    },
+    onError: (error: Error) => {
+      toast.error(error.message || 'Failed to save')
+    }
+  })
+
+  const isPending = mutation.isPending
+${defaultValueFromSyncFunctionsContent}
+${fieldArrayHooksContent}
+${creatableSelectHandlersContent}
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit((values) => {
+        mutation.mutate(values as ${singular}UpsertInput)
+      })}>
+        <Card >
+          <CardHeader>
+            <CardTitle>${groupTitle}</CardTitle>${descriptionLine}
+          </CardHeader>
+          <CardContent className="space-y-5">
+${fieldsJsx}
+          </CardContent>
+          <CardFooter>${groupHintText}
+            <Button
+              type="submit"
+              disabled={isPending || !form.formState.isDirty}
+              aria-busy={isPending}
+              className="ml-auto min-w-25"
+            >
+              {isPending && <Spinner />}
+              {isPending ? 'Saving…' : 'Save'}
+            </Button>
+          </CardFooter>
+        </Card>
+      </form>
+    </Form>
+  )
+}`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form/form-single/generate-single-form.ts

@@ -0,0 +1,66 @@
+export function renderSingleFormImportsTemplate({ map }: { map: string }): string {
+  return `import {
+${map}
+} from '@admin/components/ui/card'`
+}
+
+export function renderSingleFormClientModuleTemplate({
+  needsReactImport,
+  hasCreatableSelectUseQuery,
+  lucideIconsLucide,
+  hasNestedListUseFieldArray,
+  hasTabsFieldImport,
+  hasRelationshipImport,
+  relHookImportsContent,
+  join,
+  singular,
+  hasCreatableSelectContent,
+  actionImportPath,
+  hasCreatableSelectContentText,
+  joinText,
+  cardRenders
+}: {
+  needsReactImport: string
+  hasCreatableSelectUseQuery: string
+  lucideIconsLucide: string
+  hasNestedListUseFieldArray: string
+  hasTabsFieldImport: string
+  hasRelationshipImport: string
+  relHookImportsContent: string
+  join: string
+  singular: string
+  hasCreatableSelectContent: string
+  actionImportPath: string
+  hasCreatableSelectContentText: string
+  joinText: string
+  cardRenders: string
+}): string {
+  return `'use client'
+${needsReactImport}
+import { standardSchemaResolver } from '@hookform/resolvers/standard-schema'
+import { useMutation, ${hasCreatableSelectUseQuery}useQueryClient } from '@tanstack/react-query'${lucideIconsLucide}
+import {${hasNestedListUseFieldArray} useForm } from 'react-hook-form'
+import { toast } from 'sonner'
+import { z } from 'zod/v3'${hasTabsFieldImport}${hasRelationshipImport}
+${relHookImportsContent}${join}
+import type {
+  ${singular},
+  ${hasCreatableSelectContent}${singular}UpsertInput
+} from '@admin/actions/${actionImportPath}'
+import { ${hasCreatableSelectContentText}upsert${singular} } from '@admin/actions/${actionImportPath}'
+
+${joinText}
+
+interface ${singular}FormProps {
+  initialData?: ${singular} | null
+}
+
+export function ${singular}Form({ initialData }: ${singular}FormProps) {
+  return (
+    <div className="space-y-6">
+${cardRenders}
+    </div>
+  )
+}
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/form-admin/admin-columns/generate-column-def.ts

@@ -0,0 +1,72 @@
+export function renderColumnDefLayoutTemplate({
+  colAccessorKey
+}: {
+  colAccessorKey: string
+}): string {
+  return `cell: ({ row }) => {
+      const email = row.getValue('${colAccessorKey}') as string
+      return <div className="text-sm font-medium">{email || '-'}</div>
+    }`
+}
+
+export function renderColumnDefDateTemplate({
+  colAccessorKey
+}: {
+  colAccessorKey: string
+}): string {
+  return `cell: ({ row }) => {
+      const date = row.getValue('${colAccessorKey}') as string
+      return date ? new Date(date).toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' }) : '-'
+    }`
+}
+
+export function renderColumnDefValueTemplate({
+  colAccessorKey
+}: {
+  colAccessorKey: string
+}): string {
+  return `cell: ({ row }) => {
+      const value = row.getValue('${colAccessorKey}') as string
+      return <Badge variant="outline">{value || 'N/A'}</Badge>
+    }`
+}
+
+export function renderColumnDefLayoutDetailsTemplate({
+  colAccessorKey
+}: {
+  colAccessorKey: string
+}): string {
+  return `cell: ({ row }) => {
+      const value = row.getValue('${colAccessorKey}') as number
+      return <div className="text-right">{value !== null && value !== undefined ? value : '-'}</div>
+    }`
+}
+
+export function renderColumnDefValueDetailsTemplate({
+  colAccessorKey
+}: {
+  colAccessorKey: string
+}): string {
+  return `cell: ({ row }) => {
+      const value = row.getValue('${colAccessorKey}') as string
+      return <div>{value || '-'}</div>
+    }`
+}
+
+export function renderColumnDefContentTemplate({
+  colAccessorKey,
+  columnSize,
+  sortableHeader,
+  cellDef
+}: {
+  colAccessorKey: string
+  columnSize: string
+  sortableHeader: string
+  cellDef: string
+}): string {
+  return `  {
+    accessorKey: '${colAccessorKey}',
+    ${columnSize}${sortableHeader},
+    ${cellDef}
+  }`
+}