@wix/builder-utils 1.21.1

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@wix/builder-utils",
+  "version": "1.21.1",
+  "description": "Builder utilities for merging props with custom logic",
+  "main": "dist/cjs/index.js",
+  "types": "dist/types/index.d.ts",
+  "sideEffects": false,
+  "license": "UNLICENSED",
+  "files": [
+    "src",
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "yarn run build:esm && yarn run build:cjs && yarn run build:types && yarn run -T build:bundles builder-utils",
+    "build:esm": "tsc --project tsconfig.json --outDir dist/esm --module ES2022 --moduleResolution Bundler",
+    "build:cjs": "tsc --project tsconfig.json --outDir dist/cjs --module CommonJS --moduleResolution Node",
+    "build:types": "tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist/types",
+    "lint": "yarn run -T lint:package $npm_package_name",
+    "test-type-check": "tsc --project tsconfig.test.json",
+    "test": "yarn test-type-check && vitest --run",
+    "clean": "rm -rf coverage dist target tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "lodash": "^4.17.21"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.14.200",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.10"
+  },
+  "publishUnscoped": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "wix": {
+    "artifact": {
+      "groupId": "com.wixpress.npm",
+      "artifactId": "builder-utils",
+      "targets": {
+        "static": {
+          "folderToUpload": "dist/bundles"
+        },
+        "docker": false
+      }
+    },
+    "validations": {
+      "postBuild": [
+        "test",
+        "lint"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "module": "dist/esm/index.js",
+  "falconPackageHash": "f75c1f6c5a3c718c2a212b4e99c9ff41d2497c4cdcad1bb017400714"
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { mergeProps, removeElementProps } from './mergeUtils'
+export { getSignalValueDeep } from './signalUtils'

package/src/mergeUtils.ts

@@ -0,0 +1,66 @@
+import mergeWith from 'lodash/mergeWith'
+import merge from 'lodash/merge'
+import isPlainObject from 'lodash/isPlainObject'
+
+type WixProps = { elementProps: unknown }
+
+function mergeClassName(class1: unknown, class2: unknown) {
+    if (typeof class1 === 'string' && typeof class2 === 'string') {
+        const classSet = new Set([...class1.split(' '), ...class2.split(' ')])
+        return Array.from(classSet).join(' ')
+    }
+    return class1 || class2
+}
+
+function customMergeClasses(objValue: unknown, srcValue: unknown, key: string) {
+    if (!objValue) {
+        return srcValue
+    }
+
+    if (!srcValue) {
+        return objValue
+    }
+
+    if (key === 'className') {
+        return mergeClassName(objValue, srcValue)
+    }
+
+    return srcValue
+}
+
+function customMerge(objValue: unknown, srcValue: unknown, key: string) {
+    if (key === 'className') {
+        return mergeClassName(objValue, srcValue)
+    }
+
+    if (!objValue) {
+        return srcValue
+    }
+
+    if (!srcValue) {
+        return objValue
+    }
+
+    if (key === 'wix') {
+        return merge(objValue, srcValue, true)
+    }
+
+    if ((objValue as WixProps)?.elementProps || (srcValue as WixProps).elementProps || key === 'elementProps') {
+        return mergeWith(objValue, srcValue, customMerge)
+    }
+    if (srcValue && objValue && isPlainObject(srcValue) && isPlainObject(objValue)) {
+        return mergeWith(objValue, srcValue, customMergeClasses)
+    }
+    return srcValue
+}
+
+export const mergeProps = (srcProps: Record<string, unknown>, valueProps?: Record<string, unknown>) =>
+    mergeWith(srcProps || {}, valueProps, customMerge)
+
+export const removeElementProps = (obj: Record<string, unknown>): Record<string, unknown> | undefined => {
+    if (!obj) {
+        return undefined
+    }
+    const { elementProps, ...rest } = obj
+    return rest
+}

package/src/signalUtils.ts

@@ -0,0 +1,31 @@
+type Signal = {
+    get: () => unknown
+    peek: () => unknown
+    set: (value: unknown) => void
+}
+const isSignal = (maybeSignal: unknown): maybeSignal is Signal => {
+    return (
+        typeof maybeSignal === 'object' &&
+        maybeSignal !== null &&
+        'get' in maybeSignal &&
+        'peek' in maybeSignal &&
+        'set' in maybeSignal
+    )
+}
+
+/**
+ * Traverses a dot-separated path starting from target, unwrapping signals at every step.
+ * An empty path simply unwraps target itself if it is a signal.
+ * Mirrors the runtime's getSignalValueDeep in feature-builder-context-providers.
+ */
+export const getSignalValueDeep = (target: unknown, path = ''): unknown => {
+    let value = target
+    for (const segment of path.split('.').filter(Boolean)) {
+        if (value == null) {
+            break
+        }
+        const next = (value as Record<string, unknown>)[segment]
+        value = isSignal(next) ? next.get() : next
+    }
+    return isSignal(value) ? value.get() : value
+}