@astrale-os/cli 1.0.0-beta.2 → 1.0.0-beta.20

package/src/ui/index.ts

@@ -0,0 +1,13 @@
+export {
+  addUi,
+  applyPreset,
+  doctorUi,
+  initUi,
+  listLockedUi,
+  listUi,
+  type InitUiOptions,
+} from './operations'
+export { UI_PRESETS, UiError, type UiLock, type UiPreset } from './model'
+export { discoverUiProject, type UiProject } from './project'
+export { resolveUiRelease } from './release'
+export { shadcnInvocation, type UiRunner } from './runner'

package/src/ui/lock.ts

@@ -0,0 +1,87 @@
+import { createHash } from 'node:crypto'
+import { readFile } from 'node:fs/promises'
+
+import { UI_LOCK_FILE, UI_PACKAGE, UI_PRESETS, UI_REPOSITORY, UiError, type UiLock } from './model'
+
+export function digest(value: string | Uint8Array): string {
+  return createHash('sha256').update(value).digest('hex')
+}
+
+export function parseUiLock(value: unknown): UiLock {
+  const lock = value as Partial<UiLock> | null
+  if (
+    !lock ||
+    lock.version !== 1 ||
+    lock.package?.name !== UI_PACKAGE ||
+    typeof lock.package.version !== 'string' ||
+    !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u.test(lock.package.version) ||
+    lock.registry?.repository !== UI_REPOSITORY ||
+    lock.registry.ref !== 'v' + lock.package.version ||
+    !/^[0-9a-f]{40}$/u.test(lock.registry.commit ?? '') ||
+    typeof lock.tooling?.shadcn !== 'string' ||
+    !/^\d+\.\d+\.\d+$/u.test(lock.tooling.shadcn) ||
+    lock.tooling.base !== 'base' ||
+    lock.tooling.style !== 'nova' ||
+    typeof lock.tooling.baseUi !== 'string' ||
+    !/^\d+\.\d+\.\d+$/u.test(lock.tooling.baseUi) ||
+    !UI_PRESETS.includes(lock.preset as (typeof UI_PRESETS)[number]) ||
+    !lock.items ||
+    !isRecord(lock.items)
+  ) {
+    throw new UiError('UI_LOCK_INVALID', UI_LOCK_FILE + ' is structurally invalid.')
+  }
+  for (const [address, item] of Object.entries(lock.items)) {
+    if (
+      !/^(?:pattern|block)\/[a-z0-9-]+\/[a-z0-9-/]+$/u.test(address) ||
+      !isRecord(item) ||
+      item.address !== address ||
+      !isDigest(item.sourceDigest) ||
+      !isRecord(item.files)
+    ) {
+      throw new UiError('UI_LOCK_INVALID', UI_LOCK_FILE + ' contains an invalid item record.')
+    }
+    for (const [file, expected] of Object.entries(item.files)) {
+      if (!isSafeRelative(file) || !isDigest(expected)) {
+        throw new UiError('UI_LOCK_INVALID', UI_LOCK_FILE + ' contains an unsafe file record.')
+      }
+    }
+  }
+  return lock as UiLock
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return false
+  const prototype = Object.getPrototypeOf(value)
+  return prototype === Object.prototype || prototype === null
+}
+
+function isDigest(value: unknown): value is string {
+  return typeof value === 'string' && /^[0-9a-f]{64}$/u.test(value)
+}
+
+function isSafeRelative(value: string): boolean {
+  return (
+    value.length > 0 &&
+    !pathIsAbsolute(value) &&
+    !value.split(/[\\/]/u).includes('..') &&
+    !value.includes('\\')
+  )
+}
+
+function pathIsAbsolute(value: string): boolean {
+  return value.startsWith('/') || /^[A-Za-z]:[\\/]/u.test(value)
+}
+
+export async function readUiLock(target: string): Promise<UiLock> {
+  try {
+    return parseUiLock(JSON.parse(await readFile(target, 'utf8')))
+  } catch (cause) {
+    if (cause instanceof UiError) throw cause
+    throw new UiError(
+      'UI_CONFIG_MISSING',
+      'Unable to read ' + UI_LOCK_FILE + '.',
+      'Run astrale ui init.',
+      { cause },
+    )
+  }
+}

package/src/ui/model.ts

@@ -0,0 +1,83 @@
+import { AstraleError } from '../errors'
+
+export const UI_PACKAGE = '@astrale-os/ui'
+export const UI_REPOSITORY = 'astrale-os/ui'
+export const UI_LOCK_FILE = 'astrale-ui.lock.json'
+export const UI_PRESETS = ['astrale', 'compact', 'expressive'] as const
+
+export type UiPreset = (typeof UI_PRESETS)[number]
+export type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun'
+
+export type UiCompatibility = {
+  version: 1
+  shadcn: string
+  base: 'base'
+  style: 'nova'
+  baseUi: string
+  react: string
+  tailwind: string
+  presets: UiPreset[]
+}
+
+export type UiRegistryFile = {
+  path: string
+  type: string
+  target?: string
+  content?: string
+}
+
+export type UiRegistryItem = {
+  name: string
+  type: string
+  title?: string
+  description?: string
+  dependencies?: string[]
+  files: UiRegistryFile[]
+  meta: { canonicalAddress: string; ownership?: string }
+}
+
+export type UiRegistry = { name: string; homepage?: string; items: UiRegistryItem[] }
+
+export type UiLockItem = {
+  address: string
+  sourceDigest: string
+  files: Record<string, string>
+}
+
+export type UiLock = {
+  $schema: string
+  version: 1
+  package: { name: typeof UI_PACKAGE; version: string }
+  registry: { repository: typeof UI_REPOSITORY; ref: string; commit: string }
+  tooling: { shadcn: string; base: 'base'; style: 'nova'; baseUi: string }
+  preset: UiPreset
+  items: Record<string, UiLockItem>
+}
+
+export type UiRelease = {
+  version: string
+  ref: string
+  commit: string
+  compatibility: UiCompatibility
+  registry: UiRegistry
+}
+
+export class UiError extends AstraleError {
+  constructor(
+    code:
+      | 'UI_PROJECT_UNSUPPORTED'
+      | 'UI_CONFIG_MISSING'
+      | 'UI_REGISTRY_UNAVAILABLE'
+      | 'UI_ITEM_NOT_FOUND'
+      | 'UI_ITEM_CONFLICT'
+      | 'UI_LOCAL_CHANGES'
+      | 'UI_DEPENDENCY_INSTALL_FAILED'
+      | 'UI_LOCK_INVALID'
+      | 'UI_TOOL_FAILED',
+    message: string,
+    hint?: string,
+    options?: ErrorOptions,
+  ) {
+    super(code, message, hint, options)
+  }
+}