@incajs/cli 0.0.1 → 0.0.2

package/dist/config/defaults.d.mts

@@ -0,0 +1,44 @@
+import { IncaConfig } from './types.mts';
+/**
+ * The `IncaConfig` fields whose default is a fixed value rather than one
+ * derived from `package.json` or the filesystem — importable alongside
+ * `defineConfig` for an app that wants to inherit or reference them.
+ *
+ * @example
+ * ```ts
+ * import { defaultConfig, defineConfig } from "@incajs/cli/config";
+ *
+ * export default defineConfig({
+ *   ...defaultConfig,
+ *   outDir: "build",
+ * });
+ * ```
+ */
+export declare const defaultConfig: Required<Pick<IncaConfig, "outDir" | "version">>;
+/**
+ * Strips an npm scope off a package name.
+ *
+ * @param name - a `package.json` `"name"`, e.g. `@incajs/cli` or `incajs`
+ * @returns the name with its scope removed, e.g. `cli`; an unscoped name
+ * passes through unchanged
+ */
+export declare function unscopedName(name: string): string;
+/**
+ * Turns a display name into a filesystem/URL-safe slug.
+ *
+ * @param name - e.g. a `productName`
+ * @returns `name` lowercased, with runs of non-`[a-z0-9]` collapsed to a
+ * single `-` and trimmed from both ends
+ */
+export declare function slugify(name: string): string;
+/**
+ * @param pkgName - `package.json`'s own `"name"`, if it has one
+ * @returns the `productName` a plain `package.json` implies — its name with
+ * any scope stripped — or `undefined` if it has none
+ */
+export declare function defaultProductName(pkgName: string | undefined): string | undefined;
+/**
+ * @param productName - the app's resolved display name
+ * @returns a generated `identifier`, e.g. `org.inca.click-counter`
+ */
+export declare function defaultIdentifier(productName: string): string;

package/dist/config/index.d.mts

@@ -0,0 +1,18 @@
+import { IncaConfig } from './types.mts';
+export { defaultConfig } from './defaults.mts';
+export type { IncaConfig } from './types.mts';
+/**
+ * Type-completion helper for `inca.config.ts` — an identity function at
+ * runtime, the same way `defineConfig` from `vite` or `vitest/config` works.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@incajs/cli/config";
+ *
+ * export default defineConfig({
+ *   productName: "Click Counter",
+ *   identifier: "com.example.click-counter",
+ * });
+ * ```
+ */
+export declare const defineConfig: import('c12').DefineConfig<IncaConfig, import('c12').ConfigLayerMeta>;

package/dist/config/loader.d.mts

@@ -0,0 +1,37 @@
+/** `entry`/`outDir` only — what `build()`/`dev()` need, with no `package.json` requirement. */
+export interface ResolvedBuildConfig {
+    /** Absolute path, if `inca.config.ts` set one. */
+    entry?: string;
+    /** Absolute path. */
+    outDir: string;
+}
+/** An app's full config, as `inca package` needs it. */
+export interface ResolvedAppConfig extends ResolvedBuildConfig {
+    productName: string;
+    identifier: string;
+    /** True when `identifier` was generated rather than set explicitly. */
+    identifierIsDefault: boolean;
+    version: string;
+    /** Absolute path, if the app declared one. */
+    icon?: string;
+    /** package.json's `"inca"` key is deprecated; callers warn when this is true. */
+    usedPackageJsonKey: boolean;
+}
+/**
+ * Loads just `entry`/`outDir` from `inca.config.ts`, with derived defaults.
+ * Never touches `package.json`.
+ *
+ * @param cwd - the app's root directory
+ * @returns `entry`/`outDir`, resolved to absolute paths
+ */
+export declare function resolveBuildConfig(cwd: string): Promise<ResolvedBuildConfig>;
+/**
+ * Loads an app's full config for `inca package`: `inca.config.ts` over
+ * `package.json`'s `"inca"` key over derived defaults.
+ *
+ * @param cwd - the app's root directory
+ * @returns the resolved config
+ * @throws if `package.json` is missing, has neither a `name` nor a
+ * `productName`, or an `icon` doesn't resolve to a real file
+ */
+export declare function resolveAppConfig(cwd: string): Promise<ResolvedAppConfig>;

package/dist/config/types.d.mts

@@ -0,0 +1,35 @@
+/**
+ * An app's own `inca.config.ts` (or `.js`/`.json`), loaded by `@incajs/cli`.
+ * `package.json`'s `"inca"` key still works as a fallback, but is
+ * deprecated — this file wins where both are present.
+ */
+export interface IncaConfig {
+    /** Path to an icon file, resolved relative to this config file's own directory. */
+    icon?: string;
+    /**
+     * A reverse-DNS-style unique id — e.g. macOS's `CFBundleIdentifier`.
+     * @default a generated `org.inca.<slug>`
+     */
+    identifier?: string;
+    /**
+     * The app's display name.
+     * @default package.json's "name", with any npm scope stripped
+     */
+    productName?: string;
+    /**
+     * The packaged app's version.
+     * @default package.json's own "version"
+     */
+    version?: string;
+    /**
+     * The app's entry point.
+     * @default resolved automatically — a committed `src/main.mts`, or
+     * `src/App.vue` wrapped in a synthesized one
+     */
+    entry?: string;
+    /**
+     * Where a build's output is written.
+     * @default "dist"
+     */
+    outDir?: string;
+}

package/dist/config.js

@@ -0,0 +1,5 @@
+import { a as e, t } from "./chunks/defaults-EWjAFeZ3.js";
+//#region src/config/index.mts
+var n = e();
+//#endregion
+export { t as defaultConfig, n as defineConfig };

package/dist/index.d.mts

@@ -1 +1,2 @@
 export type { BuildOptions, BuildOutput, Bundler, BundlerOptions, Watcher, } from './adapter/types.mts';
+export type { ResolvedAppConfig } from './config/loader.mts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incajs/cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "The inca CLI: watches an app's entry point through a bundler adapter, starts inca-host once the first bundle lands, and reloads it on every rebuild.",
   "keywords": [
     "bundler",
@@ -15,6 +15,7 @@
     "quickjs",
     "vite"
   ],
+  "homepage": "https://tom96da.github.io/incajs/",
   "license": "(MIT OR Apache-2.0)",
   "repository": {
     "type": "git",
@@ -36,25 +37,30 @@
     ".": {
       "types": "./dist/index.d.mts",
       "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.mts",
+      "import": "./dist/config.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@vitejs/plugin-vue": "^6.0.8",
-    "vite": "^8.2.2"
+    "@vitejs/plugin-vue": "^6.0.9",
+    "vite": "^8.3.0"
   },
   "devDependencies": {
-    "@types/node": "^26.4.1",
-    "@vue/runtime-core": "^3.5.42",
-    "oxfmt": "^0.66.0",
-    "oxlint": "^1.81.0",
-    "rolldown": "~1.2.4",
-    "vue": "^3.5.42"
+    "@types/node": "^26.6.2",
+    "@vue/runtime-core": "^3.5.43",
+    "c12": "4.0.0-rc.1",
+    "oxfmt": "^0.68.0",
+    "oxlint": "^1.83.0",
+    "rolldown": "~1.2.9",
+    "vue": "^3.5.43"
   },
   "peerDependencies": {
-    "vue": "^3.5.42"
+    "vue": "^3.5.43"
   },
   "peerDependenciesMeta": {
     "vue": {
@@ -62,12 +68,12 @@
     }
   },
   "optionalDependencies": {
-    "@incajs/host-darwin-arm64": "0.0.1",
-    "@incajs/host-linux-arm64": "0.0.1",
-    "@incajs/host-linux-x64": "0.0.1"
+    "@incajs/host-darwin-arm64": "0.0.2",
+    "@incajs/host-linux-arm64": "0.0.2",
+    "@incajs/host-linux-x64": "0.0.2"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.18"
   },
   "scripts": {
     "build": "vite build",

package/dist/metadata.d.mts

@@ -1,30 +0,0 @@
-/** An app's identity and version, for `inca package` to stamp onto the application it emits. */
-export interface AppMetadata {
-    /** Shown to the user — the app's display name. */
-    productName: string;
-    /** A reverse-DNS-style unique id — e.g. macOS's `CFBundleIdentifier`. */
-    identifier: string;
-    /** True when `identifier` was derived rather than set by the app. */
-    identifierIsDefault: boolean;
-    /** The packaged app's version. */
-    version: string;
-    /** Absolute path to an icon file, if the app declared one. */
-    icon?: string;
-}
-/**
- * Turns a display name into a filesystem/URL-safe slug — lowercased, with
- * anything outside `[a-z0-9]` collapsed into a single `-`. Used for the
- * default `identifier` and for the Linux packaged-app directory name.
- */
-export declare function slugify(name: string): string;
-/**
- * Reads an app's package metadata for `inca package`: `productName`,
- * `identifier`, `version`, and an optional `icon`. Everything is derived
- * from the app's own `package.json` — its `name`/`version` fields, and an
- * optional `"inca"` key overriding any of them:
- * `{ "inca": { "productName", "identifier", "icon" } }`.
- *
- * @throws if `package.json` is missing, has neither a `name` nor a
- * `"inca".productName`, or `"inca".icon` doesn't resolve to a real file.
- */
-export declare function readAppMetadata(cwd: string): Promise<AppMetadata>;