@warp-drive-mirror/build-config 5.8.0-alpha.0 → 5.8.0-alpha.11

package/CHANGELOG.md

@@ -4,21 +4,21 @@
 
 #### :evergreen_tree: New Deprecation
 
-* [#9479](https://github.com/emberjs/data/pull/9479) feat: support migration path for ember-inflector usage ([@runspired](https://github.com/runspired))
+* [#9479](https://github.com/warp-drive-data/warp-drive/pull/9479) feat: support migration path for ember-inflector usage ([@runspired](https://github.com/runspired))
 
 #### :rocket: Enhancement
 
-* [#9471](https://github.com/emberjs/data/pull/9471) feat: npx warp-drive ([@runspired](https://github.com/runspired))
-* [#9448](https://github.com/emberjs/data/pull/9448) feat: impl SchemaService RFC ([@runspired](https://github.com/runspired))
+* [#9471](https://github.com/warp-drive-data/warp-drive/pull/9471) feat: npx warp-drive ([@runspired](https://github.com/runspired))
+* [#9448](https://github.com/warp-drive-data/warp-drive/pull/9448) feat: impl SchemaService RFC ([@runspired](https://github.com/runspired))
 
 #### :bug: Bug Fix
 
-* [#9455](https://github.com/emberjs/data/pull/9455) fix: config version lookup needs to be project location aware ([@runspired](https://github.com/runspired))
+* [#9455](https://github.com/warp-drive-data/warp-drive/pull/9455) fix: config version lookup needs to be project location aware ([@runspired](https://github.com/runspired))
 
 #### :house: Internal
 
-* [#9477](https://github.com/emberjs/data/pull/9477) fix: add deprecation and avoid breaking configs ([@runspired](https://github.com/runspired))
-* [#9292](https://github.com/emberjs/data/pull/9292) feat: add new build-config package ([@runspired](https://github.com/runspired))
+* [#9477](https://github.com/warp-drive-data/warp-drive/pull/9477) fix: add deprecation and avoid breaking configs ([@runspired](https://github.com/runspired))
+* [#9292](https://github.com/warp-drive-data/warp-drive/pull/9292) feat: add new build-config package ([@runspired](https://github.com/runspired))
 
 #### Committers: (1)
 

package/README.md

@@ -1,15 +1,15 @@
 <p align="center">
   <img
     class="project-logo"
-    src="./logos/NCC-1701-a-blue.svg#gh-light-mode-only"
+    src="./logos/warp-drive-logo-dark.svg#gh-light-mode-only"
     alt="WarpDrive"
-    width="120px"
+    width="200px"
     title="WarpDrive" />
   <img
     class="project-logo"
-    src="./logos/NCC-1701-a.svg#gh-dark-mode-only"
+    src="./logos/warp-drive-logo-gold.svg#gh-dark-mode-only"
     alt="WarpDrive"
-    width="120px"
+    width="200px"
     title="WarpDrive" />
 </p>
 
@@ -51,7 +51,7 @@ module.exports = async function (defaults) {
   const app = new EmberApp(defaults, {});
 
   setConfig(app, __dirname, {
-    // WarpDrive/EmberData settings go here (if any)
+    // WarpDrive settings go here (if any)
   });
 
   return app.toTree();
@@ -68,7 +68,7 @@ module.exports = async function (defaults) {
     img.project-logo {
        padding: 0 5em 1em 5em;
        width: 100px;
-       border-bottom: 2px solid #0969da;
+       border-bottom: 2px solid #bbb;
        margin: 0 auto;
        display: block;
      }
@@ -84,7 +84,7 @@ module.exports = async function (defaults) {
       display: inline-block;
       padding: .2rem 0;
       color: #000;
-      border-bottom: 3px solid #0969da;
+      border-bottom: 3px solid #bbb;
     }
 
     details > details {

package/declarations/canary-features.d.ts

@@ -100,7 +100,7 @@
 * }
 * ```
 *
-* For more complex projects and migrations, configure [@warp-drive-mirror/build-config/babel-macros](./babel-macros)
+* For more complex projects and migrations, configure {@link @warp-drive-mirror/core!build-config/babel-macros |  @warp-drive-mirror/core/build-config/babel-macros}
 *
 * The current list of features used at build time for canary releases is defined below.
 *

package/declarations/deprecations.d.ts

@@ -450,7 +450,7 @@ export declare const ENABLE_LEGACY_SCHEMA_SERVICE: boolean;
 *
 * This deprecation can be resolved by removing usage of ember-inflector or by using
 * both ember-inflector and @ember-data-mirror/request-utils in parallel and updating your
-* EmberData/WarpDrive build config to mark the deprecation as resolved
+* WarpDrive build config to mark the deprecation as resolved
 * in ember-cli-build
 *
 * ```js

package/declarations/index.d.ts

@@ -1,7 +1,26 @@
 import { getDeprecations } from "./-private/utils/deprecations.js";
 import { getFeatures } from "./-private/utils/features.js";
 import * as LOGGING from "./debugging.js";
-export type WarpDriveConfig = {
+import type { PluginItem } from "@babel/core";
+/**
+* Create the Babel plugin for WarpDrive
+*
+* Note: If your project already uses [@embroider/macros](https://www.npmjs.com/package/@embroider/macros)
+* then you should use {@link setConfig} instead of this function.
+*
+* @param options WarpDrive configuration options
+* @returns An array of Babel plugins
+*/
+export declare function babelPlugin(options: WarpDriveConfig): {
+	gts: Function[];
+	js: PluginItem[];
+};
+/**
+* Build Configuration options for WarpDrive that
+* allow adjusting logging, deprecations, canary features
+* and optional features.
+*/
+export interface WarpDriveConfig {
 	/**
 	* An object of key/value pairs of logging flags
 	*
@@ -44,6 +63,13 @@ export type WarpDriveConfig = {
 	* `5.3` will remove all the support for the deprecated
 	* features for associated deprecations.
 	*
+	* :::caution **Universal Apps**
+	* This value should be at least `5.6` for universal/non-ember
+	* applications as that was the first version that builds
+	* without any ember-source dependencies provided all deprecations
+	* are resolved.
+	* :::
+	*
 	* See {@link DEPRECATIONS | deprecations} for more details.
 	*/
 	compatWith?: `${number}.${number}`;
@@ -81,8 +107,8 @@ export type WarpDriveConfig = {
 	* @private
 	*/
 	forceMode?: "testing" | "production" | "development";
-};
-type InternalWarpDriveConfig = {
+}
+interface InternalWarpDriveConfig {
 	debug: typeof LOGGING;
 	polyfillUUID: boolean;
 	includeDataAdapter: boolean;
@@ -95,7 +121,57 @@ type InternalWarpDriveConfig = {
 		PRODUCTION: boolean;
 		DEBUG: boolean;
 	};
-};
+}
+/**
+* Sets the build configuration for WarpDrive that ensures
+* environment specific behaviors are activated/deactivated
+* and enables adjusting log instrumentation, removing code
+* that supports deprecated features, enabling canary features
+* and enabling/disabling optional features.
+*
+* The library uses [@embroider/macros](https://www.npmjs.com/package/@embroider/macros)
+* to perform this final configuration code transform.
+*
+* This is a low level API for configuring WarpDrive. If your
+* project does not use `@embroider/macros` then you should use
+* {@link babelPlugin} instead of this function.
+*
+* ### Example
+*
+* ```ts
+* import { setConfig } from '@warp-drive-mirror/core/build-config';
+* import { buildMacros } from '@embroider/macros/babel';
+*
+* const Macros = buildMacros({
+*   configure: (config) => {
+*     setConfig(config, {
+*       compatWith: '5.6'
+*     });
+*   },
+* });
+*
+* export default {
+*   plugins: [
+*     // babel-plugin-debug-macros is temporarily needed
+*     // to convert deprecation/warn calls into console.warn
+*     [
+*       'babel-plugin-debug-macros',
+*       {
+*         flags: [],
+*
+*         debugTools: {
+*           isDebug: true,
+*           source: '@ember/debug',
+*           assertPredicateIndex: 1,
+*         },
+*       },
+*       'ember-data-mirror-specific-macros-stripping-test',
+*     ],
+*     ...Macros.babelMacros,
+*   ],
+* };
+* ```
+*/
 export declare function setConfig(macros: object, config: WarpDriveConfig): void;
 export declare function setConfig(context: object, appRoot: string, config: WarpDriveConfig): void;
 export {};

package/dist/babel-macros.js

@@ -1,6 +1,6 @@
 import { L as LOGGING } from './debugging-DgRWKeE4.js';
-import { C as CURRENT_FEATURES } from './canary-features-BM0to_ys.js';
-import { C as CURRENT_DEPRECATIONS } from './deprecations-DitCVLCo.js';
+import { C as CURRENT_FEATURES } from './canary-features-BUBNGiZ-.js';
+import { C as CURRENT_DEPRECATIONS } from './deprecations-3a6psrPz.js';
 
 /**
  * Babel plugins that convert constants and expressions into [macroConditions](https://www.npmjs.com/package/@embroider/macros#the-macros)

package/dist/{canary-features-BM0to_ys.js → canary-features-BUBNGiZ-.js}

@@ -100,7 +100,7 @@
  * }
  * ```
  *
- * For more complex projects and migrations, configure [@warp-drive-mirror/build-config/babel-macros](./babel-macros)
+ * For more complex projects and migrations, configure {@link @warp-drive-mirror/core!build-config/babel-macros |  @warp-drive-mirror/core/build-config/babel-macros}
  *
  * The current list of features used at build time for canary releases is defined below.
  *

package/dist/canary-features.js

@@ -1 +1 @@
-export { E as ENFORCE_STRICT_RESOURCE_FINALIZATION, J as JSON_API_CACHE_VALIDATION_ERRORS, S as SAMPLE_FEATURE_FLAG } from './canary-features-BM0to_ys.js';
+export { E as ENFORCE_STRICT_RESOURCE_FINALIZATION, J as JSON_API_CACHE_VALIDATION_ERRORS, S as SAMPLE_FEATURE_FLAG } from './canary-features-BUBNGiZ-.js';

package/dist/cjs-set-config.cjs

@@ -7,6 +7,7 @@ const semver = require('semver');
 const fs = require('fs');
 const path = require('path');
 const url = require('url');
+require('@embroider/macros/src/babel.js');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function getEnv(forceMode) {
@@ -229,7 +230,7 @@ function getDeprecations(compatVersion, deprecations) {
  * }
  * ```
  *
- * For more complex projects and migrations, configure [@warp-drive-mirror/build-config/babel-macros](./babel-macros)
+ * For more complex projects and migrations, configure {@link @warp-drive-mirror/core!build-config/babel-macros |  @warp-drive-mirror/core/build-config/babel-macros}
  *
  * The current list of features used at build time for canary releases is defined below.
  *
@@ -593,17 +594,75 @@ function createLoggingConfig(env, debug) {
  * - {@link WarpDriveConfig.includeDataAdapterInProduction | includeDataAdapterInProduction}
  * - {@link WarpDriveConfig.compatWith | compatWith}
  *
- *
- *
  * @module
  */
+
 const _MacrosConfig = EmbroiderMacros.MacrosConfig;
+
+/**
+ * Build Configuration options for WarpDrive that
+ * allow adjusting logging, deprecations, canary features
+ * and optional features.
+ */
+
 function recastMacrosConfig(macros) {
   if (!('globalConfig' in macros)) {
     throw new Error('Expected MacrosConfig to have a globalConfig property');
   }
   return macros;
 }
+
+/**
+ * Sets the build configuration for WarpDrive that ensures
+ * environment specific behaviors are activated/deactivated
+ * and enables adjusting log instrumentation, removing code
+ * that supports deprecated features, enabling canary features
+ * and enabling/disabling optional features.
+ *
+ * The library uses [@embroider/macros](https://www.npmjs.com/package/@embroider/macros)
+ * to perform this final configuration code transform.
+ *
+ * This is a low level API for configuring WarpDrive. If your
+ * project does not use `@embroider/macros` then you should use
+ * {@link babelPlugin} instead of this function.
+ *
+ * ### Example
+ *
+ * ```ts
+ * import { setConfig } from '@warp-drive-mirror/core/build-config';
+ * import { buildMacros } from '@embroider/macros/babel';
+ *
+ * const Macros = buildMacros({
+ *   configure: (config) => {
+ *     setConfig(config, {
+ *       compatWith: '5.6'
+ *     });
+ *   },
+ * });
+ *
+ * export default {
+ *   plugins: [
+ *     // babel-plugin-debug-macros is temporarily needed
+ *     // to convert deprecation/warn calls into console.warn
+ *     [
+ *       'babel-plugin-debug-macros',
+ *       {
+ *         flags: [],
+ *
+ *         debugTools: {
+ *           isDebug: true,
+ *           source: '@ember/debug',
+ *           assertPredicateIndex: 1,
+ *         },
+ *       },
+ *       'ember-data-mirror-specific-macros-stripping-test',
+ *     ],
+ *     ...Macros.babelMacros,
+ *   ],
+ * };
+ * ```
+ */
+
 function setConfig(context, appRootOrConfig, config) {
   const isEmberClassicUsage = arguments.length === 3;
   const macros = recastMacrosConfig(isEmberClassicUsage ? _MacrosConfig.for(context, appRootOrConfig) : context);

package/dist/{deprecations-DitCVLCo.js → deprecations-3a6psrPz.js}

@@ -461,7 +461,7 @@ const ENABLE_LEGACY_SCHEMA_SERVICE = true;
  *
  * This deprecation can be resolved by removing usage of ember-inflector or by using
  * both ember-inflector and @ember-data-mirror/request-utils in parallel and updating your
- * EmberData/WarpDrive build config to mark the deprecation as resolved
+ * WarpDrive build config to mark the deprecation as resolved
  * in ember-cli-build
  *
  * ```js

package/dist/deprecations.js

@@ -1 +1 @@
-export { D as DEPRECATE_CATCH_ALL, a as DEPRECATE_COMPUTED_CHAINS, i as DEPRECATE_EMBER_INFLECTOR, d as DEPRECATE_LEGACY_IMPORTS, g as DEPRECATE_MANY_ARRAY_DUPLICATES, c as DEPRECATE_NON_STRICT_ID, b as DEPRECATE_NON_STRICT_TYPES, e as DEPRECATE_NON_UNIQUE_PAYLOADS, f as DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE, h as DEPRECATE_STORE_EXTENDS_EMBER_OBJECT, j as DEPRECATE_TRACKING_PACKAGE, l as DISABLE_7X_DEPRECATIONS, k as ENABLE_LEGACY_REQUEST_METHODS, E as ENABLE_LEGACY_SCHEMA_SERVICE } from './deprecations-DitCVLCo.js';
+export { D as DEPRECATE_CATCH_ALL, a as DEPRECATE_COMPUTED_CHAINS, i as DEPRECATE_EMBER_INFLECTOR, d as DEPRECATE_LEGACY_IMPORTS, g as DEPRECATE_MANY_ARRAY_DUPLICATES, c as DEPRECATE_NON_STRICT_ID, b as DEPRECATE_NON_STRICT_TYPES, e as DEPRECATE_NON_UNIQUE_PAYLOADS, f as DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE, h as DEPRECATE_STORE_EXTENDS_EMBER_OBJECT, j as DEPRECATE_TRACKING_PACKAGE, l as DISABLE_7X_DEPRECATIONS, k as ENABLE_LEGACY_REQUEST_METHODS, E as ENABLE_LEGACY_SCHEMA_SERVICE } from './deprecations-3a6psrPz.js';

package/dist/index.js

@@ -3,8 +3,9 @@ import semver from 'semver';
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { C as CURRENT_FEATURES } from './canary-features-BM0to_ys.js';
+import { C as CURRENT_FEATURES } from './canary-features-BUBNGiZ-.js';
 import { L as LOGGING } from './debugging-DgRWKeE4.js';
+import { buildMacros } from '@embroider/macros/src/babel.js';
 
 function getEnv(forceMode) {
   const FORCE_TESTING = forceMode === 'testing' || forceMode === 'development' || forceMode === 'debug';
@@ -229,17 +230,115 @@ function createLoggingConfig(env, debug) {
  * - {@link WarpDriveConfig.includeDataAdapterInProduction | includeDataAdapterInProduction}
  * - {@link WarpDriveConfig.compatWith | compatWith}
  *
+ * @module
+ */
+
+
+/**
+ * Create the Babel plugin for WarpDrive
  *
+ * Note: If your project already uses [@embroider/macros](https://www.npmjs.com/package/@embroider/macros)
+ * then you should use {@link setConfig} instead of this function.
  *
- * @module
+ * @param options WarpDrive configuration options
+ * @returns An array of Babel plugins
  */
+function babelPlugin(options) {
+  const macros = buildMacros({
+    configure: config => {
+      setConfig(config, options);
+    }
+  });
+  const env = getEnv(options.forceMode);
+  return {
+    gts: macros.templateMacros,
+    js: [
+    // babel-plugin-debug-macros is temporarily needed
+    // to convert deprecation/warn calls into console.warn
+    [resolve('babel-plugin-debug-macros'), {
+      flags: [],
+      debugTools: {
+        isDebug: env.DEBUG,
+        source: '@ember/debug',
+        assertPredicateIndex: 1
+      }
+    }, 'ember-data-mirror-specific-macros-stripping-test'], ...macros.babelMacros]
+  };
+}
+function resolve(module) {
+  const filePath = import.meta.resolve(module);
+  const file = filePath.replace('/node_modules/.vite-temp/', '/');
+  if (file.startsWith('file://')) {
+    return file.slice(7);
+  }
+  return file;
+}
 const _MacrosConfig = EmbroiderMacros.MacrosConfig;
+
+/**
+ * Build Configuration options for WarpDrive that
+ * allow adjusting logging, deprecations, canary features
+ * and optional features.
+ */
+
 function recastMacrosConfig(macros) {
   if (!('globalConfig' in macros)) {
     throw new Error('Expected MacrosConfig to have a globalConfig property');
   }
   return macros;
 }
+
+/**
+ * Sets the build configuration for WarpDrive that ensures
+ * environment specific behaviors are activated/deactivated
+ * and enables adjusting log instrumentation, removing code
+ * that supports deprecated features, enabling canary features
+ * and enabling/disabling optional features.
+ *
+ * The library uses [@embroider/macros](https://www.npmjs.com/package/@embroider/macros)
+ * to perform this final configuration code transform.
+ *
+ * This is a low level API for configuring WarpDrive. If your
+ * project does not use `@embroider/macros` then you should use
+ * {@link babelPlugin} instead of this function.
+ *
+ * ### Example
+ *
+ * ```ts
+ * import { setConfig } from '@warp-drive-mirror/core/build-config';
+ * import { buildMacros } from '@embroider/macros/babel';
+ *
+ * const Macros = buildMacros({
+ *   configure: (config) => {
+ *     setConfig(config, {
+ *       compatWith: '5.6'
+ *     });
+ *   },
+ * });
+ *
+ * export default {
+ *   plugins: [
+ *     // babel-plugin-debug-macros is temporarily needed
+ *     // to convert deprecation/warn calls into console.warn
+ *     [
+ *       'babel-plugin-debug-macros',
+ *       {
+ *         flags: [],
+ *
+ *         debugTools: {
+ *           isDebug: true,
+ *           source: '@ember/debug',
+ *           assertPredicateIndex: 1,
+ *         },
+ *       },
+ *       'ember-data-mirror-specific-macros-stripping-test',
+ *     ],
+ *     ...Macros.babelMacros,
+ *   ],
+ * };
+ * ```
+ */
+
 function setConfig(context, appRootOrConfig, config) {
   const isEmberClassicUsage = arguments.length === 3;
   const macros = recastMacrosConfig(isEmberClassicUsage ? _MacrosConfig.for(context, appRootOrConfig) : context);
@@ -284,4 +383,4 @@ function setConfig(context, appRootOrConfig, config) {
   macros.setGlobalConfig(import.meta.filename, 'WarpDriveMirror', finalizedConfig);
 }
 
-export { setConfig };
+export { babelPlugin, setConfig };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@warp-drive-mirror/build-config",
-  "version": "5.8.0-alpha.0",
-  "description": "Provides Build Configuration for projects using WarpDrive or EmberData",
+  "version": "5.8.0-alpha.11",
+  "description": "Provides Build Configuration for projects using WarpDrive",
   "keywords": [
     "ember-data-mirror",
     "warp-drive"
   ],
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com:emberjs/data.git",
+    "url": "git+ssh://git@github.com:warp-drive-data/warp-drive.git",
     "directory": "warp-drive-packages/build-config"
   },
   "license": "MIT",
@@ -36,13 +36,14 @@
     }
   },
   "dependencies": {
+    "babel-plugin-debug-macros": "^2.0.0",
     "@embroider/macros": "^1.18.1",
     "@embroider/addon-shim": "^1.10.0",
     "babel-import-util": "^2.1.1",
     "semver": "^7.7.2"
   },
   "devDependencies": {
-    "@warp-drive/internal-config": "5.8.0-alpha.0",
+    "@warp-drive/internal-config": "5.8.0-alpha.11",
     "@types/babel__core": "^7.20.5",
     "@types/node": "^20.19.11",
     "@babel/plugin-transform-typescript": "^7.28.0",