@multiplatform.one/cli 6.1.0 → 6.4.0

package/templates/universal/packages/i18n/resources.ts

@@ -0,0 +1,13 @@
+// Static resource map for native (web loads translations through the vite
+// i18next loader instead — see apps/__NAME__/routes/_layout.web.tsx).
+import en from "./en/common.json";
+import es from "./es/common.json";
+
+export const resources = {
+  en: {
+    common: en,
+  },
+  es: {
+    common: es,
+  },
+};

package/templates/universal/packages/i18n/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["./*.ts", "./**/*.json", "../../types/env.d.ts"],
+  "exclude": ["**/node_modules/**"]
+}

package/templates/universal/packages/themes/accent.ts

@@ -0,0 +1,32 @@
+// Framework default brand accent: solid-surface hsla(250) ramps. Replace with
+// your brand color ramps to rebrand the whole app in one place.
+export const accentTheme = {
+  darkPalette: [
+    "hsla(250, 50%, 35%, 1)",
+    "hsla(250, 50%, 38%, 1)",
+    "hsla(250, 50%, 41%, 1)",
+    "hsla(250, 50%, 43%, 1)",
+    "hsla(250, 50%, 46%, 1)",
+    "hsla(250, 50%, 49%, 1)",
+    "hsla(250, 50%, 52%, 1)",
+    "hsla(250, 50%, 54%, 1)",
+    "hsla(250, 50%, 57%, 1)",
+    "hsla(250, 50%, 60%, 1)",
+    "hsla(250, 50%, 90%, 1)",
+    "hsla(250, 50%, 95%, 1)",
+  ],
+  lightPalette: [
+    "hsla(250, 50%, 95%, 1)",
+    "hsla(250, 50%, 95%, 1)",
+    "hsla(250, 50%, 65%, 1)",
+    "hsla(250, 50%, 62%, 1)",
+    "hsla(250, 50%, 59%, 1)",
+    "hsla(250, 50%, 57%, 1)",
+    "hsla(250, 50%, 54%, 1)",
+    "hsla(250, 50%, 51%, 1)",
+    "hsla(250, 50%, 48%, 1)",
+    "hsla(250, 50%, 46%, 1)",
+    "hsla(250, 50%, 43%, 1)",
+    "hsla(250, 50%, 40%, 1)",
+  ],
+};

package/templates/universal/packages/themes/base.ts

@@ -0,0 +1,50 @@
+// Framework default neutral ramps: Radix-mauve-shaped with a slight purple
+// tint (hue 270) harmonizing with the hsla(250) accent. Steps: near-white
+// surfaces (1-2), component/hover (3-5), borders (6-8), solid/muted (9-10),
+// readable text (11-12). Swap these palettes to rebrand.
+export const baseTheme = {
+  darkPalette: [
+    "hsla(270, 6%, 8.7%, 1)",
+    "hsla(270, 6%, 10.5%, 1)",
+    "hsla(270, 6%, 13.5%, 1)",
+    "hsla(270, 6%, 16%, 1)",
+    "hsla(270, 6%, 18.5%, 1)",
+    "hsla(270, 6%, 21.5%, 1)",
+    "hsla(270, 6%, 25.5%, 1)",
+    "hsla(270, 6%, 32%, 1)",
+    "hsla(270, 6%, 43%, 1)",
+    "hsla(270, 6%, 48%, 1)",
+    "hsla(270, 6%, 62.5%, 1)",
+    "hsla(270, 6%, 94%, 1)",
+  ],
+  lightPalette: [
+    "hsla(270, 6%, 99.5%, 1)",
+    "hsla(270, 6%, 98.2%, 1)",
+    "hsla(270, 6%, 95.2%, 1)",
+    "hsla(270, 6%, 92.5%, 1)",
+    "hsla(270, 6%, 90%, 1)",
+    "hsla(270, 6%, 87%, 1)",
+    "hsla(270, 6%, 82.5%, 1)",
+    "hsla(270, 6%, 75%, 1)",
+    "hsla(270, 6%, 56.5%, 1)",
+    "hsla(270, 6%, 52%, 1)",
+    "hsla(270, 6%, 40%, 1)",
+    "hsla(270, 6%, 14%, 1)",
+  ],
+  lightShadows: {
+    shadow1: "rgba(0,0,0,0.04)",
+    shadow2: "rgba(0,0,0,0.08)",
+    shadow3: "rgba(0,0,0,0.16)",
+    shadow4: "rgba(0,0,0,0.24)",
+    shadow5: "rgba(0,0,0,0.32)",
+    shadow6: "rgba(0,0,0,0.4)",
+  },
+  darkShadows: {
+    shadow1: "rgba(0,0,0,0.2)",
+    shadow2: "rgba(0,0,0,0.3)",
+    shadow3: "rgba(0,0,0,0.4)",
+    shadow4: "rgba(0,0,0,0.5)",
+    shadow5: "rgba(0,0,0,0.6)",
+    shadow6: "rgba(0,0,0,0.7)",
+  },
+};

package/templates/universal/packages/themes/fonts.ts

@@ -0,0 +1,8 @@
+import { createFontLoader } from "@multiplatform.one/theme";
+
+// Loads the default Inter faces on native (web gets them via CSS). Add custom
+// fonts by listing { family, nativeModule } entries.
+export const { importFonts } = createFontLoader({
+  fonts: [],
+  inter: true,
+});

package/templates/universal/packages/themes/index.ts

@@ -0,0 +1,33 @@
+import { createDefaultThemeConfig } from "@multiplatform.one/theme";
+import { accentTheme } from "./accent";
+import { baseTheme } from "./base";
+
+// House defaults: neutral base ramps + brand accent ramps with a normalized
+// interaction ramp. Fonts fall back to the framework's Inter defaults —
+// pass `fonts` here to customize.
+export const themeConfig = createDefaultThemeConfig({
+  base: baseTheme,
+  accent: accentTheme,
+  builderOptions: {
+    getTheme: ({ theme }) => ({
+      // Interaction ramp: background 5 → 6 → 4, border 5 → 6 → 7.
+      backgroundPress: theme.color5,
+      backgroundFocus: theme.color6,
+      backgroundActive: theme.color4,
+      placeholderColor: theme.color10,
+      borderColor: theme.color5,
+      borderColorHover: theme.color6,
+      borderColorFocus: theme.color7,
+      borderColorPress: theme.color7,
+      // Semantic aliases for palette slots not covered by Tamagui defaults.
+      textMuted: theme.color10,
+      textSubtle: theme.color6,
+      borderStrong: theme.color7,
+      borderStrongHover: theme.color8,
+      borderStrongPress: theme.color6,
+      surfaceStrong: theme.color7,
+      surfaceMuted: theme.color10,
+      surfacePressStrong: theme.color6,
+    }),
+  },
+});

package/templates/universal/packages/themes/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@package/themes",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts",
+    "./fonts": "./fonts.ts",
+    "./tamagui.config": "./tamagui.config.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@multiplatform.one/theme": "__MPO_VERSION__",
+    "@tamagui/font-inter": "2.0.0-rc.41",
+    "tamagui": "2.0.0-rc.41"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3"
+  }
+}

package/templates/universal/packages/themes/tamagui.config.ts

@@ -0,0 +1,14 @@
+import { themeConfig } from "./index";
+
+export const config = themeConfig.tamagui;
+export type AppConfig = typeof config;
+
+// Module augmentation must target @tamagui/web where TamaguiCustomConfig is
+// defined; keep the @tamagui/core augmentation for consumers importing types
+// from there.
+declare module "@tamagui/web" {
+  interface TamaguiCustomConfig extends AppConfig {}
+}
+declare module "@tamagui/core" {
+  interface TamaguiCustomConfig extends AppConfig {}
+}

package/templates/universal/packages/themes/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["./*.ts", "../../types/env.d.ts"],
+  "exclude": ["**/node_modules/**"]
+}

package/templates/universal/pnpm-workspace.yaml

@@ -0,0 +1,4 @@
+packages:
+  - apps/*
+  - features/*
+  - packages/*

package/templates/universal/tsconfig.base.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    // Published @multiplatform.one/* packages currently resolve types to
+    // their TypeScript sources (not compiled .d.ts), so typecheck re-checks
+    // framework code. Implicit-any strictness is relaxed until the packages
+    // publish compiled declarations; the rest of strict mode stays on.
+    "noImplicitAny": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  }
+}

package/templates/universal/types/env.d.ts

@@ -0,0 +1,9 @@
+// Published @multiplatform.one/* packages ship TypeScript source, so package
+// typechecks follow them into code that reads import.meta.env (vite-injected).
+// Packages that don't load vite/client types include this minimal shape
+// instead (apps/* use vite/client directly). Values are `any` to match
+// vite/client's ImportMetaEnv index signature.
+interface ImportMeta {
+  // biome-ignore lint/suspicious/noExplicitAny: mirrors vite/client typing
+  readonly env?: Record<string, any>;
+}

package/types/bin/multiplatformOne.d.ts

@@ -0,0 +1,11 @@
+/** Workspaces that have Storybook and can run visual regression (discovered from filesystem + package.json). */
+export type StorybookVisualWorkspace = {
+    dirName: string;
+    absolutePath: string;
+    /** How to run visual test: run `make test/visual` in absolutePath, or run pnpm script by name. */
+    runVisual: "make" | "pnpm";
+    pnpmScript?: string;
+    /** If true, run `pnpm run build` then `pnpm exec lost-pixel` in workspace (no named script). */
+    runLostPixelAfterBuild?: boolean;
+};
+//# sourceMappingURL=multiplatformOne.d.ts.map

package/types/bin/multiplatformOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplatformOne.d.ts","sourceRoot":"","sources":["../../src/bin/multiplatformOne.ts"],"names":[],"mappings":"AA2FA,gHAAgH;AAChH,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC"}

package/types/commands/e2e.d.ts

@@ -0,0 +1,14 @@
+export interface E2EOptions {
+    upOnly?: boolean;
+    down?: boolean;
+    portOffset?: number;
+    project?: string;
+    noBuild?: boolean;
+    filter?: string;
+}
+/** Discover app that has Playwright config (for E2E test cwd). Returns app name (e.g. "one") or null. */
+export declare function discoverE2EApp(projectRoot: string): Promise<string | null>;
+export declare function detectServices(projectRoot: string): Promise<string[]>;
+export declare function generateCompose(services: string[], portOffset: number, projectRoot: string): string;
+export declare function runE2ESession(projectRoot: string, options: E2EOptions): Promise<void>;
+//# sourceMappingURL=e2e.d.ts.map

package/types/commands/e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.d.ts","sourceRoot":"","sources":["../../src/commands/e2e.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmDD,yGAAyG;AACzG,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBhF;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB3E;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAsBR;AAiHD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiH3F"}

package/types/commands/init.d.ts

@@ -0,0 +1,16 @@
+interface InitOptions {
+    name?: string;
+    services?: string;
+    apps?: string;
+    checkout?: string;
+    /** Path to clone.sh script (from CLI); if set, clone via script instead of execSync */
+    cloneScript?: string;
+}
+/**
+ * Shared modify step: remove unselected apps/services and rewrite configs.
+ * Used by both init (with prompted selections) and update (with getPresentApps/getPresentServices).
+ */
+export declare function runModifyStep(dir: string, selectedServices: string[], selectedApps: string[]): void;
+export declare function init(nameArg: string | undefined, options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/types/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAsEA,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EAAE,EAC1B,YAAY,EAAE,MAAM,EAAE,GACrB,IAAI,CAuDN;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,iBAqI3E"}

package/types/commands/initApp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Consumer project templates:
+ *   - "universal": one-based app serving web + iOS + Android from one codebase
+ *     (apps/<name> + features/<name> + packages/{config,i18n,themes})
+ *   - "app": web-only Vite + React shell
+ *     (apps/<name> + features/<name> + packages/config)
+ */
+export type InitAppTemplate = "universal" | "app";
+export interface InitAppOptions {
+    /** Skip pnpm install (useful for CI / dry scaffolding). */
+    skipInstall?: boolean;
+    /** Pin @multiplatform.one/* to this semver range. Default: ^<cli version>. */
+    version?: string;
+    /** Project template. When omitted: prompt (interactive) or "universal". */
+    template?: InitAppTemplate;
+    /** Accept defaults instead of prompting (non-interactive / CI). */
+    yes?: boolean;
+}
+export declare function cliVersion(): string | undefined;
+/**
+ * Scaffold provenance (the copier-answers equivalent): which template, which
+ * CLI version and which vars produced this project. `mpo update` regenerates
+ * the ORIGINAL scaffold from this record to use as the merge base for a
+ * three-way template update.
+ */
+export interface MpoProvenance {
+    template: InitAppTemplate;
+    cliVersion: string;
+    name: string;
+    mpoVersion: string;
+}
+export declare const PROVENANCE_FILE = ".mpo.json";
+export declare function writeProvenance(targetDir: string, provenance: MpoProvenance): void;
+export declare function readProvenance(projectDir: string): MpoProvenance | undefined;
+/**
+ * Scaffold a consumer project (universal by default, web-only with
+ * template: "app") that depends on @multiplatform.one/* at semver ranges
+ * (never workspace:*). This is NOT a monorepo fork.
+ */
+export declare function initApp(nameArg: string | undefined, options?: InitAppOptions): Promise<void>;
+//# sourceMappingURL=initApp.d.ts.map

package/types/commands/initApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initApp.d.ts","sourceRoot":"","sources":["../../src/commands/initApp.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,mEAAmE;IACnE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AA0CD,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAQ/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAElF;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAe5E;AAuED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

package/types/commands/updateApp.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `mpo update` for scaffolded consumer projects — the modern successor of
+ * the old cookiecutter flow (init a fresh project, swap your .git in, merge
+ * your changes on top), rebuilt with a TRUE three-way merge:
+ *
+ *   base  = the ORIGINAL scaffold, regenerated from the CLI version recorded
+ *           in .mpo.json at init time (published CLIs ship their templates,
+ *           so `pnpm dlx @multiplatform.one/cli@<old> init` reproduces it)
+ *   ours  = the project's HEAD (all your custom changes)
+ *   theirs= a fresh scaffold from the CURRENT CLI version
+ *
+ * `git merge-tree --write-tree --merge-base=<base>` merges template
+ * evolution with your customizations; conflicts land in the worktree with
+ * normal conflict markers. An `.updateignore` file (one pathspec per line)
+ * pins matching paths to your HEAD version, exactly like the old script.
+ */
+export interface UpdateAppOptions {
+    /** Skip pnpm install after the merge. */
+    skipInstall?: boolean;
+    /** Override the semver range written for @multiplatform.one/* deps. */
+    version?: string;
+}
+export declare function updateApp(options?: UpdateAppOptions): Promise<void>;
+//# sourceMappingURL=updateApp.d.ts.map

package/types/commands/updateApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateApp.d.ts","sourceRoot":"","sources":["../../src/commands/updateApp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2FD,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6J7E"}

package/types/generateVscode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generate .vscode/launch.json and .vscode/tasks.json from discovered apps.
+ * Invoked by `mpo update` after merging upstream.
+ * Safe for subset projects: only includes configs for workspaces that exist.
+ */
+export declare function generateVscodeConfig(root: string): Promise<void>;
+//# sourceMappingURL=generateVscode.d.ts.map

package/types/generateVscode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateVscode.d.ts","sourceRoot":"","sources":["../src/generateVscode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwNH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtE"}

package/types/index.d.ts

@@ -0,0 +1,2 @@
+export type {};
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,CAAC"}

package/types/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI type definitions placeholder.
+ * Add CLI-specific types here as needed.
+ */
+export {};
+//# sourceMappingURL=types.d.ts.map

package/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC"}