anhedral 0.4.2 → 0.6.1

package/dist/templates/web.js

@@ -1,569 +0,0 @@
-import path from 'node:path';
-import { writeFile } from '../util.js';
-import { anhedralPrint } from '../print.js';
-import { WEB_APP_DEPENDENCIES } from '../dependencies.js';
-import { childPackageName, jsString } from '../render.js';
-export async function scaffoldWeb(root, options) {
-    const dir = path.join(root, 'apps/web');
-    anhedralPrint.section('Web (Next.js + shadcn/ui)');
-    anhedralPrint.step('Materializing bundled Next.js + shadcn substrate');
-    anhedralPrint.done('Next.js + shadcn substrate materialized');
-    anhedralPrint.step('Writing web app customizations');
-    writePackageJson(dir, options);
-    writeTsConfig(dir);
-    writeNextConfig(dir);
-    writePostcssConfig(dir);
-    writeShadcnConfig(dir);
-    writeEnvExample(dir, options);
-    writeUiFiles(dir, options);
-    writeAppFiles(dir, options);
-    anhedralPrint.done('Next.js web app written');
-}
-function writePackageJson(dir, options) {
-    const dependencies = { ...(WEB_APP_DEPENDENCIES.dependencies ?? {}) };
-    if (!options.apps.api)
-        delete dependencies['@shared/api-client'];
-    if (!options.features.billing)
-        delete dependencies['@shared/realtime'];
-    if (!options.features.auth) {
-        delete dependencies['@clerk/nextjs'];
-        delete dependencies['@clerk/ui'];
-    }
-    writeFile(path.join(dir, 'package.json'), JSON.stringify({
-        name: childPackageName(options.projectName, 'web'),
-        version: '0.1.0',
-        private: true,
-        type: 'module',
-        scripts: {
-            dev: 'next dev',
-            build: 'next build',
-            start: 'next start',
-            typecheck: 'tsc --noEmit',
-        },
-        dependencies,
-        devDependencies: WEB_APP_DEPENDENCIES.devDependencies,
-    }, null, 2) + '\n');
-}
-function writeTsConfig(dir) {
-    writeFile(path.join(dir, 'tsconfig.json'), JSON.stringify({
-        compilerOptions: {
-            target: 'ES2017',
-            lib: ['dom', 'dom.iterable', 'esnext'],
-            allowJs: true,
-            skipLibCheck: true,
-            strict: true,
-            noEmit: true,
-            esModuleInterop: true,
-            module: 'esnext',
-            moduleResolution: 'bundler',
-            resolveJsonModule: true,
-            isolatedModules: true,
-            jsx: 'react-jsx',
-            incremental: true,
-            plugins: [{ name: 'next' }],
-            paths: { '@/*': ['./*'] },
-        },
-        include: ['next-env.d.ts', '**/*.ts', '**/*.tsx', '.next/types/**/*.ts', '.next/dev/types/**/*.ts'],
-        exclude: ['node_modules'],
-    }, null, 2) + '\n');
-}
-function writeNextConfig(dir) {
-    writeFile(path.join(dir, 'next.config.ts'), `import type { NextConfig } from 'next';
-
-const nextConfig: NextConfig = {
-  async rewrites() {
-    if (process.env.NODE_ENV !== 'development') return [];
-    return [{ source: '/api/:path*', destination: 'http://localhost:8787/api/:path*' }];
-  },
-};
-
-export default nextConfig;
-`);
-}
-function writePostcssConfig(dir) {
-    writeFile(path.join(dir, 'postcss.config.mjs'), `const config = {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-};
-
-export default config;
-`);
-}
-function writeShadcnConfig(dir) {
-    writeFile(path.join(dir, 'components.json'), JSON.stringify({
-        $schema: 'https://ui.shadcn.com/schema.json',
-        style: 'new-york',
-        rsc: true,
-        tsx: true,
-        tailwind: {
-            config: '',
-            css: 'app/globals.css',
-            baseColor: 'neutral',
-            cssVariables: true,
-            prefix: '',
-        },
-        aliases: {
-            components: '@/components',
-            utils: '@/lib/utils',
-            ui: '@/components/ui',
-            lib: '@/lib',
-            hooks: '@/hooks',
-        },
-        iconLibrary: 'lucide',
-    }, null, 2) + '\n');
-}
-function writeEnvExample(dir, options) {
-    const lines = [
-        options.apps.api ? 'NEXT_PUBLIC_API_URL=http://localhost:8787/api' : null,
-        options.features.auth ? 'NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_***' : null,
-    ].filter((value) => value !== null);
-    writeFile(path.join(dir, '.env.example'), lines.join('\n') + (lines.length > 0 ? '\n' : ''));
-}
-function writeUiFiles(dir, options) {
-    writeFile(path.join(dir, 'lib/utils.ts'), `import { clsx, type ClassValue } from 'clsx';
-import { twMerge } from 'tailwind-merge';
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}
-`);
-    if (options.apps.api)
-        writeFile(path.join(dir, 'lib/api.ts'), `import { ApiClient, normalizeApiBaseUrl } from '@shared/api-client';
-
-function normalizeWebApiBaseUrl(value: string): string {
-  const candidate = value.trim();
-  if (!candidate.startsWith('/')) return normalizeApiBaseUrl(candidate, 'NEXT_PUBLIC_API_URL');
-  if (candidate.startsWith('//') || candidate.includes('\\\\')) {
-    throw new Error('NEXT_PUBLIC_API_URL must be a single-slash root-relative path or an absolute URL');
-  }
-  // Client components also render during Next.js builds. The server-only origin is
-  // never requested; hydration recreates the client with the browser's real origin.
-  const origin = typeof window === 'undefined' ? 'http://localhost' : window.location.origin;
-  return normalizeApiBaseUrl(new URL(candidate, origin).toString(), 'NEXT_PUBLIC_API_URL');
-}
-
-function apiBaseUrl(): string {
-  const configured = process.env.NEXT_PUBLIC_API_URL?.trim();
-  const candidate = configured || (process.env.NODE_ENV === 'development' ? 'http://localhost:8787/api' : '/api');
-  const normalized = normalizeWebApiBaseUrl(candidate);
-  const url = new URL(normalized);
-  const loopback = url.hostname === 'localhost' || url.hostname === '127.0.0.1' || url.hostname === '[::1]';
-  if (process.env.NODE_ENV === 'production' && url.protocol !== 'https:' && !loopback) {
-    throw new Error('NEXT_PUBLIC_API_URL must use https: in production');
-  }
-  return normalized;
-}
-
-export function createApiClient(getToken?: () => Promise<string | null>) {
-  return new ApiClient({
-    baseUrl: apiBaseUrl(),
-    getToken: getToken ?? (async () => null),
-  });
-}
-`);
-    if (options.apps.api) {
-        writeFile(path.join(dir, 'hooks/use-api-client.ts'), options.features.auth ? `'use client';
-
-import { useAuth } from '@clerk/nextjs';
-import { useMemo } from 'react';
-import { createApiClient } from '@/lib/api';
-
-export function useApiClient() {
-  const { getToken } = useAuth();
-  return useMemo(() => createApiClient(() => getToken()), [getToken]);
-}
-` : `'use client';
-
-import { useMemo } from 'react';
-import { createApiClient } from '@/lib/api';
-
-export function useApiClient() {
-  return useMemo(() => createApiClient(), []);
-}
-`);
-    }
-    if (options.apps.api && options.features.database) {
-        const authImport = options.features.auth ? "import { useAuth } from '@clerk/nextjs';\n" : '';
-        const authState = options.features.auth ? '  const { isLoaded, isSignedIn, userId } = useAuth();\n' : '';
-        const identityState = options.features.auth
-            ? '  const identity = isLoaded && isSignedIn ? userId ?? null : null;\n'
-            : "  const identity = 'public';\n";
-        const authGuard = options.features.auth
-            ? `  if (!isLoaded || (isSignedIn && !userId)) return <p className="text-sm text-muted-foreground">Loading account…</p>;
-  if (!isSignedIn) return <p className="text-sm text-muted-foreground">Sign in to use the working starter feature.</p>;
-
-`
-            : '';
-        writeFile(path.join(dir, 'components/item-list.tsx'), `'use client';
-
-import { createItem, listItems, type Item } from '@shared/api-client';
-${authImport}import * as React from 'react';
-import { useApiClient } from '@/hooks/use-api-client';
-import { Button } from '@/components/ui/button';
-
-export function ItemList() {
-${authState}${identityState}  const api = useApiClient();
-  const [items, setItems] = React.useState<Item[]>([]);
-  const [loadedIdentity, setLoadedIdentity] = React.useState<string | null>(null);
-  const [name, setName] = React.useState('');
-  const [status, setStatus] = React.useState<'loading' | 'ready' | 'saving'>('loading');
-  const [error, setError] = React.useState<string | null>(null);
-  const identityRef = React.useRef(identity);
-  const visibleItems = loadedIdentity === identity ? items : [];
-  const visibleError = loadedIdentity === identity ? error : null;
-  const isLoading = status === 'loading' || loadedIdentity !== identity;
-
-  React.useEffect(() => {
-    identityRef.current = identity;
-    if (!identity) return;
-    let active = true;
-    setLoadedIdentity(identity);
-    setItems([]);
-    setName('');
-    setError(null);
-    setStatus('loading');
-    void listItems(api).then((nextItems) => {
-      if (active) setItems(nextItems);
-    }).catch((cause: unknown) => {
-      if (active) setError(cause instanceof Error ? cause.message : 'Unable to load items');
-    }).finally(() => {
-      if (active) setStatus('ready');
-    });
-    return () => { active = false; };
-  }, [api, identity]);
-
-  async function submit(event: React.FormEvent<HTMLFormElement>) {
-    event.preventDefault();
-    const nextName = name.trim();
-    if (!identity || !nextName || status !== 'ready' || loadedIdentity !== identity) return;
-    const submittedIdentity = identity;
-    setStatus('saving');
-    try {
-      const created = await createItem(api, { name: nextName });
-      if (identityRef.current !== submittedIdentity) return;
-      setItems((current) => [created, ...current]);
-      setName('');
-      setError(null);
-    } catch (cause) {
-      if (identityRef.current === submittedIdentity) {
-        setError(cause instanceof Error ? cause.message : 'Unable to create item');
-      }
-    } finally {
-      if (identityRef.current === submittedIdentity) setStatus('ready');
-    }
-  }
-
-${authGuard}  return (
-    <div className="space-y-4">
-      <form className="flex gap-2" onSubmit={(event) => void submit(event)}>
-        <label className="sr-only" htmlFor="item-name">Item name</label>
-        <input
-          id="item-name"
-          className="h-9 flex-1 rounded-md border border-input bg-background px-3 text-sm"
-          maxLength={120}
-          onChange={(event) => setName(event.target.value)}
-          placeholder="Your first item"
-          value={name}
-        />
-        <Button disabled={status !== 'ready' || loadedIdentity !== identity || !name.trim()} type="submit">
-          {status === 'saving' ? 'Adding…' : 'Add item'}
-        </Button>
-      </form>
-      {visibleError ? (
-        <p className="text-sm text-red-700" role="alert">
-          {visibleError}. Check DATABASE_URL, run pnpm db:migrate, and make sure the API is running.
-        </p>
-      ) : null}
-      {isLoading ? <p className="text-sm text-muted-foreground">Loading items…</p> : null}
-      {!isLoading && visibleItems.length === 0 && !visibleError
-        ? <p className="text-sm text-muted-foreground">Your database is connected. Add the first item.</p>
-        : null}
-      {visibleItems.length > 0 ? (
-        <ul className="divide-y rounded-md border">
-          {visibleItems.map((item) => <li className="px-3 py-2 text-sm" key={item.id}>{item.name}</li>)}
-        </ul>
-      ) : null}
-    </div>
-  );
-}
-`);
-    }
-    if (options.features.billing) {
-        writeFile(path.join(dir, 'hooks/use-entitlement.ts'), `'use client';
-
-import { subscribeToSubscriptionChanges } from '@shared/realtime';
-import { useAuth } from '@clerk/nextjs';
-import * as React from 'react';
-import { useApiClient } from './use-api-client';
-
-export function useEntitlement() {
-  const api = useApiClient();
-  const { isLoaded, isSignedIn, userId } = useAuth();
-  const identity = isLoaded && isSignedIn ? userId : null;
-  const [state, setState] = React.useState<Awaited<ReturnType<typeof api.getEntitlement>> | null>(null);
-  const [loadedIdentity, setLoadedIdentity] = React.useState<string | null>(null);
-  const [error, setError] = React.useState<string | null>(null);
-  const revision = React.useRef(0);
-  const identityRef = React.useRef(identity);
-  const refresh = React.useCallback(async () => {
-    if (!identity) return;
-    try {
-      const next = await api.getEntitlement();
-      if (identityRef.current !== identity) return;
-      revision.current = Math.max(revision.current, next.revision);
-      setState(next);
-      setLoadedIdentity(identity);
-      setError(null);
-    } catch (cause) {
-      if (identityRef.current !== identity) return;
-      setLoadedIdentity(identity);
-      setError(cause instanceof Error ? cause.message : 'Unable to load subscription');
-    }
-  }, [api, identity]);
-
-  React.useEffect(() => {
-    identityRef.current = identity;
-    revision.current = 0;
-    setState(null);
-    setLoadedIdentity(null);
-    setError(null);
-    void refresh();
-  }, [identity, refresh]);
-  React.useEffect(() => {
-    const onVisibility = () => { if (document.visibilityState === 'visible') void refresh(); };
-    document.addEventListener('visibilitychange', onVisibility);
-    return () => document.removeEventListener('visibilitychange', onVisibility);
-  }, [refresh]);
-  React.useEffect(() => {
-    if (!identity) return;
-    return subscribeToSubscriptionChanges({
-      userId: identity,
-      getTokenRequest: () => api.getRealtimeToken(),
-      onChange: (nextRevision) => {
-        if (nextRevision > revision.current) void refresh();
-      },
-      onError: (cause) => {
-        if (identityRef.current === identity) {
-          setLoadedIdentity(identity);
-          setError(cause.message);
-        }
-      },
-    });
-  }, [api, identity, refresh]);
-  return {
-    entitlement: loadedIdentity === identity ? state : null,
-    error: loadedIdentity === identity ? error : null,
-    refresh,
-  };
-}
-`);
-        writeFile(path.join(dir, 'components/subscription-status.tsx'), `'use client';
-
-import { useEntitlement } from '@/hooks/use-entitlement';
-
-export function SubscriptionStatus() {
-  const { entitlement, error } = useEntitlement();
-  if (error) return <p role="alert" className="text-sm text-red-700">{error}</p>;
-  if (!entitlement) return <p className="text-sm text-muted-foreground">Loading subscription…</p>;
-  return <p className="text-sm text-muted-foreground">Plan: {entitlement.entitlement} ({entitlement.status})</p>;
-}
-`);
-    }
-    if (options.features.auth) {
-        writeFile(path.join(dir, 'components/account-actions.tsx'), `'use client';
-
-import { Show, SignInButton, UserButton } from '@clerk/nextjs';
-import { Button } from '@/components/ui/button';
-
-export function AccountActions() {
-  return (
-    <>
-      <Show when="signed-out">
-        <SignInButton mode="modal">
-          <Button variant="outline">Sign in</Button>
-        </SignInButton>
-      </Show>
-      <Show when="signed-in">
-        <UserButton />
-      </Show>
-    </>
-  );
-}
-`);
-    }
-    writeFile(path.join(dir, 'components/ui/button.tsx'), `import * as React from 'react';
-import { cn } from '@/lib/utils';
-
-export type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
-  variant?: 'default' | 'outline';
-};
-
-export function Button({ className, variant = 'default', type = 'button', ...props }: ButtonProps) {
-  return (
-    <button
-      type={type}
-      className={cn(
-        'inline-flex h-9 items-center justify-center rounded-md px-4 text-sm font-medium transition-colors disabled:pointer-events-none disabled:opacity-50',
-        variant === 'outline' ? 'border border-input bg-background hover:bg-accent' : 'bg-primary text-primary-foreground hover:bg-primary/90',
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-`);
-    writeFile(path.join(dir, 'components/ui/card.tsx'), `import * as React from 'react';
-import { cn } from '@/lib/utils';
-
-export function Card({ className, ...props }: React.ComponentProps<'div'>) {
-  return <div className={cn('rounded-lg border bg-card text-card-foreground shadow-sm', className)} {...props} />;
-}
-
-export function CardHeader({ className, ...props }: React.ComponentProps<'div'>) {
-  return <div className={cn('flex flex-col gap-1.5 p-6', className)} {...props} />;
-}
-
-export function CardTitle({ className, ...props }: React.ComponentProps<'h3'>) {
-  return <h3 className={cn('text-2xl font-semibold leading-none', className)} {...props} />;
-}
-
-export function CardContent({ className, ...props }: React.ComponentProps<'div'>) {
-  return <div className={cn('p-6 pt-0', className)} {...props} />;
-}
-`);
-}
-function writeAppFiles(dir, options) {
-    const { displayName } = options;
-    const displayNameLiteral = jsString(displayName);
-    const descriptionLiteral = jsString(`${displayName} web app`);
-    const accountActionsImport = options.features.auth
-        ? "import { AccountActions } from '@/components/account-actions';\n"
-        : '';
-    const accountAction = options.features.auth
-        ? `{process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY && !process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY.includes('***') ? (
-            <AccountActions />
-          ) : (
-            <Button variant="outline" disabled>Configure Clerk to sign in</Button>
-          )}`
-        : '';
-    const starterLink = options.apps.api && options.features.database
-        ? '<a className="inline-flex h-9 items-center justify-center rounded-md bg-primary px-4 text-sm font-medium text-primary-foreground transition-colors hover:bg-primary/90" href="#starter-feature">Open starter feature</a>'
-        : '';
-    const heroActions = starterLink || accountAction
-        ? `        <div className="flex gap-3">
-          ${starterLink}
-          ${accountAction}
-        </div>
-`
-        : '';
-    const clerkStyles = options.features.auth ? '@import "@clerk/ui/themes/shadcn.css";\n' : '';
-    writeFile(path.join(dir, 'app/globals.css'), `@import "tailwindcss";
-${clerkStyles}
-
-:root {
-  --background: oklch(1 0 0);
-  --foreground: oklch(0.145 0 0);
-  --card: oklch(1 0 0);
-  --card-foreground: oklch(0.145 0 0);
-  --primary: oklch(0.205 0 0);
-  --primary-foreground: oklch(0.985 0 0);
-  --muted: oklch(0.97 0 0);
-  --muted-foreground: oklch(0.556 0 0);
-  --accent: oklch(0.97 0 0);
-  --border: oklch(0.922 0 0);
-  --input: oklch(0.922 0 0);
-}
-
-@theme inline {
-  --color-background: var(--background);
-  --color-foreground: var(--foreground);
-  --color-card: var(--card);
-  --color-card-foreground: var(--card-foreground);
-  --color-primary: var(--primary);
-  --color-primary-foreground: var(--primary-foreground);
-  --color-muted: var(--muted);
-  --color-muted-foreground: var(--muted-foreground);
-  --color-accent: var(--accent);
-  --color-border: var(--border);
-  --color-input: var(--input);
-}
-
-body {
-  background: var(--background);
-  color: var(--foreground);
-  font-family: Arial, Helvetica, sans-serif;
-}
-`);
-    const authImport = options.features.auth
-        ? "import { ClerkProvider } from '@clerk/nextjs';\nimport { shadcn } from '@clerk/ui/themes';\n"
-        : '';
-    const providers = options.features.auth ? `function Providers({ children }: Readonly<{ children: React.ReactNode }>) {
-  const publishableKey = process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY;
-  if (!publishableKey || publishableKey.includes('***')) return <>{children}</>;
-  return <ClerkProvider publishableKey={publishableKey} appearance={{ theme: shadcn }}>{children}</ClerkProvider>;
-}` : `function Providers({ children }: Readonly<{ children: React.ReactNode }>) {
-  return <>{children}</>;
-}`;
-    writeFile(path.join(dir, 'app/layout.tsx'), `import type { Metadata } from 'next';
-${authImport}import './globals.css';
-
-export const metadata: Metadata = {
-  title: ${displayNameLiteral},
-  description: ${descriptionLiteral},
-};
-
-${providers}
-
-export default function RootLayout({ children }: Readonly<{ children: React.ReactNode }>) {
-  return (
-    <html lang="en">
-      <body>
-        <Providers>{children}</Providers>
-      </body>
-    </html>
-  );
-}
-`);
-    const subscriptionImport = options.features.billing ? "import { SubscriptionStatus } from '@/components/subscription-status';\n" : '';
-    const itemListImport = options.apps.api && options.features.database ? "import { ItemList } from '@/components/item-list';\n" : '';
-    const subscriptionStatus = options.features.billing
-        ? "        {process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY && !process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY.includes('***') ? <SubscriptionStatus /> : null}\n"
-        : '';
-    const starterContent = options.apps.api && options.features.database
-        ? options.features.auth
-            ? `{process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY && !process.env.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY.includes('***')
-            ? <ItemList />
-            : <p>Configure Clerk to activate the starter feature.</p>}`
-            : '<ItemList />'
-        : options.apps.api
-            ? 'Contracts, API access, and configuration are shared through workspace packages.'
-            : 'Add modules later with pnpm anhedral:add; user-owned source remains untouched.';
-    const starterTitle = options.apps.api && options.features.database ? 'Working starter feature' : 'Shared modules';
-    const buttonImport = options.features.auth ? "import { Button } from '@/components/ui/button';\n" : '';
-    writeFile(path.join(dir, 'app/page.tsx'), `${accountActionsImport}${subscriptionImport}${itemListImport}import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
-${buttonImport}
-
-export default function Home() {
-  return (
-    <main className="mx-auto flex min-h-screen max-w-5xl flex-col gap-8 px-6 py-10">
-      <section className="flex flex-col gap-3">
-        <h1 className="text-4xl font-semibold tracking-normal">{${displayNameLiteral}}</h1>
-        <p className="max-w-2xl text-muted-foreground">
-          ${options.apps.api ? 'Next.js + shadcn/ui web client connected to the shared Fastify API.' : 'Next.js + shadcn/ui web application.'}
-        </p>
-${heroActions}
-${subscriptionStatus}      </section>
-      <Card id="starter-feature">
-        <CardHeader>
-          <CardTitle>${starterTitle}</CardTitle>
-        </CardHeader>
-        <CardContent className="text-sm text-muted-foreground">
-          ${starterContent}
-        </CardContent>
-      </Card>
-    </main>
-  );
-}
-`);
-}

package/dist/toolchain.d.ts

@@ -1,3 +0,0 @@
-export declare const TOOLCHAIN_CHANNELS: readonly ["latest", "stable"];
-export type ToolchainChannel = (typeof TOOLCHAIN_CHANNELS)[number];
-export declare function resolveToolchainChannel(value: string | undefined): ToolchainChannel;

package/dist/toolchain.js

@@ -1,8 +0,0 @@
-export const TOOLCHAIN_CHANNELS = ['latest', 'stable'];
-export function resolveToolchainChannel(value) {
-    if (!value)
-        return 'stable';
-    if (value === 'latest' || value === 'stable')
-        return value;
-    throw new Error(`--toolchain must be one of: ${TOOLCHAIN_CHANNELS.join(', ')}`);
-}

package/dist/ui.d.ts

@@ -1,33 +0,0 @@
-export declare const UI_TARGETS: readonly ["web", "mobile", "desktop", "extension"];
-export declare const NATIVE_STYLING_LIBRARIES: readonly ["nativewind", "uniwind"];
-export declare const UI_PROVIDERS: readonly ["shadcn", "react-native-reusables"];
-export type UiTarget = (typeof UI_TARGETS)[number];
-export type NativeStylingLibrary = (typeof NATIVE_STYLING_LIBRARIES)[number];
-export type UiProvider = (typeof UI_PROVIDERS)[number];
-export type UiComponentInstall = {
-    readonly name: string;
-    readonly target: UiTarget;
-    readonly provider: UiProvider;
-    readonly source: string;
-    readonly variant: NativeStylingLibrary | null;
-};
-export type UiInstallCommand = {
-    readonly target: UiTarget;
-    readonly cwd: string;
-    readonly executable: 'pnpm';
-    readonly args: readonly string[];
-    readonly installs: readonly UiComponentInstall[];
-};
-export declare function reconcileUiWorkspaceDependencies(workspaceRoot: string, targetDirectory: string): void;
-export declare function isUiTarget(value: unknown): value is UiTarget;
-export declare function isNativeStylingLibrary(value: unknown): value is NativeStylingLibrary;
-export declare function isUiProvider(value: unknown): value is UiProvider;
-export declare function normalizeUiComponentName(value: string): string;
-export declare function parseUiComponentList(value: string): string[];
-export declare function providerForTarget(target: UiTarget): UiProvider;
-export declare function registrySourceFor(name: string, target: UiTarget, nativeStyling: NativeStylingLibrary): string;
-export declare function resolveUiInstalls(componentNames: readonly string[], targets: readonly UiTarget[], nativeStyling: NativeStylingLibrary): readonly UiComponentInstall[];
-export declare function uiInstallKey(install: Pick<UiComponentInstall, 'target' | 'name'>): string;
-export declare function mergeUiInstalls(current: readonly UiComponentInstall[], additions: readonly UiComponentInstall[]): readonly UiComponentInstall[];
-export declare function buildUiInstallCommands(root: string, installs: readonly UiComponentInstall[]): readonly UiInstallCommand[];
-export declare function installUiComponents(root: string, installs: readonly UiComponentInstall[]): void;