dextuploadx5-react-webpack 0.0.1

package/LICENSE

@@ -0,0 +1,66 @@
+DEXTUploadX5 React Webpack Helper Free Use License
+
+Copyright (c) 2026 DEXTSolution
+
+For the purposes of this License, "Software" means only the DEXTUploadX5 React
+Webpack Helper package distributed with this License, and does not include the
+DEXTUploadX5 product itself, which is licensed separately as a commercial product.
+
+1. Grant of License
+Subject to the terms of this License, you are granted a worldwide, non-exclusive,
+non-transferable, revocable license to:
+
+- use the Software for personal, internal business, and commercial purposes;
+- install and run the Software in development, test, and production environments;
+- modify the Software for your own internal use.
+
+2. Restrictions
+You may not, without prior written permission from the copyright holder:
+
+- distribute, sublicense, sell, rent, lease, or otherwise make the Software available
+  to any third party as a standalone product;
+- publish, redistribute, or repackage the Software through npm, GitHub Packages,
+  private registries, mirrors, CDNs, or any other package distribution channel;
+- distribute, publish, sublicense, sell, or otherwise provide any modified version,
+  derivative work, or fork of the Software, in source or binary form;
+- remove, alter, or obscure any copyright, trademark, or license notice contained in
+  the Software;
+- use the name of the copyright holder, product name, or trademarks to market or
+  imply endorsement of any derivative or related product.
+
+3. Ownership
+The Software is licensed, not sold. All right, title, and interest in and to the
+Software, including all intellectual property rights, remain with the copyright holder.
+
+4. Internal Modifications
+You may create and use modified versions of the Software internally within your
+organization. Such modified versions may not be distributed, shared, sublicensed,
+sold, or otherwise provided to any third party.
+
+5. No Open Source Rights
+This License does not grant any right to distribute modified versions or derivative
+works, and it is not an open source license.
+
+6. Termination
+This License terminates automatically if you fail to comply with any term of this
+License. Upon termination, you must cease all use of the Software and destroy all
+copies in your possession or control, except to the extent retention is required by law.
+
+7. Disclaimer of Warranty
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, TITLE, NON-INFRINGEMENT, ACCURACY, OR THAT THE SOFTWARE WILL BE
+ERROR-FREE OR UNINTERRUPTED.
+
+8. Limitation of Liability
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE, INCLUDING BUT NOT
+LIMITED TO ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE
+DAMAGES, LOSS OF PROFITS, LOSS OF DATA, BUSINESS INTERRUPTION, OR PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES.
+
+9. Governing Law
+This License shall be governed by and construed in accordance with the laws of the
+Republic of Korea, excluding its conflict of laws principles.

package/README.md

@@ -0,0 +1,154 @@
+# DEXTUploadX5 React Webpack Helper
+
+Webpack helper package for `dextuploadx5-react`.
+
+`dextuploadx5-react` requires the DX5 static files to be available at the
+runtime `productPath`.
+
+This package automates that setup in Webpack projects. During development or
+production builds, it copies the DX5 files to the path that will be served as
+`productPath` and can also register that directory in `devServer`.
+
+## Features
+
+- Exposes `withDEXTUploadX5()` to extend an existing Webpack config
+- Automatically copies DX5 static files to the location served as `productPath`
+- Works in both development and production Webpack workflows
+- Can copy DX5 static files into the Webpack output directory
+- Can copy DX5 static files into a separate public directory
+- Can register static directories in `webpack-dev-server`
+
+## Requirements
+
+- Webpack 5 or later
+- `dextuploadx5-react@0.0.1` or later
+- DEXTUploadX5 `4.4.0.0 (beta)` or later through `dextuploadx5-react`
+
+## Installation
+
+```bash
+npm install dextuploadx5-react-webpack dextuploadx5-react webpack
+```
+
+## Quick Start
+
+```js
+import path from "path";
+import { withDEXTUploadX5 } from "dextuploadx5-react-webpack";
+
+function createConfig() {
+    return {
+        entry: "./src/index.jsx",
+        output: {
+            path: path.resolve(process.cwd(), "dist"),
+            filename: "bundle.js",
+            clean: true
+        }
+    };
+}
+
+export default withDEXTUploadX5(createConfig(), {
+    publicDir: path.resolve(process.cwd(), "public"),
+    dx5DirName: "dx5"
+});
+```
+
+With this configuration, the DX5 files are copied automatically so
+`dextuploadx5-react` can load them with `productPath="/dx5/"`.
+
+## API
+
+### `withDEXTUploadX5(webpackConfig, options?)`
+
+Returns a Webpack config with DX5 copy and serving behavior applied.
+
+```js
+const config = withDEXTUploadX5(baseConfig, options);
+```
+
+### Options
+
+#### `from?: string`
+
+Source DX5 directory.
+
+- Default: `node_modules/dextuploadx5-react/dist/dx5`
+
+#### `dx5DirName?: string`
+
+Directory name used in output paths and URLs.
+
+- Default: `"dx5"`
+
+#### `to?: string`
+
+Target directory inside the Webpack output when `emitToOutput` is enabled.
+
+- Default: same value as `dx5DirName`
+
+#### `emitToOutput?: boolean`
+
+Copies DX5 files into the Webpack output using `copy-webpack-plugin`.
+
+- Default: `true`
+
+#### `publicDir?: string`
+
+Absolute path of an external public directory.
+
+When set, the helper copies DX5 files to `publicDir/<dx5DirName>` and also
+registers that directory with `devServer.static`.
+
+This is useful when your application serves `productPath` from a public static
+directory such as `public/dx5`.
+
+## Typical Usage
+
+### Copy DX5 files into the Webpack output
+
+```js
+import { withDEXTUploadX5 } from "dextuploadx5-react-webpack";
+
+export default withDEXTUploadX5(baseConfig);
+```
+
+### Copy DX5 files into `public/dx5`
+
+```js
+import path from "path";
+import { withDEXTUploadX5 } from "dextuploadx5-react-webpack";
+
+export default withDEXTUploadX5(baseConfig, {
+    publicDir: path.resolve(process.cwd(), "public"),
+    dx5DirName: "dx5"
+});
+```
+
+## Notes
+
+- This package is a build-time helper. It does not replace `dextuploadx5-react`.
+- DX5 files are resolved from the installed `dextuploadx5-react` package first.
+- If `dextuploadx5-react` cannot be resolved automatically, the helper falls back to `process.cwd()/node_modules/dextuploadx5-react/dist/dx5`.
+- The purpose of this package is to remove the need to manage DX5 static file copying manually in Webpack projects.
+- DEXTUploadX5 itself is not distributed through npm, so its required version is documented here instead of `package.json`.
+
+## Compatibility
+
+| `dextuploadx5-react-webpack` | Minimum `dextuploadx5-react` | Minimum DEXTUploadX5 version |
+| --- | --- | --- |
+| `0.0.1` | `0.0.1` | `4.4.0.0 (beta)` |
+
+## History
+
+### 0.0.1
+
+- Initial package release
+
+## License
+
+This package is free to use, including commercial use.
+Modification for internal use is allowed.
+Redistribution of modified versions is prohibited.
+DEXTUploadX5 itself is a commercial product and is not free to use under the same terms as DEXTUploadX5 React Webpack Helper.
+
+See the `LICENSE` file for full terms.

package/dist/index.cjs

@@ -0,0 +1 @@
+const path=require("path"),fs=require("fs"),CopyWebpackPlugin=require("copy-webpack-plugin"),toArray=t=>Array.isArray(t)?t:t?[t]:[],stripHtmlComments=t=>String(t||"").replace(/<!--[\s\S]*?-->/g,""),escapeRegExp=t=>String(t).replace(/[.*+?^${}()|[\]\\]/g,"\\$&");function tryResolveReactDx5Dir(){try{const t=require.resolve("dextuploadx5-react"),e=path.dirname(t),r=path.resolve(e,"dx5");if(fs.existsSync(r))return r}catch{}return null}function getDefaultDx5Dir(){const t=tryResolveReactDx5Dir();return t||path.resolve(process.cwd(),"node_modules","dextuploadx5-react","dist","dx5")}async function copyDir(t,e){if(await fs.promises.mkdir(e,{recursive:!0}),"function"==typeof fs.promises.cp)return void await fs.promises.cp(t,e,{recursive:!0,force:!0});const r=await fs.promises.readdir(t,{withFileTypes:!0});await Promise.all(r.map(async r=>{const i=path.join(t,r.name),s=path.join(e,r.name);return r.isDirectory()?copyDir(i,s):r.isSymbolicLink()?fs.promises.copyFile(await fs.promises.realpath(i),s):fs.promises.copyFile(i,s)}))}function addStaticDir(t,e){if(!t||!e)return;const r=toArray(t.static);r.some(t=>path.resolve("string"==typeof t?t:t.directory)===path.resolve(e))||r.push({directory:e}),t.static=r}class CopyDx5ToPublicPlugin{constructor({fromDir:t,publicDir:e,dx5DirName:r}){this.fromDir=t,this.publicDir=e,this.dx5DirName=r,this.name="CopyDx5ToPublicPlugin"}apply(t){const e=t.getInfrastructureLogger("dextuploadx5-react-webpack"),r=async()=>{try{await fs.promises.access(this.fromDir)}catch(t){throw new Error(`[dextuploadx5-react-webpack] dx5 source not found: ${this.fromDir}. Install dextuploadx5-react (it ships dist/dx5), or pass { from: <path> }.`)}const t=path.resolve(this.publicDir,this.dx5DirName);await copyDir(this.fromDir,t),e.info(`Copied dx5 resources to ${t}`)};t.hooks.beforeRun.tapPromise(this.name,r),t.hooks.watchRun.tapPromise(this.name,r)}}class InjectDx5ScriptsPlugin{constructor({dx5DirName:t}){this.dx5DirName=t,this.name="InjectDx5ScriptsPlugin"}apply(t){const e=t.getInfrastructureLogger("dextuploadx5-react-webpack");let r;try{r=require("html-webpack-plugin")}catch(t){return void e.warn("[dextuploadx5-react-webpack] injectScripts=true but html-webpack-plugin is not installed. Skipping HTML <script> injection. Install html-webpack-plugin or add the <script> tags manually.")}"function"==typeof r.getHooks?t.hooks.compilation.tap(this.name,t=>{r.getHooks(t).beforeEmit.tap(this.name,t=>{const e=`/${this.dx5DirName}/dextuploadx5-configuration.js`,r=`/${this.dx5DirName}/dextuploadx5.js`,i=stripHtmlComments(t.html),s=t=>new RegExp(`<script[^>]*\\bsrc=["']${escapeRegExp(t)}["']`,"i").test(i),o=[s(e)?"":`<script src="${e}"><\/script>`,s(r)?"":`<script src="${r}"><\/script>`].filter(Boolean);if(0===o.length)return t;const a=o.join("");return t.html=/<\/head>/i.test(t.html)?t.html.replace(/<\/head>/i,`${a}</head>`):t.html+a,t})}):e.warn("[dextuploadx5-react-webpack] injectScripts=true but html-webpack-plugin.getHooks is unavailable. Skipping HTML <script> injection.")}}function withDEXTUploadX5(t,e={}){const r=e||{},i={...t},s=r.from||getDefaultDx5Dir(),o=r.dx5DirName||"dx5",a=r.to||o,p=!1!==r.emitToOutput,c=r.publicDir,n=Boolean(c);if(i.plugins=toArray(i.plugins),p&&i.plugins.push(new CopyWebpackPlugin({patterns:[{from:s,to:a}]})),n){if("string"!=typeof c||!path.isAbsolute(c))throw new Error(`[dextuploadx5-react-webpack] options.publicDir must be an absolute path. Got: ${c}`);i.plugins.push(new CopyDx5ToPublicPlugin({fromDir:s,publicDir:c,dx5DirName:o}))}return addStaticDir(i.devServer,i.output&&i.output.path),n&&addStaticDir(i.devServer,c),i}module.exports={withDEXTUploadX5:withDEXTUploadX5};

package/dist/index.mjs

@@ -0,0 +1 @@
+import r from"path";import t from"fs";import{createRequire as o}from"module";import i from"copy-webpack-plugin";const e=o(import.meta.url),s=r=>Array.isArray(r)?r:r?[r]:[];function a(){const o=function(){try{const o=e.resolve("dextuploadx5-react"),i=r.dirname(o),s=r.resolve(i,"dx5");if(t.existsSync(s))return s}catch{}return null}();return o||r.resolve(process.cwd(),"node_modules","dextuploadx5-react","dist","dx5")}async function p(o,i){if(await t.promises.mkdir(i,{recursive:!0}),"function"==typeof t.promises.cp)return void await t.promises.cp(o,i,{recursive:!0,force:!0});const e=await t.promises.readdir(o,{withFileTypes:!0});await Promise.all(e.map(async e=>{const s=r.join(o,e.name),a=r.join(i,e.name);return e.isDirectory()?p(s,a):e.isSymbolicLink()?t.promises.copyFile(await t.promises.realpath(s),a):t.promises.copyFile(s,a)}))}function n(t,o){if(!t||!o)return;const i=s(t.static);i.some(t=>r.resolve("string"==typeof t?t:t.directory)===r.resolve(o))||i.push({directory:o}),t.static=i}class c{constructor({fromDir:r,publicDir:t,dx5DirName:o}){this.fromDir=r,this.publicDir=t,this.dx5DirName=o,this.name="CopyDx5ToPublicPlugin"}apply(o){const i=o.getInfrastructureLogger("dextuploadx5-react-webpack"),e=async()=>{try{await t.promises.access(this.fromDir)}catch{throw new Error(`[dextuploadx5-react-webpack] dx5 source not found: ${this.fromDir}. Install dextuploadx5-react (it ships dist/dx5), or pass { from: <path> }.`)}const o=r.resolve(this.publicDir,this.dx5DirName);await p(this.fromDir,o),i.info(`Copied dx5 resources to ${o}`)};o.hooks.beforeRun.tapPromise(this.name,e),o.hooks.watchRun.tapPromise(this.name,e)}}export function withDEXTUploadX5(t,o={}){const e=o||{},p={...t},u=e.from||a(),m=e.dx5DirName||"dx5",l=e.to||m,d=!1!==e.emitToOutput,f=e.publicDir,h=Boolean(f);if(p.plugins=s(p.plugins),d&&p.plugins.push(new i({patterns:[{from:u,to:l}]})),h){if("string"!=typeof f||!r.isAbsolute(f))throw new Error(`[dextuploadx5-react-webpack] options.publicDir must be an absolute path. Got: ${f}`);p.plugins.push(new c({fromDir:u,publicDir:f,dx5DirName:m}))}return n(p.devServer,p.output&&p.output.path),h&&n(p.devServer,f),p}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "dextuploadx5-react-webpack",
+    "version": "0.0.1",
+    "private": false,
+    "description": "React Webpack helper for dextuploadx5-react (serves DX5 static resources)",
+    "keywords": [
+        "DEXTSolution",
+        "DEXTUploadX5",
+        "X5",
+        "React",
+        "Webpack",
+        "dextsolution",
+        "dextuploadx5",
+        "x5",
+        "react",
+        "webpack"
+    ],
+    "license": "SEE LICENSE IN LICENSE",
+    "homepage": "http://www.dextsolution.com",
+    "files": [
+        "dist/**"
+    ],
+    "main": "./dist/index.cjs",
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.cjs"
+        }
+    },
+    "scripts": {
+        "build": "node ./build.mjs",
+        "build:debug": "node ./build.mjs --sourcemap",
+        "clean": "rimraf dist",
+        "pack": "npm run clean && npm run build && npm pack --pack-destination ../distribution"
+    },
+    "dependencies": {
+        "copy-webpack-plugin": "^14.0.0"
+    },
+    "peerDependencies": {
+        "dextuploadx5-react": ">=0.0.1",
+        "webpack": ">=5"
+    },
+    "devDependencies": {
+        "rimraf": "^6.0.1",
+        "terser": "^5.43.1"
+    }
+}