@octaviaflow/feature-flags 1.0.0

package/README.md

@@ -0,0 +1,116 @@
+# @octaviaflow/feature-flags
+
+> Build with feature flags in Carbon
+
+## Getting started
+
+To install `@octaviaflow/feature-flags` in your project, you will need to run the
+following command using [npm](https://www.npmjs.com/):
+
+```bash
+npm install -S @octaviaflow/feature-flags
+```
+
+If you prefer [Yarn](https://yarnpkg.com/en/), use the following command
+instead:
+
+```bash
+yarn add @octaviaflow/feature-flags
+```
+
+## Usage
+
+The `@octaviaflow/feature-flags` provides a runtime-based feature flag system that
+you can use to enable or disable experimental features from Carbon or in your
+own code.
+
+To check if a feature flag is enabled, you can use the `enabled` function in
+JavaScript:
+
+```js
+import { enabled } from '@octaviaflow/feature-flags';
+
+enabled('feature-flag-name');
+```
+
+In Sass, you would use the `enabled` function or mixin:
+
+```scss
+@use '@octaviaflow/feature-flags';
+
+// Return true if the flag is enabled
+@if feature-flags.enabled('feature-flag-name') {
+  //
+}
+
+@include enabled('feature-flag-name') {
+  // only include contents if the flag is enabled
+}
+```
+
+### Managing feature flags
+
+You can change whether a feature flag is enabled. In JavaScript, you can use the
+`enable`, `disable`, and `merge` functions to accomplish this.
+
+```js
+import { enable, disable, merge } from '@octaviaflow/feature-flags';
+
+// Enable `feature-flag-a`
+enable('feature-flag-a');
+
+// Disable `feature-flag-a`
+disable('feature-flag-a');
+
+// Set a variety of feature flags to a specific value
+merge({
+  'feature-flag-a': true,
+  'feature-flag-b': false,
+  'feature-flag-c': true,
+});
+```
+
+In Sass, you can configure whether a feature flag is enabled when you include
+the module or by using `enable`, `disable`, and `merge`.
+
+```scss
+@use '@octaviaflow/feature-flags' with (
+  $feature-flags: (
+    'feature-flag-a': false,
+    'feature-flag-b': true,
+  )
+);
+
+// Enable `feature-flag-a`
+@include feature-flags.enable('feature-flag-a');
+
+// Disable `feature-flag-b`
+@include feature-flags.disable('feature-flag-b');
+
+// Set a variety of feature flags to a specific value
+@include feature-flags.merge(
+  (
+    'feature-flag-a': true,
+    'feature-flag-b': true,
+  )
+);
+```
+
+## 🙌 Contributing
+
+We're always looking for contributors to help us fix bugs, build new features,
+or help us improve the project documentation. If you're interested, definitely
+check out our [Contributing Guide](/.github/CONTRIBUTING.md)! 👀
+
+## 📝 License
+
+Licensed under the [Apache 2.0 License](/LICENSE).
+
+## <picture><source height="20" width="20" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-dark.svg"><source height="20" width="20" media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-light.svg"><img height="20" width="20" alt="IBM Telemetry" src="https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-light.svg"></picture> IBM Telemetry
+
+This package uses IBM Telemetry to collect de-identified and anonymized metrics
+data. By installing this package as a dependency you are agreeing to telemetry
+collection. To opt out, see
+[Opting out of IBM Telemetry data collection](https://github.com/ibm-telemetry/telemetry-js/tree/main#opting-out-of-ibm-telemetry-data-collection).
+For more information on the data being collected, please see the
+[IBM Telemetry documentation](https://github.com/ibm-telemetry/telemetry-js/tree/main#ibm-telemetry-collection-basics).

package/es/index.js

@@ -0,0 +1,432 @@
+
+
+var enabled$1 = {};
+try {
+  if (process.env.CARBON_ENABLE_CSS_CUSTOM_PROPERTIES) {
+    if (process.env.CARBON_ENABLE_CSS_CUSTOM_PROPERTIES === 'true') {
+      enabled$1.enableCssCustomProperties = true;
+    } else {
+      enabled$1.enableCssCustomProperties = false;
+    }
+  } else {
+    enabled$1.enableCssCustomProperties = false;
+  }
+  if (process.env.CARBON_ENABLE_CSS_GRID) {
+    if (process.env.CARBON_ENABLE_CSS_GRID === 'true') {
+      enabled$1.enableCssGrid = true;
+    } else {
+      enabled$1.enableCssGrid = false;
+    }
+  } else {
+    enabled$1.enableCssGrid = false;
+  }
+  if (process.env.CARBON_ENABLE_V11_RELEASE) {
+    if (process.env.CARBON_ENABLE_V11_RELEASE === 'true') {
+      enabled$1.enableV11Release = true;
+    } else {
+      enabled$1.enableV11Release = false;
+    }
+  } else {
+    enabled$1.enableV11Release = true;
+  }
+  if (process.env.CARBON_ENABLE_EXPERIMENTAL_TILE_CONTRAST) {
+    if (process.env.CARBON_ENABLE_EXPERIMENTAL_TILE_CONTRAST === 'true') {
+      enabled$1.enableExperimentalTileContrast = true;
+    } else {
+      enabled$1.enableExperimentalTileContrast = false;
+    }
+  } else {
+    enabled$1.enableExperimentalTileContrast = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_TILE_DEFAULT_ICONS) {
+    if (process.env.CARBON_ENABLE_V12_TILE_DEFAULT_ICONS === 'true') {
+      enabled$1.enableV12TileDefaultIcons = true;
+    } else {
+      enabled$1.enableV12TileDefaultIcons = false;
+    }
+  } else {
+    enabled$1.enableV12TileDefaultIcons = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_TILE_RADIO_ICONS) {
+    if (process.env.CARBON_ENABLE_V12_TILE_RADIO_ICONS === 'true') {
+      enabled$1.enableV12TileRadioIcons = true;
+    } else {
+      enabled$1.enableV12TileRadioIcons = false;
+    }
+  } else {
+    enabled$1.enableV12TileRadioIcons = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_OVERFLOWMENU) {
+    if (process.env.CARBON_ENABLE_V12_OVERFLOWMENU === 'true') {
+      enabled$1.enableV12Overflowmenu = true;
+    } else {
+      enabled$1.enableV12Overflowmenu = false;
+    }
+  } else {
+    enabled$1.enableV12Overflowmenu = false;
+  }
+  if (process.env.CARBON_ENABLE_TREEVIEW_CONTROLLABLE) {
+    if (process.env.CARBON_ENABLE_TREEVIEW_CONTROLLABLE === 'true') {
+      enabled$1.enableTreeviewControllable = true;
+    } else {
+      enabled$1.enableTreeviewControllable = false;
+    }
+  } else {
+    enabled$1.enableTreeviewControllable = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_STRUCTURED_LIST_VISIBLE_ICONS) {
+    if (process.env.CARBON_ENABLE_V12_STRUCTURED_LIST_VISIBLE_ICONS === 'true') {
+      enabled$1.enableV12StructuredListVisibleIcons = true;
+    } else {
+      enabled$1.enableV12StructuredListVisibleIcons = false;
+    }
+  } else {
+    enabled$1.enableV12StructuredListVisibleIcons = false;
+  }
+  if (process.env.CARBON_ENABLE_EXPERIMENTAL_FOCUS_WRAP_WITHOUT_SENTINELS) {
+    if (process.env.CARBON_ENABLE_EXPERIMENTAL_FOCUS_WRAP_WITHOUT_SENTINELS === 'true') {
+      enabled$1.enableExperimentalFocusWrapWithoutSentinels = true;
+    } else {
+      enabled$1.enableExperimentalFocusWrapWithoutSentinels = false;
+    }
+  } else {
+    enabled$1.enableExperimentalFocusWrapWithoutSentinels = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_DYNAMIC_FLOATING_STYLES) {
+    if (process.env.CARBON_ENABLE_V12_DYNAMIC_FLOATING_STYLES === 'true') {
+      enabled$1.enableV12DynamicFloatingStyles = true;
+    } else {
+      enabled$1.enableV12DynamicFloatingStyles = false;
+    }
+  } else {
+    enabled$1.enableV12DynamicFloatingStyles = false;
+  }
+} catch (error) {
+  enabled$1.enableCssCustomProperties = false;
+  enabled$1.enableCssGrid = false;
+  enabled$1.enableV11Release = true;
+  enabled$1.enableExperimentalTileContrast = false;
+  enabled$1.enableV12TileDefaultIcons = false;
+  enabled$1.enableV12TileRadioIcons = false;
+  enabled$1.enableV12Overflowmenu = false;
+  enabled$1.enableTreeviewControllable = false;
+  enabled$1.enableV12StructuredListVisibleIcons = false;
+  enabled$1.enableExperimentalFocusWrapWithoutSentinels = false;
+  enabled$1.enableV12DynamicFloatingStyles = false;
+}
+var featureFlagInfo = [{
+  name: "enable-css-custom-properties",
+  description: "Describe what the flag does",
+  enabled: enabled$1.enableCssCustomProperties
+}, {
+  name: "enable-css-grid",
+  description: "Enable CSS Grid Layout in the Grid and Column React components\n",
+  enabled: enabled$1.enableCssGrid
+}, {
+  name: "enable-v11-release",
+  description: "Enable the features and functionality for the v11 Release\n",
+  enabled: enabled$1.enableV11Release
+}, {
+  name: "enable-experimental-tile-contrast",
+  description: "Enable the experimental tile improved contrast styles\n",
+  enabled: enabled$1.enableExperimentalTileContrast
+}, {
+  name: "enable-v12-tile-default-icons",
+  description: "Enable rendering of default icons in the tile components\n",
+  enabled: enabled$1.enableV12TileDefaultIcons
+}, {
+  name: "enable-v12-tile-radio-icons",
+  description: "Enable rendering of radio icons in the RadioTile component\n",
+  enabled: enabled$1.enableV12TileRadioIcons
+}, {
+  name: "enable-v12-overflowmenu",
+  description: "Enable the use of the v12 OverflowMenu leveraging the Menu subcomponents\n",
+  enabled: enabled$1.enableV12Overflowmenu
+}, {
+  name: "enable-treeview-controllable",
+  description: "Enable the new TreeView controllable API\n",
+  enabled: enabled$1.enableTreeviewControllable
+}, {
+  name: "enable-v12-structured-list-visible-icons",
+  description: "Enable rendering of radio icons in the StructuredList component\n",
+  enabled: enabled$1.enableV12StructuredListVisibleIcons
+}, {
+  name: "enable-experimental-focus-wrap-without-sentinels",
+  description: "Enable the new focus wrap behavior that doesn't use sentinel nodes\n",
+  enabled: enabled$1.enableExperimentalFocusWrapWithoutSentinels
+}, {
+  name: "enable-v12-dynamic-floating-styles",
+  description: "Enable dynamic setting of floating styles for components like Popover, Tooltip, etc.\n",
+  enabled: enabled$1.enableV12DynamicFloatingStyles
+}];
+
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithHoles(r) {
+  if (Array.isArray(r)) return r;
+}
+function _classCallCheck(a, n) {
+  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
+}
+function _defineProperties(e, r) {
+  for (var t = 0; t < r.length; t++) {
+    var o = r[t];
+    o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o);
+  }
+}
+function _createClass(e, r, t) {
+  return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", {
+    writable: !1
+  }), e;
+}
+function _createForOfIteratorHelper(r, e) {
+  var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (!t) {
+    if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) {
+      t && (r = t);
+      var n = 0,
+        F = function () {};
+      return {
+        s: F,
+        n: function () {
+          return n >= r.length ? {
+            done: !0
+          } : {
+            done: !1,
+            value: r[n++]
+          };
+        },
+        e: function (r) {
+          throw r;
+        },
+        f: F
+      };
+    }
+    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+  }
+  var o,
+    a = !0,
+    u = !1;
+  return {
+    s: function () {
+      t = t.call(r);
+    },
+    n: function () {
+      var r = t.next();
+      return a = r.done, r;
+    },
+    e: function (r) {
+      u = !0, o = r;
+    },
+    f: function () {
+      try {
+        a || null == t.return || t.return();
+      } finally {
+        if (u) throw o;
+      }
+    }
+  };
+}
+function _iterableToArrayLimit(r, l) {
+  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (null != t) {
+    var e,
+      n,
+      i,
+      u,
+      a = [],
+      f = !0,
+      o = !1;
+    try {
+      if (i = (t = t.call(r)).next, 0 === l) {
+        if (Object(t) !== t) return;
+        f = !1;
+      } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
+    } catch (r) {
+      o = !0, n = r;
+    } finally {
+      try {
+        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
+      } finally {
+        if (o) throw n;
+      }
+    }
+    return a;
+  }
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _slicedToArray(r, e) {
+  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r || "default");
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+/**
+ * Copyright OctaviaFlow. 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+var FeatureFlagScope = /*#__PURE__*/function () {
+  function FeatureFlagScope(flags) {
+    var _this = this;
+    _classCallCheck(this, FeatureFlagScope);
+    this.flags = new Map();
+    if (flags) {
+      Object.keys(flags).forEach(function (key) {
+        _this.flags.set(key, flags[key]);
+      });
+    }
+  }
+
+  /**
+   * Check to see if a flag exists
+   * @param {string} name
+   */
+  return _createClass(FeatureFlagScope, [{
+    key: "checkForFlag",
+    value: function checkForFlag(name) {
+      if (!this.flags.has(name)) {
+        throw new Error("Unable to find a feature flag with the name: `".concat(name, "`"));
+      }
+    }
+
+    /**
+     * Add a feature flag
+     * @param {string} name
+     * @param {boolean} enabled
+     */
+  }, {
+    key: "add",
+    value: function add(name, enabled) {
+      if (this.flags.has(name)) {
+        throw new Error("The feature flag: ".concat(name, " already exists"));
+      }
+      this.flags.set(name, enabled);
+    }
+
+    /**
+     * Enable a feature flag
+     * @param {string} name
+     */
+  }, {
+    key: "enable",
+    value: function enable(name) {
+      this.checkForFlag(name);
+      this.flags.set(name, true);
+    }
+
+    /**
+     * Disable a feature flag
+     * @param {string} name
+     */
+  }, {
+    key: "disable",
+    value: function disable(name) {
+      this.checkForFlag(name);
+      this.flags.set(name, false);
+    }
+
+    /**
+     * Merge the given feature flags with the current set of feature flags.
+     * Duplicate keys will be set to the value in the given feature flags.
+     * @param {object} flags
+     */
+  }, {
+    key: "merge",
+    value: function merge(flags) {
+      var _this2 = this;
+      Object.keys(flags).forEach(function (key) {
+        _this2.flags.set(key, flags[key]);
+      });
+    }
+
+    /**
+     * @param {FeatureFlagScope} scope
+     */
+  }, {
+    key: "mergeWithScope",
+    value: function mergeWithScope(scope) {
+      var _iterator = _createForOfIteratorHelper(scope.flags),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var _step$value = _slicedToArray(_step.value, 2),
+            key = _step$value[0],
+            value = _step$value[1];
+          if (this.flags.has(key)) {
+            continue;
+          }
+          this.flags.set(key, value);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+
+    /**
+     * Check if a feature flag is enabled
+     * @param {string} name
+     * @returns {boolean}
+     */
+  }, {
+    key: "enabled",
+    value: function enabled(name) {
+      this.checkForFlag(name);
+      return this.flags.get(name);
+    }
+  }]);
+}();
+
+var FeatureFlags = createScope();
+for (var i = 0; i < featureFlagInfo.length; i++) {
+  var featureFlag = featureFlagInfo[i];
+  FeatureFlags.add(featureFlag.name, featureFlag.enabled);
+}
+function createScope(flags) {
+  return new FeatureFlagScope(flags);
+}
+function add() {
+  return FeatureFlags.add.apply(FeatureFlags, arguments);
+}
+function enable() {
+  return FeatureFlags.enable.apply(FeatureFlags, arguments);
+}
+function disable() {
+  return FeatureFlags.disable.apply(FeatureFlags, arguments);
+}
+function enabled() {
+  return FeatureFlags.enabled.apply(FeatureFlags, arguments);
+}
+function merge() {
+  return FeatureFlags.merge.apply(FeatureFlags, arguments);
+}
+
+export { FeatureFlags, add, createScope, disable, enable, enabled, merge };

package/index.scss

@@ -0,0 +1,64 @@
+//
+// Copyright IBM Corp. 2015, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+@use 'sass:map';
+@use 'scss/generated/feature-flags';
+
+$feature-flags: () !default;
+$feature-flags: map.merge(
+  feature-flags.$generated-feature-flags,
+  $feature-flags
+);
+
+@function check-for-flag($name) {
+  @if map.has-key($feature-flags, $name) == true {
+    @return true;
+  }
+  @error 'Unable to find a feature flag named: #{$name}';
+}
+
+@mixin add($name, $enabled: false) {
+  @if map.has-key($feature-flags, $name) == true {
+    @error 'A feature flag named #{$name} already exists';
+  }
+
+  $feature-flags: map.set($feature-flags, $name, $enabled) !global;
+}
+
+@mixin enable($name) {
+  @if check-for-flag($name) == true {
+    $feature-flags: map.set($feature-flags, $name, true) !global;
+  }
+}
+
+@mixin disable($name) {
+  @if check-for-flag($name) == true {
+    $feature-flags: map.set($feature-flags, $name, false) !global;
+  }
+}
+
+@mixin merge($flags) {
+  $feature-flags: map.merge($feature-flags, $flags) !global;
+}
+
+/// Check if a feature flag is enabled
+/// @param {String} $name
+/// @returns {Boolean}
+@function enabled($name) {
+  @if check-for-flag($name) == true {
+    @return map.get($feature-flags, $name);
+  }
+}
+
+/// Emit the content of the mixin if the feature flag is enabled
+/// @param {String} $name
+/// @content
+@mixin enabled($name) {
+  @if enabled($name) {
+    @content;
+  }
+}

package/lib/index.js

@@ -0,0 +1,442 @@
+
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var enabled$1 = {};
+try {
+  if (process.env.CARBON_ENABLE_CSS_CUSTOM_PROPERTIES) {
+    if (process.env.CARBON_ENABLE_CSS_CUSTOM_PROPERTIES === 'true') {
+      enabled$1.enableCssCustomProperties = true;
+    } else {
+      enabled$1.enableCssCustomProperties = false;
+    }
+  } else {
+    enabled$1.enableCssCustomProperties = false;
+  }
+  if (process.env.CARBON_ENABLE_CSS_GRID) {
+    if (process.env.CARBON_ENABLE_CSS_GRID === 'true') {
+      enabled$1.enableCssGrid = true;
+    } else {
+      enabled$1.enableCssGrid = false;
+    }
+  } else {
+    enabled$1.enableCssGrid = false;
+  }
+  if (process.env.CARBON_ENABLE_V11_RELEASE) {
+    if (process.env.CARBON_ENABLE_V11_RELEASE === 'true') {
+      enabled$1.enableV11Release = true;
+    } else {
+      enabled$1.enableV11Release = false;
+    }
+  } else {
+    enabled$1.enableV11Release = true;
+  }
+  if (process.env.CARBON_ENABLE_EXPERIMENTAL_TILE_CONTRAST) {
+    if (process.env.CARBON_ENABLE_EXPERIMENTAL_TILE_CONTRAST === 'true') {
+      enabled$1.enableExperimentalTileContrast = true;
+    } else {
+      enabled$1.enableExperimentalTileContrast = false;
+    }
+  } else {
+    enabled$1.enableExperimentalTileContrast = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_TILE_DEFAULT_ICONS) {
+    if (process.env.CARBON_ENABLE_V12_TILE_DEFAULT_ICONS === 'true') {
+      enabled$1.enableV12TileDefaultIcons = true;
+    } else {
+      enabled$1.enableV12TileDefaultIcons = false;
+    }
+  } else {
+    enabled$1.enableV12TileDefaultIcons = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_TILE_RADIO_ICONS) {
+    if (process.env.CARBON_ENABLE_V12_TILE_RADIO_ICONS === 'true') {
+      enabled$1.enableV12TileRadioIcons = true;
+    } else {
+      enabled$1.enableV12TileRadioIcons = false;
+    }
+  } else {
+    enabled$1.enableV12TileRadioIcons = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_OVERFLOWMENU) {
+    if (process.env.CARBON_ENABLE_V12_OVERFLOWMENU === 'true') {
+      enabled$1.enableV12Overflowmenu = true;
+    } else {
+      enabled$1.enableV12Overflowmenu = false;
+    }
+  } else {
+    enabled$1.enableV12Overflowmenu = false;
+  }
+  if (process.env.CARBON_ENABLE_TREEVIEW_CONTROLLABLE) {
+    if (process.env.CARBON_ENABLE_TREEVIEW_CONTROLLABLE === 'true') {
+      enabled$1.enableTreeviewControllable = true;
+    } else {
+      enabled$1.enableTreeviewControllable = false;
+    }
+  } else {
+    enabled$1.enableTreeviewControllable = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_STRUCTURED_LIST_VISIBLE_ICONS) {
+    if (process.env.CARBON_ENABLE_V12_STRUCTURED_LIST_VISIBLE_ICONS === 'true') {
+      enabled$1.enableV12StructuredListVisibleIcons = true;
+    } else {
+      enabled$1.enableV12StructuredListVisibleIcons = false;
+    }
+  } else {
+    enabled$1.enableV12StructuredListVisibleIcons = false;
+  }
+  if (process.env.CARBON_ENABLE_EXPERIMENTAL_FOCUS_WRAP_WITHOUT_SENTINELS) {
+    if (process.env.CARBON_ENABLE_EXPERIMENTAL_FOCUS_WRAP_WITHOUT_SENTINELS === 'true') {
+      enabled$1.enableExperimentalFocusWrapWithoutSentinels = true;
+    } else {
+      enabled$1.enableExperimentalFocusWrapWithoutSentinels = false;
+    }
+  } else {
+    enabled$1.enableExperimentalFocusWrapWithoutSentinels = false;
+  }
+  if (process.env.CARBON_ENABLE_V12_DYNAMIC_FLOATING_STYLES) {
+    if (process.env.CARBON_ENABLE_V12_DYNAMIC_FLOATING_STYLES === 'true') {
+      enabled$1.enableV12DynamicFloatingStyles = true;
+    } else {
+      enabled$1.enableV12DynamicFloatingStyles = false;
+    }
+  } else {
+    enabled$1.enableV12DynamicFloatingStyles = false;
+  }
+} catch (error) {
+  enabled$1.enableCssCustomProperties = false;
+  enabled$1.enableCssGrid = false;
+  enabled$1.enableV11Release = true;
+  enabled$1.enableExperimentalTileContrast = false;
+  enabled$1.enableV12TileDefaultIcons = false;
+  enabled$1.enableV12TileRadioIcons = false;
+  enabled$1.enableV12Overflowmenu = false;
+  enabled$1.enableTreeviewControllable = false;
+  enabled$1.enableV12StructuredListVisibleIcons = false;
+  enabled$1.enableExperimentalFocusWrapWithoutSentinels = false;
+  enabled$1.enableV12DynamicFloatingStyles = false;
+}
+var featureFlagInfo = [{
+  name: "enable-css-custom-properties",
+  description: "Describe what the flag does",
+  enabled: enabled$1.enableCssCustomProperties
+}, {
+  name: "enable-css-grid",
+  description: "Enable CSS Grid Layout in the Grid and Column React components\n",
+  enabled: enabled$1.enableCssGrid
+}, {
+  name: "enable-v11-release",
+  description: "Enable the features and functionality for the v11 Release\n",
+  enabled: enabled$1.enableV11Release
+}, {
+  name: "enable-experimental-tile-contrast",
+  description: "Enable the experimental tile improved contrast styles\n",
+  enabled: enabled$1.enableExperimentalTileContrast
+}, {
+  name: "enable-v12-tile-default-icons",
+  description: "Enable rendering of default icons in the tile components\n",
+  enabled: enabled$1.enableV12TileDefaultIcons
+}, {
+  name: "enable-v12-tile-radio-icons",
+  description: "Enable rendering of radio icons in the RadioTile component\n",
+  enabled: enabled$1.enableV12TileRadioIcons
+}, {
+  name: "enable-v12-overflowmenu",
+  description: "Enable the use of the v12 OverflowMenu leveraging the Menu subcomponents\n",
+  enabled: enabled$1.enableV12Overflowmenu
+}, {
+  name: "enable-treeview-controllable",
+  description: "Enable the new TreeView controllable API\n",
+  enabled: enabled$1.enableTreeviewControllable
+}, {
+  name: "enable-v12-structured-list-visible-icons",
+  description: "Enable rendering of radio icons in the StructuredList component\n",
+  enabled: enabled$1.enableV12StructuredListVisibleIcons
+}, {
+  name: "enable-experimental-focus-wrap-without-sentinels",
+  description: "Enable the new focus wrap behavior that doesn't use sentinel nodes\n",
+  enabled: enabled$1.enableExperimentalFocusWrapWithoutSentinels
+}, {
+  name: "enable-v12-dynamic-floating-styles",
+  description: "Enable dynamic setting of floating styles for components like Popover, Tooltip, etc.\n",
+  enabled: enabled$1.enableV12DynamicFloatingStyles
+}];
+
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithHoles(r) {
+  if (Array.isArray(r)) return r;
+}
+function _classCallCheck(a, n) {
+  if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function");
+}
+function _defineProperties(e, r) {
+  for (var t = 0; t < r.length; t++) {
+    var o = r[t];
+    o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o);
+  }
+}
+function _createClass(e, r, t) {
+  return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", {
+    writable: !1
+  }), e;
+}
+function _createForOfIteratorHelper(r, e) {
+  var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (!t) {
+    if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) {
+      t && (r = t);
+      var n = 0,
+        F = function () {};
+      return {
+        s: F,
+        n: function () {
+          return n >= r.length ? {
+            done: !0
+          } : {
+            done: !1,
+            value: r[n++]
+          };
+        },
+        e: function (r) {
+          throw r;
+        },
+        f: F
+      };
+    }
+    throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+  }
+  var o,
+    a = !0,
+    u = !1;
+  return {
+    s: function () {
+      t = t.call(r);
+    },
+    n: function () {
+      var r = t.next();
+      return a = r.done, r;
+    },
+    e: function (r) {
+      u = !0, o = r;
+    },
+    f: function () {
+      try {
+        a || null == t.return || t.return();
+      } finally {
+        if (u) throw o;
+      }
+    }
+  };
+}
+function _iterableToArrayLimit(r, l) {
+  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (null != t) {
+    var e,
+      n,
+      i,
+      u,
+      a = [],
+      f = !0,
+      o = !1;
+    try {
+      if (i = (t = t.call(r)).next, 0 === l) {
+        if (Object(t) !== t) return;
+        f = !1;
+      } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
+    } catch (r) {
+      o = !0, n = r;
+    } finally {
+      try {
+        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
+      } finally {
+        if (o) throw n;
+      }
+    }
+    return a;
+  }
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _slicedToArray(r, e) {
+  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r || "default");
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+/**
+ * Copyright OctaviaFlow. 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+var FeatureFlagScope = /*#__PURE__*/function () {
+  function FeatureFlagScope(flags) {
+    var _this = this;
+    _classCallCheck(this, FeatureFlagScope);
+    this.flags = new Map();
+    if (flags) {
+      Object.keys(flags).forEach(function (key) {
+        _this.flags.set(key, flags[key]);
+      });
+    }
+  }
+
+  /**
+   * Check to see if a flag exists
+   * @param {string} name
+   */
+  return _createClass(FeatureFlagScope, [{
+    key: "checkForFlag",
+    value: function checkForFlag(name) {
+      if (!this.flags.has(name)) {
+        throw new Error("Unable to find a feature flag with the name: `".concat(name, "`"));
+      }
+    }
+
+    /**
+     * Add a feature flag
+     * @param {string} name
+     * @param {boolean} enabled
+     */
+  }, {
+    key: "add",
+    value: function add(name, enabled) {
+      if (this.flags.has(name)) {
+        throw new Error("The feature flag: ".concat(name, " already exists"));
+      }
+      this.flags.set(name, enabled);
+    }
+
+    /**
+     * Enable a feature flag
+     * @param {string} name
+     */
+  }, {
+    key: "enable",
+    value: function enable(name) {
+      this.checkForFlag(name);
+      this.flags.set(name, true);
+    }
+
+    /**
+     * Disable a feature flag
+     * @param {string} name
+     */
+  }, {
+    key: "disable",
+    value: function disable(name) {
+      this.checkForFlag(name);
+      this.flags.set(name, false);
+    }
+
+    /**
+     * Merge the given feature flags with the current set of feature flags.
+     * Duplicate keys will be set to the value in the given feature flags.
+     * @param {object} flags
+     */
+  }, {
+    key: "merge",
+    value: function merge(flags) {
+      var _this2 = this;
+      Object.keys(flags).forEach(function (key) {
+        _this2.flags.set(key, flags[key]);
+      });
+    }
+
+    /**
+     * @param {FeatureFlagScope} scope
+     */
+  }, {
+    key: "mergeWithScope",
+    value: function mergeWithScope(scope) {
+      var _iterator = _createForOfIteratorHelper(scope.flags),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var _step$value = _slicedToArray(_step.value, 2),
+            key = _step$value[0],
+            value = _step$value[1];
+          if (this.flags.has(key)) {
+            continue;
+          }
+          this.flags.set(key, value);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+
+    /**
+     * Check if a feature flag is enabled
+     * @param {string} name
+     * @returns {boolean}
+     */
+  }, {
+    key: "enabled",
+    value: function enabled(name) {
+      this.checkForFlag(name);
+      return this.flags.get(name);
+    }
+  }]);
+}();
+
+var FeatureFlags = createScope();
+for (var i = 0; i < featureFlagInfo.length; i++) {
+  var featureFlag = featureFlagInfo[i];
+  FeatureFlags.add(featureFlag.name, featureFlag.enabled);
+}
+function createScope(flags) {
+  return new FeatureFlagScope(flags);
+}
+function add() {
+  return FeatureFlags.add.apply(FeatureFlags, arguments);
+}
+function enable() {
+  return FeatureFlags.enable.apply(FeatureFlags, arguments);
+}
+function disable() {
+  return FeatureFlags.disable.apply(FeatureFlags, arguments);
+}
+function enabled() {
+  return FeatureFlags.enabled.apply(FeatureFlags, arguments);
+}
+function merge() {
+  return FeatureFlags.merge.apply(FeatureFlags, arguments);
+}
+
+exports.FeatureFlags = FeatureFlags;
+exports.add = add;
+exports.createScope = createScope;
+exports.disable = disable;
+exports.enable = enable;
+exports.enabled = enabled;
+exports.merge = merge;

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@octaviaflow/feature-flags",
+  "description": "Build with feature flags in OctaviaFlow",
+  "version": "1.0.0",
+  "license": "Apache-2.0",
+  "main": "lib/index.js",
+  "module": "es/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/octaviaflow-design-system.git",
+    "directory": "packages/feature-flags"
+  },
+  "bugs": "https://github.com/octaviaflow-design-system/issues",
+  "files": [
+    "es",
+    "lib",
+    "scss",
+    "index.scss",
+    "telemetry.yml"
+  ],
+  "keywords": [
+    "octaviaflow",
+    "feature-flags",
+    "components",
+    "react"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun run clean && node tasks/build.js && rollup -c",
+    "clean": "rimraf es lib scss/generated src/generated",
+    "watch": "bun run clean && node tasks/build.js && rollup -c -w"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.24.7",
+    "@babel/generator": "^7.24.7",
+    "@babel/preset-env": "^7.24.7",
+    "@babel/template": "^7.24.7",
+    "@babel/types": "^7.24.7",
+    "@octaviaflow/scss-generator": "^1.0.0",
+    "@rollup/plugin-babel": "^6.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "change-case": "^4.1.2",
+    "fs-extra": "^11.0.0",
+    "js-yaml": "^3.14.0",
+    "rimraf": "^6.0.0",
+    "rollup": "^2.79.1",
+    "rollup-plugin-strip-banner": "^3.0.0"
+  },
+  "sideEffects": false,
+  "babel": {
+    "presets": [
+      "@babel/env"
+    ]
+  }
+}

package/scss/generated/feature-flags.scss

@@ -0,0 +1,21 @@
+// Code generated by @octaviaflow/feature-flags. DO NOT EDIT.
+//
+// Copyright IBM Corp. 2015, 2023
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+$generated-feature-flags: (
+  'enable-css-custom-properties': false,
+  'enable-css-grid': false,
+  'enable-v11-release': true,
+  'enable-experimental-tile-contrast': false,
+  'enable-v12-tile-default-icons': false,
+  'enable-v12-tile-radio-icons': false,
+  'enable-v12-overflowmenu': false,
+  'enable-treeview-controllable': false,
+  'enable-v12-structured-list-visible-icons': false,
+  'enable-experimental-focus-wrap-without-sentinels': false,
+  'enable-v12-dynamic-floating-styles': false,
+);

package/telemetry.yml

@@ -0,0 +1,17 @@
+# yaml-language-server: $schema=https://unpkg.com/@octaviaflow/telemetry-config-schema@v1.0.0/dist/config.schema.json
+version: 1
+projectId: 'eaa95bb4-28df-42d8-8ca1-58f7db07727b'
+projectName: 'OctaviaFlow Feature Flags'
+storage:
+  type: 'file'
+  file:
+    directory: '/Volumes/Main/Projects/OctaviaFlow-Design-System/telemetry-logs'
+    fileNamePattern: 'octaviaflow-feature-flags-{timestamp}.json'
+    maxFileSizeMB: 10
+    compress: false
+collect:
+  npm:
+    dependencies: null
+  js:
+    functions: {}
+    tokens: null