@spacemade/ui 0.0.1

package/scripts/crud-scaffold/src/generator.mjs

@@ -0,0 +1,103 @@
+import { createApiSlice, createDetailChildPage, createDetailPage, createFrontendModel, createPage, createResourceConfig, createResourceModal, createResourcePage, createResourceTable, createSideNav } from './frontend/index.mjs'
+import { createBackendModelIndex, createCollectionActionRoute, createCollectionActionService, createController, createIdRoute, createIndexRoute, createMigration, createModel, createService } from './api/index.mjs'
+import { patchPermissionDefinitions, patchSideNavLayout, patchStore } from './app/patches.mjs'
+import { namespace, pageRoute, tableName } from './core/utils.mjs'
+
+export { enumDataType, field, quote, tsUnion } from './core/fields.mjs'
+
+function createFrontendPageBridge(resource, options, segment = 'index') {
+  const route = pageRoute(resource, options)
+
+  return `export { default } from '${options.src.importRoot}/pages/${route}/${segment}'
+`
+}
+
+function createApiRouteBridge(resource, options, segment = '') {
+  const suffix = segment ? `/${segment}` : '/index'
+
+  return `export { default } from '../../../${options.api.root.replace(/^api\//, '')}/pages/api/${resource.route}${suffix}'
+`
+}
+
+function createApiActionRouteBridge(route, options) {
+  return `export { default } from '../../../${options.api.root.replace(/^api\//, '')}/pages/api/${route}'
+`
+}
+
+function validateConfig(config) {
+  if (!Array.isArray(config.associations)) {
+    throw new Error('crud scaffold config requires an explicit associations array')
+  }
+
+  for (const resource of config.resources || []) {
+    if (!Array.isArray(resource.searchFields)) {
+      throw new Error(`crud scaffold resource ${resource.name || resource.slug} requires explicit searchFields`)
+    }
+  }
+}
+
+function createFiles(resources, options) {
+  const ns = namespace(options)
+  const migrationRoot = options.api.migrationRoot || `${options.api.root}/migrations`
+  const files = {
+    [`${options.api.root}/models/index.ts`]: createBackendModelIndex(resources, options.associations, options.title, options),
+    [`${options.src.root}/config/${ns.resourcesFile}.ts`]: createResourceConfig(resources, options),
+    [`${options.src.root}/components/${ns.pascal}SideNav.tsx`]: createSideNav(options),
+    [`${options.src.root}/components/${ns.pascal}ResourceModal.tsx`]: createResourceModal(options),
+    [`${options.src.root}/components/${ns.pascal}ResourceTable.tsx`]: createResourceTable(options),
+    [`${options.src.root}/components/${ns.pascal}ResourcePage.tsx`]: createResourcePage(options),
+    [`${options.src.root}/store/model/${ns.modelFile}.ts`]: createFrontendModel(resources),
+    [`${options.src.root}/store/slice/api/${options.store.apiSliceName}.ts`]: createApiSlice(resources, options),
+  }
+
+  resources.forEach((resource, index) => {
+    const migrationId = `${options.migrationPrefix}${String(index).padStart(3, '0')}`
+    const pageRoute = resource.route.replace(new RegExp(`^${options.routePrefix || ''}`), '')
+    const detailRoute = resource.detailRoute || '[id]'
+
+    files[`${options.api.root}/models/${resource.slug}.model.ts`] = createModel(resource)
+    files[`${options.api.root}/services/${resource.slug}.service.ts`] = createService(resource, options)
+    files[`${options.api.root}/controllers/${resource.slug}.controller.ts`] = createController(resource, options)
+    files[`${options.api.root}/pages/api/${resource.route}/index.ts`] = createIndexRoute(resource, options)
+    files[`${options.api.root}/pages/api/${resource.route}/[id].ts`] = createIdRoute(resource, options)
+    files[`${migrationRoot}/${migrationId}-create-${tableName(resource).replaceAll('_', '-')}-table.js`] = createMigration(resource)
+    files[`${options.src.root}/pages/${pageRoute}/index.tsx`] = createPage(resource, options)
+    files[`${options.src.root}/pages/${pageRoute}/${detailRoute}.tsx`] = createDetailPage(resource, options)
+    files[`api/pages/api/${resource.route}/index.ts`] = createApiRouteBridge(resource, options)
+    files[`api/pages/api/${resource.route}/[id].ts`] = createApiRouteBridge(resource, options, '[id]')
+    files[`src/pages/${pageRoute}/index.tsx`] = createFrontendPageBridge(resource, options)
+    files[`src/pages/${pageRoute}/${detailRoute}.tsx`] = createFrontendPageBridge(resource, options, detailRoute)
+
+    ;(resource.detailPages || []).forEach((childPage) => {
+      files[`${options.src.root}/pages/${pageRoute}/${detailRoute}/${childPage.path}.tsx`] = createDetailChildPage(resource, childPage, options)
+      files[`src/pages/${pageRoute}/${detailRoute}/${childPage.path}.tsx`] = createFrontendPageBridge(resource, options, `${detailRoute}/${childPage.path}`)
+    })
+
+    ;(resource.collectionActions || []).forEach((action) => {
+      const actionWithResource = { ...action, resource }
+      files[`${options.api.root}/services/${action.serviceFile}.service.ts`] = createCollectionActionService(actionWithResource, options)
+      files[`${options.api.root}/pages/api/${action.route}.ts`] = createCollectionActionRoute(actionWithResource, options)
+      files[`api/pages/api/${action.route}.ts`] = createApiActionRouteBridge(action.route, options)
+    })
+  })
+
+  return files
+}
+
+export function createCrudScaffoldDefinition(config) {
+  validateConfig(config)
+
+  return {
+    doneMessage: config.doneMessage,
+    files: createFiles(config.resources, config),
+    afterGenerate(context) {
+      patchSideNavLayout(context.root, config.resources, config)
+      patchPermissionDefinitions(context.root, config)
+      patchStore(context.root, config)
+
+      if (typeof config.afterGenerate === 'function') {
+        config.afterGenerate(context)
+      }
+    },
+  }
+}

package/scripts/crud-scaffold/src/templates/.gitkeep

@@ -0,0 +1 @@
+

package/scripts/crud-scaffold/src/utils/generator-utils.mjs

@@ -0,0 +1,35 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+export function createGenerator(definition) {
+  const root = process.cwd()
+  const force = process.argv.includes('--force')
+
+  function ensureDir(filePath) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true })
+  }
+
+  function writeFile(relativePath, contents) {
+    const filePath = path.join(root, relativePath)
+    ensureDir(filePath)
+
+    if (!force && fs.existsSync(filePath)) {
+      console.log(`skip ${relativePath}`)
+      return
+    }
+
+    fs.writeFileSync(filePath, contents, 'utf8')
+    console.log(`write ${relativePath}`)
+  }
+
+  for (const [relativePath, contents] of Object.entries(definition.files)) {
+    writeFile(relativePath, contents)
+  }
+
+  if (typeof definition.afterGenerate === 'function') {
+    definition.afterGenerate({ root, force })
+  }
+
+  console.log('')
+  console.log(definition.doneMessage)
+}