flowboard-react 0.6.5 → 0.6.6

package/README.md

@@ -30,6 +30,8 @@ npx --package flowboard-react flowboard-setup --dry-run
 
 `flowboard-react` keeps heavy native modules as peer dependencies to avoid duplicate binaries and version conflicts in host apps. The setup command installs the required peer set for you.
 
+By default, `flowboard-setup` installs only missing peers. If your app already declares one of these native packages, the setup command leaves it untouched so it does not force a downgrade. Use `--upgrade` to install Flowboard's validated package matrix explicitly.
+
 ## Expo Support
 
 Expo Go is not supported. This SDK depends on custom native modules, so Expo users need a development build, `expo prebuild`, or EAS Build.

package/bin/setup.js

@@ -64,6 +64,14 @@ function compareSemver(left, right) {
   return left.patch - right.patch;
 }
 
+function incrementPatch(version) {
+  return {
+    major: version.major,
+    minor: version.minor,
+    patch: version.patch + 1,
+  };
+}
+
 function rangeAcceptsVersion(spec, version) {
   const normalized = String(spec || '').trim();
   if (!normalized) return false;
@@ -118,6 +126,74 @@ function rangeAcceptsVersion(spec, version) {
   }
 }
 
+function extractLowerBound(spec) {
+  const normalized = String(spec || '').trim();
+  if (
+    !normalized ||
+    normalized === '*' ||
+    normalized === 'latest' ||
+    normalized.startsWith('workspace:')
+  ) {
+    return null;
+  }
+
+  if (normalized.includes('||')) {
+    const bounds = normalized
+      .split('||')
+      .map((part) => extractLowerBound(part.trim()))
+      .filter(Boolean);
+
+    if (bounds.length === 0) return null;
+
+    return bounds.reduce((lowest, candidate) =>
+      compareSemver(candidate, lowest) < 0 ? candidate : lowest
+    );
+  }
+
+  const comparators = normalized.split(/\s+/).filter(Boolean);
+  if (comparators.length > 1) {
+    const lowerBounds = comparators
+      .map((part) => extractLowerBound(part))
+      .filter(Boolean);
+
+    if (lowerBounds.length === 0) return null;
+
+    return lowerBounds.reduce((highest, candidate) =>
+      compareSemver(candidate, highest) > 0 ? candidate : highest
+    );
+  }
+
+  const operatorMatch = normalized.match(/^(>=|<=|>|<|\^|~)/);
+  const operator = operatorMatch ? operatorMatch[1] : '';
+  const base = parseSemver(normalized.slice(operator.length));
+  if (!base) {
+    return parseSemver(normalized);
+  }
+
+  switch (operator) {
+    case '>':
+      return incrementPatch(base);
+    case '>=':
+    case '^':
+    case '~':
+    case '':
+      return base;
+    default:
+      return null;
+  }
+}
+
+function specMeetsValidatedFloor(spec, version) {
+  if (!spec) return false;
+  if (rangeAcceptsVersion(spec, version)) return true;
+
+  const lowerBound = extractLowerBound(spec);
+  const validated = parseSemver(version);
+
+  if (!lowerBound || !validated) return false;
+  return compareSemver(lowerBound, validated) >= 0;
+}
+
 function getManifest(root) {
   const manifestPath = path.join(root, 'package.json');
   if (!fs.existsSync(manifestPath)) {
@@ -170,13 +246,33 @@ function hasReactNative(manifest) {
 }
 
 function selectPackages(manifest, options) {
-  return BASE_PACKAGES.filter(([packageName, version]) => {
+  return BASE_PACKAGES.filter(([packageName]) => {
     if (options.upgrade) return true;
     const existingSpec = getPackageSpec(manifest, packageName);
-    return !rangeAcceptsVersion(existingSpec, version);
+
+    // Never replace an existing host-app dependency unless the user opts into
+    // the validated matrix with --upgrade.
+    if (existingSpec) return false;
+
+    return true;
   }).map(([name, version]) => ({ name, version }));
 }
 
+function collectCompatibilityWarnings(manifest, options) {
+  if (options.upgrade) return [];
+
+  return BASE_PACKAGES.reduce((warnings, [packageName, version]) => {
+    const existingSpec = getPackageSpec(manifest, packageName);
+    if (!existingSpec) return warnings;
+    if (specMeetsValidatedFloor(existingSpec, version)) return warnings;
+
+    warnings.push(
+      `${packageName}@${existingSpec} is already declared in the host app and may be below Flowboard's validated floor (${version}). flowboard-setup will leave it untouched to avoid forcing a downgrade. Use --upgrade to install the validated version explicitly.`
+    );
+    return warnings;
+  }, []);
+}
+
 function selectExpoExtras(manifest, options) {
   return EXPO_EXTRA_PACKAGES.filter((packageName) => {
     if (options.upgrade) return true;
@@ -222,7 +318,7 @@ function buildInstallCommands({ expo, packageManager, packages, expoExtras }) {
   commands.push({
     args: installArgsByManager[packageManager] || installArgsByManager.npm,
     command: commandName(packageManager),
-    title: 'Install validated React Native peer versions',
+    title: 'Install missing React Native peer dependencies',
   });
 
   return commands;
@@ -303,7 +399,14 @@ function printNextSteps({ expo, projectRoot }) {
   );
 }
 
-function printPlan({ expo, packageManager, packages, expoExtras, commands }) {
+function printPlan({
+  expo,
+  packageManager,
+  packages,
+  expoExtras,
+  commands,
+  warnings,
+}) {
   console.log(
     `[flowboard-setup] Target: ${
       expo ? 'Expo development build' : `React Native CLI (${packageManager})`
@@ -311,14 +414,23 @@ function printPlan({ expo, packageManager, packages, expoExtras, commands }) {
   );
 
   if (packages.length > 0) {
-    console.log('[flowboard-setup] Packages to install:');
+    console.log('[flowboard-setup] Packages to install (missing):');
     packages.forEach((entry) => {
       console.log(`  - ${entry.name}${expo ? '' : `@${entry.version}`}`);
     });
   } else {
     console.log(
-      '[flowboard-setup] Base Flowboard peer dependencies already look compatible.'
+      '[flowboard-setup] All required peer dependencies are already present in your package.json.'
+    );
+  }
+
+  if (warnings.length > 0) {
+    console.log(
+      '[flowboard-setup] Compatibility warnings for existing host-app packages:'
     );
+    warnings.forEach((warning) => {
+      console.log(`  - ${warning}`);
+    });
   }
 
   if (expoExtras.length > 0) {
@@ -329,7 +441,7 @@ function printPlan({ expo, packageManager, packages, expoExtras, commands }) {
   }
 
   if (commands.length > 0) {
-    console.log('[flowboard-setup] Commands:');
+    console.log('[flowboard-setup] Commands to be executed:');
     commands.forEach((command) => {
       console.log(`  - ${formatCommand(command)}`);
     });
@@ -363,6 +475,7 @@ async function main(rawArgs = process.argv.slice(2)) {
   const expo = isExpoProject(manifest);
   const packageManager = detectPackageManager(projectRoot, manifest);
   const packages = selectPackages(manifest, options);
+  const warnings = collectCompatibilityWarnings(manifest, options);
   const expoExtras = expo ? selectExpoExtras(manifest, options) : [];
   const commands = buildInstallCommands({
     expo,
@@ -371,7 +484,14 @@ async function main(rawArgs = process.argv.slice(2)) {
     packages,
   });
 
-  printPlan({ commands, expo, expoExtras, packageManager, packages });
+  printPlan({
+    commands,
+    expo,
+    expoExtras,
+    packageManager,
+    packages,
+    warnings,
+  });
 
   if (commands.length === 0) {
     printNextSteps({ expo, projectRoot });
@@ -415,9 +535,12 @@ module.exports = {
   main,
   parseArgs,
   parseSemver,
+  collectCompatibilityWarnings,
+  extractLowerBound,
   rangeAcceptsVersion,
   selectExpoExtras,
   selectPackages,
+  specMeetsValidatedFloor,
 };
 
 if (require.main === module) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowboard-react",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Onboard your users with one click",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",