@irisui/utils 0.0.0-stage → 0.1.0

package/dist/index.cjs

@@ -0,0 +1,97 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  cn: () => cn,
+  useControllableState: () => useControllableState,
+  useReducedMotion: () => useReducedMotion
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cn.ts
+var import_clsx = require("clsx");
+var import_tailwind_merge = require("tailwind-merge");
+var twMerge = (0, import_tailwind_merge.extendTailwindMerge)({
+  extend: {
+    theme: {
+      text: ["xs", "sm", "md", "lg", "h1", "h2", "h3"],
+      "font-weight": ["regular", "medium", "bold"],
+      tracking: ["display"],
+      radius: ["pill", "field", "check", "card", "panel"],
+      blur: ["glass", "small"],
+      shadow: ["glass", "rim", "holo"],
+      animate: ["holo"]
+    }
+  }
+});
+function cn(...inputs) {
+  return twMerge((0, import_clsx.clsx)(inputs));
+}
+
+// src/use-reduced-motion.ts
+var import_react = require("react");
+var QUERY = "(prefers-reduced-motion: reduce)";
+function subscribe(onChange) {
+  const media = window.matchMedia(QUERY);
+  media.addEventListener("change", onChange);
+  return () => media.removeEventListener("change", onChange);
+}
+var getSnapshot = () => window.matchMedia(QUERY).matches;
+var getServerSnapshot = () => false;
+function useReducedMotion() {
+  return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+}
+
+// src/use-controllable-state.ts
+var import_react2 = require("react");
+function useControllableState({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const [uncontrolled, setUncontrolled] = (0, import_react2.useState)(defaultValue);
+  const isControlled = value !== void 0;
+  const current = isControlled ? value : uncontrolled;
+  const onChangeRef = (0, import_react2.useRef)(onChange);
+  (0, import_react2.useEffect)(() => {
+    onChangeRef.current = onChange;
+  });
+  const currentRef = (0, import_react2.useRef)(current);
+  currentRef.current = current;
+  const setValue = (0, import_react2.useCallback)(
+    (next) => {
+      const resolved = typeof next === "function" ? next(currentRef.current) : next;
+      if (Object.is(resolved, currentRef.current)) return;
+      if (!isControlled) setUncontrolled(resolved);
+      onChangeRef.current?.(resolved);
+    },
+    [isControlled]
+  );
+  return [current, setValue];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cn,
+  useControllableState,
+  useReducedMotion
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cn.ts","../src/use-reduced-motion.ts","../src/use-controllable-state.ts"],"sourcesContent":["export { cn, type ClassValue } from \"./cn\";\r\nexport { useReducedMotion } from \"./use-reduced-motion\";\r\nexport {\r\n  useControllableState,\r\n  type UseControllableStateParams,\r\n} from \"./use-controllable-state\";\r\n","import { clsx, type ClassValue } from \"clsx\";\r\nimport { extendTailwindMerge } from \"tailwind-merge\";\r\n\r\n/**\r\n * tailwind-merge only knows Tailwind's default scale. The custom theme keys\r\n * declared in `@irisui/tokens/tailwind.css` are registered here so that, for\r\n * instance, `text-h3` is seen as a font size and not as a text color.\r\n */\r\nconst twMerge = extendTailwindMerge({\r\n  extend: {\r\n    theme: {\r\n      text: [\"xs\", \"sm\", \"md\", \"lg\", \"h1\", \"h2\", \"h3\"],\r\n      \"font-weight\": [\"regular\", \"medium\", \"bold\"],\r\n      tracking: [\"display\"],\r\n      radius: [\"pill\", \"field\", \"check\", \"card\", \"panel\"],\r\n      blur: [\"glass\", \"small\"],\r\n      shadow: [\"glass\", \"rim\", \"holo\"],\r\n      animate: [\"holo\"],\r\n    },\r\n  },\r\n});\r\n\r\n/** Merges class names, resolving conflicting Tailwind utilities (last one wins). */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n\r\nexport type { ClassValue };\r\n","import { useSyncExternalStore } from \"react\";\r\n\r\nconst QUERY = \"(prefers-reduced-motion: reduce)\";\r\n\r\nfunction subscribe(onChange: () => void): () => void {\r\n  const media = window.matchMedia(QUERY);\r\n  media.addEventListener(\"change\", onChange);\r\n  return () => media.removeEventListener(\"change\", onChange);\r\n}\r\n\r\nconst getSnapshot = (): boolean => window.matchMedia(QUERY).matches;\r\nconst getServerSnapshot = (): boolean => false;\r\n\r\n/** `true` when the user asked the system for less motion. Always `false` on the server. */\r\nexport function useReducedMotion(): boolean {\r\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\r\n}\r\n","import { useCallback, useEffect, useRef, useState } from \"react\";\r\n\r\nexport interface UseControllableStateParams<T> {\r\n  /** Controlled value. When defined, the component is controlled. */\r\n  value?: T | undefined;\r\n  /** Initial value when uncontrolled. */\r\n  defaultValue: T;\r\n  /** Called with the next value, in both controlled and uncontrolled modes. */\r\n  onChange?: ((value: T) => void) | undefined;\r\n}\r\n\r\ntype SetStateFn<T> = (next: T | ((prev: T) => T)) => void;\r\n\r\n/**\r\n * State that can be either controlled (`value` + `onChange`) or uncontrolled\r\n * (`defaultValue`), following the Radix / shadcn convention.\r\n */\r\nexport function useControllableState<T>({\r\n  value,\r\n  defaultValue,\r\n  onChange,\r\n}: UseControllableStateParams<T>): [T, SetStateFn<T>] {\r\n  const [uncontrolled, setUncontrolled] = useState<T>(defaultValue);\r\n  const isControlled = value !== undefined;\r\n  const current = isControlled ? value : uncontrolled;\r\n\r\n  const onChangeRef = useRef(onChange);\r\n  useEffect(() => {\r\n    onChangeRef.current = onChange;\r\n  });\r\n\r\n  const currentRef = useRef(current);\r\n  currentRef.current = current;\r\n\r\n  const setValue = useCallback<SetStateFn<T>>(\r\n    (next) => {\r\n      const resolved =\r\n        typeof next === \"function\" ? (next as (prev: T) => T)(currentRef.current) : next;\r\n      if (Object.is(resolved, currentRef.current)) return;\r\n      if (!isControlled) setUncontrolled(resolved);\r\n      onChangeRef.current?.(resolved);\r\n    },\r\n    [isControlled],\r\n  );\r\n\r\n  return [current, setValue];\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAsC;AACtC,4BAAoC;AAOpC,IAAM,cAAU,2CAAoB;AAAA,EAClC,QAAQ;AAAA,IACN,OAAO;AAAA,MACL,MAAM,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AAAA,MAC/C,eAAe,CAAC,WAAW,UAAU,MAAM;AAAA,MAC3C,UAAU,CAAC,SAAS;AAAA,MACpB,QAAQ,CAAC,QAAQ,SAAS,SAAS,QAAQ,OAAO;AAAA,MAClD,MAAM,CAAC,SAAS,OAAO;AAAA,MACvB,QAAQ,CAAC,SAAS,OAAO,MAAM;AAAA,MAC/B,SAAS,CAAC,MAAM;AAAA,IAClB;AAAA,EACF;AACF,CAAC;AAGM,SAAS,MAAM,QAA8B;AAClD,SAAO,YAAQ,kBAAK,MAAM,CAAC;AAC7B;;;ACzBA,mBAAqC;AAErC,IAAM,QAAQ;AAEd,SAAS,UAAU,UAAkC;AACnD,QAAM,QAAQ,OAAO,WAAW,KAAK;AACrC,QAAM,iBAAiB,UAAU,QAAQ;AACzC,SAAO,MAAM,MAAM,oBAAoB,UAAU,QAAQ;AAC3D;AAEA,IAAM,cAAc,MAAe,OAAO,WAAW,KAAK,EAAE;AAC5D,IAAM,oBAAoB,MAAe;AAGlC,SAAS,mBAA4B;AAC1C,aAAO,mCAAqB,WAAW,aAAa,iBAAiB;AACvE;;;AChBA,IAAAA,gBAAyD;AAiBlD,SAAS,qBAAwB;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AACF,GAAsD;AACpD,QAAM,CAAC,cAAc,eAAe,QAAI,wBAAY,YAAY;AAChE,QAAM,eAAe,UAAU;AAC/B,QAAM,UAAU,eAAe,QAAQ;AAEvC,QAAM,kBAAc,sBAAO,QAAQ;AACnC,+BAAU,MAAM;AACd,gBAAY,UAAU;AAAA,EACxB,CAAC;AAED,QAAM,iBAAa,sBAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,eAAW;AAAA,IACf,CAAC,SAAS;AACR,YAAM,WACJ,OAAO,SAAS,aAAc,KAAwB,WAAW,OAAO,IAAI;AAC9E,UAAI,OAAO,GAAG,UAAU,WAAW,OAAO,EAAG;AAC7C,UAAI,CAAC,aAAc,iBAAgB,QAAQ;AAC3C,kBAAY,UAAU,QAAQ;AAAA,IAChC;AAAA,IACA,CAAC,YAAY;AAAA,EACf;AAEA,SAAO,CAAC,SAAS,QAAQ;AAC3B;","names":["import_react"]}

package/dist/index.d.cts

@@ -0,0 +1,25 @@
+import { ClassValue } from 'clsx';
+export { ClassValue } from 'clsx';
+
+/** Merges class names, resolving conflicting Tailwind utilities (last one wins). */
+declare function cn(...inputs: ClassValue[]): string;
+
+/** `true` when the user asked the system for less motion. Always `false` on the server. */
+declare function useReducedMotion(): boolean;
+
+interface UseControllableStateParams<T> {
+    /** Controlled value. When defined, the component is controlled. */
+    value?: T | undefined;
+    /** Initial value when uncontrolled. */
+    defaultValue: T;
+    /** Called with the next value, in both controlled and uncontrolled modes. */
+    onChange?: ((value: T) => void) | undefined;
+}
+type SetStateFn<T> = (next: T | ((prev: T) => T)) => void;
+/**
+ * State that can be either controlled (`value` + `onChange`) or uncontrolled
+ * (`defaultValue`), following the Radix / shadcn convention.
+ */
+declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateParams<T>): [T, SetStateFn<T>];
+
+export { type UseControllableStateParams, cn, useControllableState, useReducedMotion };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { ClassValue } from 'clsx';
+export { ClassValue } from 'clsx';
+
+/** Merges class names, resolving conflicting Tailwind utilities (last one wins). */
+declare function cn(...inputs: ClassValue[]): string;
+
+/** `true` when the user asked the system for less motion. Always `false` on the server. */
+declare function useReducedMotion(): boolean;
+
+interface UseControllableStateParams<T> {
+    /** Controlled value. When defined, the component is controlled. */
+    value?: T | undefined;
+    /** Initial value when uncontrolled. */
+    defaultValue: T;
+    /** Called with the next value, in both controlled and uncontrolled modes. */
+    onChange?: ((value: T) => void) | undefined;
+}
+type SetStateFn<T> = (next: T | ((prev: T) => T)) => void;
+/**
+ * State that can be either controlled (`value` + `onChange`) or uncontrolled
+ * (`defaultValue`), following the Radix / shadcn convention.
+ */
+declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateParams<T>): [T, SetStateFn<T>];
+
+export { type UseControllableStateParams, cn, useControllableState, useReducedMotion };

package/dist/index.js

@@ -0,0 +1,69 @@
+"use client";
+
+// src/cn.ts
+import { clsx } from "clsx";
+import { extendTailwindMerge } from "tailwind-merge";
+var twMerge = extendTailwindMerge({
+  extend: {
+    theme: {
+      text: ["xs", "sm", "md", "lg", "h1", "h2", "h3"],
+      "font-weight": ["regular", "medium", "bold"],
+      tracking: ["display"],
+      radius: ["pill", "field", "check", "card", "panel"],
+      blur: ["glass", "small"],
+      shadow: ["glass", "rim", "holo"],
+      animate: ["holo"]
+    }
+  }
+});
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/use-reduced-motion.ts
+import { useSyncExternalStore } from "react";
+var QUERY = "(prefers-reduced-motion: reduce)";
+function subscribe(onChange) {
+  const media = window.matchMedia(QUERY);
+  media.addEventListener("change", onChange);
+  return () => media.removeEventListener("change", onChange);
+}
+var getSnapshot = () => window.matchMedia(QUERY).matches;
+var getServerSnapshot = () => false;
+function useReducedMotion() {
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+
+// src/use-controllable-state.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+function useControllableState({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const [uncontrolled, setUncontrolled] = useState(defaultValue);
+  const isControlled = value !== void 0;
+  const current = isControlled ? value : uncontrolled;
+  const onChangeRef = useRef(onChange);
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  });
+  const currentRef = useRef(current);
+  currentRef.current = current;
+  const setValue = useCallback(
+    (next) => {
+      const resolved = typeof next === "function" ? next(currentRef.current) : next;
+      if (Object.is(resolved, currentRef.current)) return;
+      if (!isControlled) setUncontrolled(resolved);
+      onChangeRef.current?.(resolved);
+    },
+    [isControlled]
+  );
+  return [current, setValue];
+}
+export {
+  cn,
+  useControllableState,
+  useReducedMotion
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cn.ts","../src/use-reduced-motion.ts","../src/use-controllable-state.ts"],"sourcesContent":["import { clsx, type ClassValue } from \"clsx\";\r\nimport { extendTailwindMerge } from \"tailwind-merge\";\r\n\r\n/**\r\n * tailwind-merge only knows Tailwind's default scale. The custom theme keys\r\n * declared in `@irisui/tokens/tailwind.css` are registered here so that, for\r\n * instance, `text-h3` is seen as a font size and not as a text color.\r\n */\r\nconst twMerge = extendTailwindMerge({\r\n  extend: {\r\n    theme: {\r\n      text: [\"xs\", \"sm\", \"md\", \"lg\", \"h1\", \"h2\", \"h3\"],\r\n      \"font-weight\": [\"regular\", \"medium\", \"bold\"],\r\n      tracking: [\"display\"],\r\n      radius: [\"pill\", \"field\", \"check\", \"card\", \"panel\"],\r\n      blur: [\"glass\", \"small\"],\r\n      shadow: [\"glass\", \"rim\", \"holo\"],\r\n      animate: [\"holo\"],\r\n    },\r\n  },\r\n});\r\n\r\n/** Merges class names, resolving conflicting Tailwind utilities (last one wins). */\r\nexport function cn(...inputs: ClassValue[]): string {\r\n  return twMerge(clsx(inputs));\r\n}\r\n\r\nexport type { ClassValue };\r\n","import { useSyncExternalStore } from \"react\";\r\n\r\nconst QUERY = \"(prefers-reduced-motion: reduce)\";\r\n\r\nfunction subscribe(onChange: () => void): () => void {\r\n  const media = window.matchMedia(QUERY);\r\n  media.addEventListener(\"change\", onChange);\r\n  return () => media.removeEventListener(\"change\", onChange);\r\n}\r\n\r\nconst getSnapshot = (): boolean => window.matchMedia(QUERY).matches;\r\nconst getServerSnapshot = (): boolean => false;\r\n\r\n/** `true` when the user asked the system for less motion. Always `false` on the server. */\r\nexport function useReducedMotion(): boolean {\r\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\r\n}\r\n","import { useCallback, useEffect, useRef, useState } from \"react\";\r\n\r\nexport interface UseControllableStateParams<T> {\r\n  /** Controlled value. When defined, the component is controlled. */\r\n  value?: T | undefined;\r\n  /** Initial value when uncontrolled. */\r\n  defaultValue: T;\r\n  /** Called with the next value, in both controlled and uncontrolled modes. */\r\n  onChange?: ((value: T) => void) | undefined;\r\n}\r\n\r\ntype SetStateFn<T> = (next: T | ((prev: T) => T)) => void;\r\n\r\n/**\r\n * State that can be either controlled (`value` + `onChange`) or uncontrolled\r\n * (`defaultValue`), following the Radix / shadcn convention.\r\n */\r\nexport function useControllableState<T>({\r\n  value,\r\n  defaultValue,\r\n  onChange,\r\n}: UseControllableStateParams<T>): [T, SetStateFn<T>] {\r\n  const [uncontrolled, setUncontrolled] = useState<T>(defaultValue);\r\n  const isControlled = value !== undefined;\r\n  const current = isControlled ? value : uncontrolled;\r\n\r\n  const onChangeRef = useRef(onChange);\r\n  useEffect(() => {\r\n    onChangeRef.current = onChange;\r\n  });\r\n\r\n  const currentRef = useRef(current);\r\n  currentRef.current = current;\r\n\r\n  const setValue = useCallback<SetStateFn<T>>(\r\n    (next) => {\r\n      const resolved =\r\n        typeof next === \"function\" ? (next as (prev: T) => T)(currentRef.current) : next;\r\n      if (Object.is(resolved, currentRef.current)) return;\r\n      if (!isControlled) setUncontrolled(resolved);\r\n      onChangeRef.current?.(resolved);\r\n    },\r\n    [isControlled],\r\n  );\r\n\r\n  return [current, setValue];\r\n}\r\n"],"mappings":";;;AAAA,SAAS,YAA6B;AACtC,SAAS,2BAA2B;AAOpC,IAAM,UAAU,oBAAoB;AAAA,EAClC,QAAQ;AAAA,IACN,OAAO;AAAA,MACL,MAAM,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AAAA,MAC/C,eAAe,CAAC,WAAW,UAAU,MAAM;AAAA,MAC3C,UAAU,CAAC,SAAS;AAAA,MACpB,QAAQ,CAAC,QAAQ,SAAS,SAAS,QAAQ,OAAO;AAAA,MAClD,MAAM,CAAC,SAAS,OAAO;AAAA,MACvB,QAAQ,CAAC,SAAS,OAAO,MAAM;AAAA,MAC/B,SAAS,CAAC,MAAM;AAAA,IAClB;AAAA,EACF;AACF,CAAC;AAGM,SAAS,MAAM,QAA8B;AAClD,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC7B;;;ACzBA,SAAS,4BAA4B;AAErC,IAAM,QAAQ;AAEd,SAAS,UAAU,UAAkC;AACnD,QAAM,QAAQ,OAAO,WAAW,KAAK;AACrC,QAAM,iBAAiB,UAAU,QAAQ;AACzC,SAAO,MAAM,MAAM,oBAAoB,UAAU,QAAQ;AAC3D;AAEA,IAAM,cAAc,MAAe,OAAO,WAAW,KAAK,EAAE;AAC5D,IAAM,oBAAoB,MAAe;AAGlC,SAAS,mBAA4B;AAC1C,SAAO,qBAAqB,WAAW,aAAa,iBAAiB;AACvE;;;AChBA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AAiBlD,SAAS,qBAAwB;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AACF,GAAsD;AACpD,QAAM,CAAC,cAAc,eAAe,IAAI,SAAY,YAAY;AAChE,QAAM,eAAe,UAAU;AAC/B,QAAM,UAAU,eAAe,QAAQ;AAEvC,QAAM,cAAc,OAAO,QAAQ;AACnC,YAAU,MAAM;AACd,gBAAY,UAAU;AAAA,EACxB,CAAC;AAED,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,WAAW;AAAA,IACf,CAAC,SAAS;AACR,YAAM,WACJ,OAAO,SAAS,aAAc,KAAwB,WAAW,OAAO,IAAI;AAC9E,UAAI,OAAO,GAAG,UAAU,WAAW,OAAO,EAAG;AAC7C,UAAI,CAAC,aAAc,iBAAgB,QAAQ;AAC3C,kBAAY,UAAU,QAAQ;AAAA,IAChC;AAAA,IACA,CAAC,YAAY;AAAA,EACf;AAEA,SAAO,CAAC,SAAS,QAAQ;AAC3B;","names":[]}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@irisui/utils",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Shared utilities and hooks for the iris-ui library.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "clsx": "2.1.1",
+    "tailwind-merge": "3.7.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "19.3.0",
+    "react": "19.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/theteqlab/iris-ui.git",
+    "directory": "packages/utils"
+  },
+  "homepage": "https://github.com/theteqlab/iris-ui#readme",
+  "bugs": {
+    "url": "https://github.com/theteqlab/iris-ui/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.