aplance-ui 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aplance Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# aplance-ui
+
+A source-first React UI CLI by Aplance Technologies. `aplance-ui` scaffolds components, hooks, and tokenized styles directly into your project, so your team owns and edits the generated source as normal app code.
+
+## Install & init
+
+Inside an existing React project (Vite + React, Next.js, TanStack Start, Astro, or Electron-Vite):
+
+```bash
+npx aplance-ui init
+```
+
+The CLI auto-detects your framework, prompts for color/radius/spacing themes and components, then writes everything into your source tree.
+
+## Commands
+
+- `npx aplance-ui init` - scaffold config, styles, and selected components.
+- `npx aplance-ui add <names...>` - add more components later (transitive deps resolved automatically).
+- `npx aplance-ui list` - browse available components and themes.
+
+Common flags: `--all`, `--with-utilities`, `--src-dir`, `--alias`, `--package-manager`, `--dry-run`, `--force`, `--yes`.
+
+## Documentation
+
+Full guides, API reference, theming, and component examples live at **[ui.aplance.com](https://ui.aplance.com)**.
+
+## License
+
+MIT (c) Aplance Technologies. See [LICENSE](./LICENSE).

package/dist/api.d.ts

@@ -0,0 +1,175 @@
+declare const SUPPORTED_TEMPLATES: readonly ["vite-react", "next", "tanstack-start", "astro", "electron-vite"];
+type FrameworkTemplate = (typeof SUPPORTED_TEMPLATES)[number];
+declare const CSS_CONFIG_PLACEMENTS: readonly ["auto", "inline", "file"];
+type CssConfigPlacement = (typeof CSS_CONFIG_PLACEMENTS)[number];
+interface ComponentsConfig {
+    $schema: string;
+    template: FrameworkTemplate;
+    /** Posix-style, relative to cwd. "src" by default; "src/renderer/src" for Electron-Vite. */
+    srcDir: string;
+    /** Path-alias prefix without trailing /* (e.g. "@" → "@/*") */
+    alias: string;
+    /**
+     * Active theme - three independent dimensions.
+     * `color`   selects the palette (slate, zinc, rose, …).
+     * `radius`  selects the corner-radius scale (sharp, rounded, pill, …).
+     * `spacing` selects the gutter scale (compact, spacious, …).
+     * `default` on any axis means "no override".
+     */
+    theme: {
+        color: string;
+        radius: string;
+        spacing: string;
+    };
+    /** Subpaths under srcDir - tweakable but sensible defaults cover 95% of projects */
+    paths: {
+        styles: string;
+        components: string;
+        hooks: string;
+        lib: string;
+    };
+    cssModules: {
+        /** Human-readable CSS-Modules class names. Vite-only; ignored elsewhere. */
+        pretty: boolean;
+    };
+    utilities: {
+        /** Enable postcss-token-utilities in the generated CSS config */
+        enabled: boolean;
+    };
+    cssConfig: {
+        placement: CssConfigPlacement;
+    };
+}
+interface ResolvedPaths {
+    srcDir: string;
+    stylesDir: string;
+    componentsDir: string;
+    hooksDir: string;
+    libDir: string;
+}
+interface MakeDefaultOptions {
+    template: FrameworkTemplate;
+    srcDir?: string;
+    alias?: string;
+    color?: string;
+    radius?: string;
+    spacing?: string;
+    pretty?: boolean;
+    utilities?: boolean;
+    cssConfigPlacement?: CssConfigPlacement;
+}
+declare const makeDefaultConfig: (opts: MakeDefaultOptions) => ComponentsConfig;
+declare const configExists: (cwd: string) => boolean;
+declare const loadConfig: (cwd: string) => ComponentsConfig;
+declare const resolvePaths: (cwd: string, cfg: ComponentsConfig) => ResolvedPaths;
+
+type UnitKind = "component" | "hook" | "lib";
+type UnitGroup = "ui" | "primitives" | null;
+interface RegistryUnit {
+    name: string;
+    kind: UnitKind;
+    group: UnitGroup;
+    files: string[];
+    deps: string[];
+    /**
+     * External npm packages (root specifiers, e.g. `react`, `@tanstack/react-table`)
+     * this unit's source imports. The CLI uses `installMeta.packageVersions` to
+     * resolve version ranges for each entry.
+     */
+    externalDeps: string[];
+}
+interface InstallMeta {
+    baseDependencies: Record<string, string>;
+    baseDevDependencies: Record<string, string>;
+    utilitiesDevDependencies: Record<string, string>;
+    packageVersions: Record<string, string>;
+}
+interface ThemeDescriptor {
+    id: string;
+    label: string;
+    description: string;
+    /** posix-style, relative to registry root. Empty string for the "default" variant. */
+    file: string;
+}
+interface ThemeRegistry {
+    colors: ThemeDescriptor[];
+    radii: ThemeDescriptor[];
+    spacing: ThemeDescriptor[];
+}
+interface Registry {
+    version: number;
+    generated: string;
+    units: RegistryUnit[];
+    themes?: ThemeRegistry;
+    installMeta?: InstallMeta;
+}
+interface LoadedRegistry extends Registry {
+    /** Absolute path to the bundled registry root (contains registry.json + sources). */
+    root: string;
+    themes: ThemeRegistry;
+    installMeta: InstallMeta;
+}
+declare const loadRegistry: () => LoadedRegistry;
+declare const resolveUnits: (registry: Registry, names: string[]) => RegistryUnit[];
+declare const allUnitsInOrder: (registry: Registry) => RegistryUnit[];
+declare const findColor: (registry: LoadedRegistry, id: string) => ThemeDescriptor;
+declare const findRadius: (registry: LoadedRegistry, id: string) => ThemeDescriptor;
+declare const findSpacing: (registry: LoadedRegistry, id: string) => ThemeDescriptor;
+
+declare const PACKAGE_MANAGERS: readonly ["npm", "pnpm", "yarn", "bun"];
+type PackageManager = (typeof PACKAGE_MANAGERS)[number];
+
+interface InitCommandOptions {
+    cwd: string;
+    template?: FrameworkTemplate;
+    srcDir?: string;
+    alias?: string;
+    color?: string;
+    radius?: string;
+    spacing?: string;
+    yes?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
+    skipStyles?: boolean;
+    skipCssConfig?: boolean;
+    withUtilities?: boolean;
+    cssConfigPlacement?: CssConfigPlacement;
+    prettyCssModules?: boolean;
+    /** Rewrite components.json even if it already exists */
+    overwriteConfig?: boolean;
+    /** Pre-selected component names to copy during init. If omitted and yes=false, an interactive multi-select runs. */
+    components?: string[];
+    /** Copy every unit in the registry (library mode). Overrides `components` when true. */
+    all?: boolean;
+    /**
+     * Auto-install runtime + dev dependencies after scaffolding. `true` by default.
+     * When unset and `yes` is false, the CLI prompts for confirmation.
+     * Force-disable with `install: false` (programmatic use) or `--no-install`.
+     */
+    install?: boolean;
+    /** Force a specific package manager instead of auto-detecting from lockfiles. */
+    packageManager?: PackageManager;
+}
+declare const runInit: (opts: InitCommandOptions) => Promise<void>;
+
+interface AddCommandOptions {
+    cwd: string;
+    names: string[];
+    yes?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
+    all?: boolean;
+    /** Auto-install runtime dependencies for the added units. Defaults to true. */
+    install?: boolean;
+    /** Force a specific package manager instead of auto-detecting. */
+    packageManager?: PackageManager;
+}
+declare const runAdd: (opts: AddCommandOptions) => Promise<void>;
+
+interface ListCommandOptions {
+    cwd: string;
+    json?: boolean;
+}
+declare const runList: (opts: ListCommandOptions) => void;
+
+export { type AddCommandOptions, CSS_CONFIG_PLACEMENTS, type ComponentsConfig, type CssConfigPlacement, type FrameworkTemplate, type InitCommandOptions, type InstallMeta, type ListCommandOptions, type LoadedRegistry, type Registry, type RegistryUnit, type ResolvedPaths, SUPPORTED_TEMPLATES, type ThemeDescriptor, type ThemeRegistry, allUnitsInOrder, configExists, findColor, findRadius, findSpacing, loadConfig, loadRegistry, makeDefaultConfig, resolvePaths, resolveUnits, runAdd, runInit, runList };