feat(cli): add configuration and path management functionality

This commit introduces configuration and path management functionality in the CLI by adding the helper functions to load and validate configuration. It also provides the logic to retrieve available components from a given registry. Additionally, it exposes these functionalities in public API.

packages/cli/src/const.ts

@@ -0,0 +1,53 @@
+import z from 'zod'
+
+export const REGISTRY_URL = 'https://ui.psw.kr/registry.json'
+export const CONFIG_DEFAULT_PATH = 'pswui.config.js'
+
+export interface Registry {
+  base: string
+  components: Record<string, string>
+}
+
+export interface Config {
+  /**
+   * Path that cli will create a file.
+   */
+  paths?: {
+    components?: 'src/pswui/components' | string
+    shared?: 'src/pswui/shared.ts' | string
+  }
+  /**
+   * Absolute path that will used for import in component
+   */
+  import?: {
+    shared?: '@pswui-shared' | string
+  }
+}
+export type ResolvedConfig<T = Config> = {
+  [k in keyof T]-?: NonNullable<T[k]> extends object ? ResolvedConfig<NonNullable<T[k]>> : T[k]
+}
+
+export const DEFAULT_CONFIG = {
+  paths: {
+    components: 'src/pswui/components',
+    shared: 'src/pswui/shared.ts',
+  },
+  import: {
+    shared: '@pswui-shared',
+  },
+}
+export const configZod = z.object({
+  paths: z
+    .object({
+      components: z.string().optional().default(DEFAULT_CONFIG.paths.components),
+      shared: z.string().optional().default(DEFAULT_CONFIG.paths.shared),
+    })
+    .optional()
+    .default(DEFAULT_CONFIG.paths),
+  import: z
+    .object({
+      shared: z.string().optional().default(DEFAULT_CONFIG.import.shared),
+    })
+    .optional()
+    .default(DEFAULT_CONFIG.import),
+})

packages/cli/src/helpers/config.ts

@@ -0,0 +1,18 @@
+import {CONFIG_DEFAULT_PATH, DEFAULT_CONFIG, ResolvedConfig} from '../const.js'
+import {configZod} from '../const.js'
+import {join} from 'node:path'
+import {existsSync} from 'node:fs'
+
+export async function loadConfig(config?: string): Promise<unknown> {
+  const configPath = join(process.cwd(), config ?? CONFIG_DEFAULT_PATH)
+
+  if (existsSync(configPath)) {
+    return (await import(configPath)).default
+  } else {
+    return DEFAULT_CONFIG
+  }
+}
+
+export async function validateConfig(config?: unknown): Promise<ResolvedConfig> {
+  return await configZod.parseAsync(config)
+}

packages/cli/src/helpers/path.ts

@@ -0,0 +1,14 @@
+import {ResolvedConfig} from '../const.js'
+import {readdir} from 'node:fs/promises'
+import {existsSync} from 'node:fs'
+import {join} from 'node:path'
+
+export async function getComponentsInstalled(components: string[], config: ResolvedConfig) {
+  const componentPath = join(process.cwd(), config.paths.components)
+  if (existsSync(componentPath)) {
+    const dir = await readdir(componentPath)
+    return dir.reduce((prev, current) => (components.includes(current) ? [...prev, current] : prev), [] as string[])
+  } else {
+    return []
+  }
+}

packages/cli/src/helpers/registry.ts

@@ -0,0 +1,13 @@
+import {REGISTRY_URL, Registry} from '../const.js'
+
+export async function getRegistry(): Promise<Registry> {
+  return (await (await fetch(REGISTRY_URL)).json()) as Registry
+}
+
+export async function getAvailableComponentNames(registry: Registry): Promise<string[]> {
+  return Object.keys(registry.components)
+}
+
+export async function getComponentURL(registry: Registry, componentName: string): Promise<string> {
+  return registry.base.replace('{componentName}', registry.components[componentName])
+}

packages/cli/src/index.ts

@@ -1 +1,2 @@
 export {run} from '@oclif/core'
+export * from './public.js'

packages/cli/src/public.ts

@@ -0,0 +1,7 @@
+import {Config} from './const.js'
+
+function buildConfig(config: Config): Config {
+  return config
+}
+
+export {Config, buildConfig}