anhedral 0.1.10 → 0.4.0

package/dist/render.js

@@ -0,0 +1,74 @@
+import { createHash } from 'node:crypto';
+const PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+const MAX_PACKAGE_NAME_LENGTH = 214;
+const RESERVED_PACKAGE_NAMES = new Set(['node_modules', 'favicon.ico']);
+/** Serialize an arbitrary value as a JavaScript/TypeScript string literal. */
+export function jsString(value) {
+    return JSON.stringify(value);
+}
+/** Escape text placed directly in HTML rather than in a JS string. */
+export function htmlText(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/** Keep generated Markdown headings on one line and prevent heading/code injection. */
+export function markdownHeading(value) {
+    const normalized = value.replace(/[\r\n]+/g, ' ').trim() || 'Anhedral App';
+    return normalized.replace(/([\\`*_{}\[\]()<>#+.!|~-])/g, '\\$1');
+}
+export function assertPackageName(value) {
+    const leafName = value.slice(value.lastIndexOf('/') + 1);
+    if (value.length > MAX_PACKAGE_NAME_LENGTH
+        || !PACKAGE_NAME_PATTERN.test(value)
+        || RESERVED_PACKAGE_NAMES.has(leafName)) {
+        throw new Error(`Invalid package name: ${value}`);
+    }
+    return value;
+}
+function compactPackageSegment(value, maximumLength) {
+    if (value.length <= maximumLength)
+        return value;
+    if (maximumLength <= 9)
+        return value.slice(0, maximumLength).replace(/[._-]+$/g, '') || 'a';
+    const digest = createHash('sha256').update(value, 'utf8').digest('hex').slice(0, 8);
+    const prefix = value.slice(0, maximumLength - digest.length - 1).replace(/[._-]+$/g, '') || 'app';
+    return `${prefix}-${digest}`;
+}
+/** Derive a valid, deterministic unscoped npm package name from arbitrary text. */
+export function packageNameFromText(value) {
+    let normalized = value
+        .normalize('NFKD')
+        .replace(/\p{Mark}+/gu, '')
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^[._-]+|[._-]+$/g, '');
+    if (!normalized)
+        normalized = 'anhedral-app';
+    if (RESERVED_PACKAGE_NAMES.has(normalized))
+        normalized = `anhedral-${normalized}`;
+    return assertPackageName(compactPackageSegment(normalized, MAX_PACKAGE_NAME_LENGTH));
+}
+export function childPackageName(projectName, suffix) {
+    assertPackageName(projectName);
+    const normalizedSuffix = packageNameFromText(suffix);
+    const separator = projectName.lastIndexOf('/');
+    if (separator >= 0) {
+        const scope = projectName.slice(0, separator + 1);
+        const leaf = compactPackageSegment(`${projectName.slice(separator + 1)}-${normalizedSuffix}`, MAX_PACKAGE_NAME_LENGTH - scope.length);
+        return assertPackageName(`${scope}${leaf}`);
+    }
+    return assertPackageName(compactPackageSegment(`${projectName}-${normalizedSuffix}`, MAX_PACKAGE_NAME_LENGTH));
+}
+export function identifierSegment(value) {
+    const segment = value
+        .normalize('NFKD')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return segment || 'app';
+}

package/dist/scaffold.d.ts

@@ -1,24 +1,76 @@
 import { type ToolchainChannel } from './toolchain.js';
-export type FrontendMode = 'expo';
-export type AuthMode = 'clerk';
-export type PaymentsMode = 'revenuecat_stripe';
+import { type ModuleId } from './architecture/index.js';
+import { type NativeStylingLibrary, type UiTarget } from './ui.js';
+export type AppSelections = {
+    web: boolean;
+    mobile: boolean;
+    api: boolean;
+    desktop: boolean;
+    extension: boolean;
+};
+export type FeatureSelections = {
+    database: boolean;
+    auth: boolean;
+    billing: boolean;
+    storage: boolean;
+    nativeSubscriptions: boolean;
+    electronUpdater: boolean;
+};
 export interface InitOptions {
     projectName: string;
     displayName: string;
-    auth: AuthMode;
-    payments: PaymentsMode;
-    db: 'neon';
-    orm: 'drizzle';
-    storage: 'r2';
-    api: 'fastify';
+    modules: ModuleId[];
     skipInstall: boolean;
+    dryRun: boolean;
+    json: boolean;
     toolchainChannel: ToolchainChannel;
+    uiComponents?: string[];
+    nativeStyling?: NativeStylingLibrary;
+    /** Destination root. Omit to scaffold the current working directory. */
+    rootDirectory?: string;
+}
+export interface AddOptions {
+    modules: ModuleId[];
+    skipInstall: boolean;
+    dryRun: boolean;
+    json: boolean;
+    toolchainChannel?: ToolchainChannel;
+}
+export interface UiAddOptions {
+    components: string[];
+    targets: UiTarget[];
+    skipInstall: boolean;
+    dryRun: boolean;
+    json: boolean;
+}
+export interface UpgradeOptions {
+    skipInstall: boolean;
+    dryRun: boolean;
+    json: boolean;
 }
 export interface ProjectOptions {
     projectName: string;
     displayName: string;
-    githubOrg: string | null;
-    frontendUrl?: string;
+    apps: AppSelections;
+    features: FeatureSelections;
     skipInstall?: boolean;
+    nativeStyling?: NativeStylingLibrary;
 }
-export declare function scaffoldProject(options: InitOptions): Promise<void>;
+export declare function supportsMobileInstallNode(version: string): boolean;
+export type DoctorIssue = {
+    path: string;
+    severity: 'error' | 'warning';
+    message: string;
+};
+export type DoctorReport = {
+    ok: boolean;
+    schemaVersion: number;
+    generatorVersion: string;
+    issues: DoctorIssue[];
+};
+export declare function isSupportedProjectUpgrade(fromVersion: string, toVersion: string): boolean;
+export declare function scaffoldProject(inputOptions: InitOptions): Promise<void>;
+export declare function scaffoldUiComponents(uiOptions: UiAddOptions): Promise<void>;
+export declare function scaffoldUpgradeProject(upgradeOptions: UpgradeOptions): Promise<void>;
+export declare function scaffoldAddModules(addOptions: AddOptions): Promise<void>;
+export declare function doctorProject(): DoctorReport;