akanjs 3.0.0-alpha.78 → 3.0.0-alpha.79

package/index.ts

@@ -273,6 +273,42 @@ export type AppConfigInput = Omit<DeepPartial<AppConfigResult>, "docker" | "web"
   plugins?: AkanPlugin[];
 };
 export type LibConfigInput = DeepPartial<LibConfigResult> & { plugins?: AkanPlugin[] };
+export interface FleetSpokeDeclaration {
+  /** Short name used on the command line and as the git remote suffix. */
+  name: string;
+  repo: string;
+  /** Apps this spoke serves. Libraries are never listed — they are derived from each app's closure. */
+  apps: string[];
+}
+
+/** What a push installs in each spoke to keep hub-owned files from being edited there. */
+export interface FleetGuardConfig {
+  /** CI system the guard job is written for. `"none"` leaves it out — wire `akan fleet check` yourself. */
+  ci: "github" | "none";
+  /** Add the `akan fleet check` line to the spoke's pre-commit hook. */
+  preCommit: boolean;
+}
+
+/**
+ * What `akan.fleet.ts` at a hub workspace root may write: the customer repos this workspace is mirrored
+ * to. There is no branch field — the branch is whichever one the hub is on, so one declaration serves
+ * every release branch and each of them holds one akanjs version and one copy of the library source.
+ */
+export interface FleetConfigInput {
+  /**
+   * Branches a push may target. A hub feature branch is refused, because pushing it would copy the hub's
+   * branch namespace into every customer repo.
+   */
+  pushableBranches?: string[];
+  /**
+   * Workspace-root entries to keep out of every spoke, on top of the ones that always are. Top-level
+   * names or `dir/` prefixes — a hub's own release and benchmark trees are the usual entries.
+   */
+  exclude?: string[];
+  guard?: Partial<FleetGuardConfig>;
+  spokes: FleetSpokeDeclaration[];
+}
+
 export type AppConfig = AppConfigInput | ((app: AppConfigContext) => AppConfigInput);
 export type LibConfig = LibConfigInput | ((lib: LibConfigContext) => LibConfigInput);
 export type AkanConfigFile = object;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.78",
+  "version": "3.0.0-alpha.79",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/types/index.d.ts

@@ -260,6 +260,39 @@ export type AppConfigInput = Omit<DeepPartial<AppConfigResult>, "docker" | "web"
 export type LibConfigInput = DeepPartial<LibConfigResult> & {
     plugins?: AkanPlugin[];
 };
+export interface FleetSpokeDeclaration {
+    /** Short name used on the command line and as the git remote suffix. */
+    name: string;
+    repo: string;
+    /** Apps this spoke serves. Libraries are never listed — they are derived from each app's closure. */
+    apps: string[];
+}
+/** What a push installs in each spoke to keep hub-owned files from being edited there. */
+export interface FleetGuardConfig {
+    /** CI system the guard job is written for. `"none"` leaves it out — wire `akan fleet check` yourself. */
+    ci: "github" | "none";
+    /** Add the `akan fleet check` line to the spoke's pre-commit hook. */
+    preCommit: boolean;
+}
+/**
+ * What `akan.fleet.ts` at a hub workspace root may write: the customer repos this workspace is mirrored
+ * to. There is no branch field — the branch is whichever one the hub is on, so one declaration serves
+ * every release branch and each of them holds one akanjs version and one copy of the library source.
+ */
+export interface FleetConfigInput {
+    /**
+     * Branches a push may target. A hub feature branch is refused, because pushing it would copy the hub's
+     * branch namespace into every customer repo.
+     */
+    pushableBranches?: string[];
+    /**
+     * Workspace-root entries to keep out of every spoke, on top of the ones that always are. Top-level
+     * names or `dir/` prefixes — a hub's own release and benchmark trees are the usual entries.
+     */
+    exclude?: string[];
+    guard?: Partial<FleetGuardConfig>;
+    spokes: FleetSpokeDeclaration[];
+}
 export type AppConfig = AppConfigInput | ((app: AppConfigContext) => AppConfigInput);
 export type LibConfig = LibConfigInput | ((lib: LibConfigContext) => LibConfigInput);
 export type AkanConfigFile = object;