@nestia/editor 14.0.1 → 14.0.3

package/dist/index.html

@@ -6,7 +6,7 @@
       content="width=device-width, height=device-height, initial-scale=1, minimum-scale=1.0, maximum-scale=3.0s"
     />
     <title>Nestia Editor</title>
-    <script type="module"  src="./assets/index-5lpEeH1X.js"></script>
+    <script type="module"  src="./assets/index-DIkEkcTz.js"></script>
   </head>
   <body style="width: 100%; height: 100%; margin: 0px; overflow: hidden;">
     <div id="root" style="width: 100%; height: 100%"></div>

package/lib/NestiaEditorApplication.d.ts

@@ -1 +1,11 @@
+/**
+ * The static editor page: converts an OpenAPI document into a downloadable project.
+ *
+ * The page reads its settings from the query string (`url`, `mode`, `package`, `keyword`, `simulate`, `e2e`) and from `window` globals the served `index.html` sets. It renders the iframe flow when a document location is given, or when `swagger.json` or `swagger.yaml` is served beside the page, and the uploader otherwise. The `uploader` query key forces the uploader.
+ *
+ * @evidence contracts/common.md#principled-implementation An explicit query URL is forwarded to the iframe, which loads it and reports a fetch error. Without one, swagger.json and then swagger.yaml are probed for HTTP 200; absent or failed lookup falls back to the uploader. Parsed generation options, including keyword, are passed to the iframe rather than replaced by its direct-component defaults.
+ * @evidence contracts/common.md#clear-and-simple-design One component chooses between two existing components; the query and probing logic stays in the private `getAsset` and `findSwagger`, and option parsing lives in one place.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The package name default comes from the shared constant, and no document name, host, or fixture is special-cased; booleans accept only `true` and `1`, as the query contract states.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the page does, where each setting comes from, the lookup order, and the `uploader` override.
+ */
 export declare function NestiaEditorApplication(): import("react/jsx-runtime").JSX.Element;

package/lib/NestiaEditorApplication.js

@@ -17,7 +17,18 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const material_1 = require("@mui/material");
 const react_1 = __importDefault(require("react"));
 const NestiaEditorIframe_1 = require("./NestiaEditorIframe");
+const NestiaEditorDefaultPackage_1 = require("./internal/NestiaEditorDefaultPackage");
 const NestiaEditorUploader_1 = require("./NestiaEditorUploader");
+/**
+ * The static editor page: converts an OpenAPI document into a downloadable project.
+ *
+ * The page reads its settings from the query string (`url`, `mode`, `package`, `keyword`, `simulate`, `e2e`) and from `window` globals the served `index.html` sets. It renders the iframe flow when a document location is given, or when `swagger.json` or `swagger.yaml` is served beside the page, and the uploader otherwise. The `uploader` query key forces the uploader.
+ *
+ * @evidence contracts/common.md#principled-implementation An explicit query URL is forwarded to the iframe, which loads it and reports a fetch error. Without one, swagger.json and then swagger.yaml are probed for HTTP 200; absent or failed lookup falls back to the uploader. Parsed generation options, including keyword, are passed to the iframe rather than replaced by its direct-component defaults.
+ * @evidence contracts/common.md#clear-and-simple-design One component chooses between two existing components; the query and probing logic stays in the private `getAsset` and `findSwagger`, and option parsing lives in one place.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The package name default comes from the shared constant, and no document name, host, or fixture is special-cased; booleans accept only `true` and `1`, as the query contract states.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the page does, where each setting comes from, the lookup order, and the `uploader` override.
+ */
 function NestiaEditorApplication() {
     const [ready, setReady] = react_1.default.useState(false);
     const [asset, setAsset] = react_1.default.useState(null);
@@ -34,7 +45,7 @@ function NestiaEditorApplication() {
     }, []);
     if (ready === false)
         return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, {});
-    return asset !== null ? ((0, jsx_runtime_1.jsx)(NestiaEditorIframe_1.NestiaEditorIframe, { swagger: asset.url, package: asset.package, simulate: asset.simulate, e2e: asset.e2e, mode: asset.mode })) : ((0, jsx_runtime_1.jsxs)("div", { style: {
+    return asset !== null ? ((0, jsx_runtime_1.jsx)(NestiaEditorIframe_1.NestiaEditorIframe, { swagger: asset.url, package: asset.package, keyword: asset.keyword, simulate: asset.simulate, e2e: asset.e2e, mode: asset.mode })) : ((0, jsx_runtime_1.jsxs)("div", { style: {
             padding: 25,
         }, children: [(0, jsx_runtime_1.jsx)(material_1.Typography, { variant: "h4", children: "Nestia Editor" }), (0, jsx_runtime_1.jsx)("hr", {}), (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)(NestiaEditorUploader_1.NestiaEditorUploader, {})] }));
 }
@@ -55,7 +66,7 @@ function getAsset() {
         const e2e = (_f = query.get("e2e")) !== null && _f !== void 0 ? _f : window.e2e;
         return {
             mode: mode === "nest" ? "nest" : "sdk",
-            package: packageName !== null && packageName !== void 0 ? packageName : "@ORGANIZATION/PROJECT",
+            package: packageName !== null && packageName !== void 0 ? packageName : NestiaEditorDefaultPackage_1.NESTIA_EDITOR_DEFAULT_PACKAGE,
             url,
             keyword: keyword !== null
                 ? keyword === true || keyword === "true" || keyword === "1"
@@ -69,8 +80,13 @@ function getAsset() {
 }
 function findSwagger(file) {
     return __awaiter(this, void 0, void 0, function* () {
-        const response = yield fetch(file);
-        return response.status === 200 ? file : null;
+        try {
+            const response = yield fetch(file);
+            return response.status === 200 ? file : null;
+        }
+        catch (_a) {
+            return null;
+        }
     });
 }
 //# sourceMappingURL=NestiaEditorApplication.js.map

package/lib/NestiaEditorApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaEditorApplication.js","sourceRoot":"","sources":["../src/NestiaEditorApplication.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaEditorApplication.js","sourceRoot":"","sources":["../src/NestiaEditorApplication.tsx"],"names":[],"mappings":"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"}

package/lib/NestiaEditorApplication.mjs

@@ -1,9 +1,20 @@
+import "./internal/NestiaEditorDefaultPackage.mjs";
 import { NestiaEditorIframe } from "./NestiaEditorIframe.mjs";
 import { NestiaEditorUploader } from "./NestiaEditorUploader.mjs";
 import { Typography } from "@mui/material";
 import React from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/NestiaEditorApplication.tsx
+/**
+* The static editor page: converts an OpenAPI document into a downloadable project.
+*
+* The page reads its settings from the query string (`url`, `mode`, `package`, `keyword`, `simulate`, `e2e`) and from `window` globals the served `index.html` sets. It renders the iframe flow when a document location is given, or when `swagger.json` or `swagger.yaml` is served beside the page, and the uploader otherwise. The `uploader` query key forces the uploader.
+*
+* @evidence contracts/common.md#principled-implementation An explicit query URL is forwarded to the iframe, which loads it and reports a fetch error. Without one, swagger.json and then swagger.yaml are probed for HTTP 200; absent or failed lookup falls back to the uploader. Parsed generation options, including keyword, are passed to the iframe rather than replaced by its direct-component defaults.
+* @evidence contracts/common.md#clear-and-simple-design One component chooses between two existing components; the query and probing logic stays in the private `getAsset` and `findSwagger`, and option parsing lives in one place.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The package name default comes from the shared constant, and no document name, host, or fixture is special-cased; booleans accept only `true` and `1`, as the query contract states.
+* @evidence contracts/common.md#meaningful-documentation The comment states what the page does, where each setting comes from, the lookup order, and the `uploader` override.
+*/
 function NestiaEditorApplication() {
 	const [ready, setReady] = React.useState(false);
 	const [asset, setAsset] = React.useState(null);
@@ -21,6 +32,7 @@ function NestiaEditorApplication() {
 	return asset !== null ? /* @__PURE__ */ jsx(NestiaEditorIframe, {
 		swagger: asset.url,
 		package: asset.package,
+		keyword: asset.keyword,
 		simulate: asset.simulate,
 		e2e: asset.e2e,
 		mode: asset.mode
@@ -58,7 +70,11 @@ async function getAsset() {
 	};
 }
 async function findSwagger(file) {
-	return (await fetch(file)).status === 200 ? file : null;
+	try {
+		return (await fetch(file)).status === 200 ? file : null;
+	} catch {
+		return null;
+	}
 }
 //#endregion
 export { NestiaEditorApplication };

package/lib/NestiaEditorIframe.d.ts

@@ -1,11 +1,42 @@
 import { OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
+/**
+ * Composes a project from an OpenAPI document and offers it as a zip download.
+ *
+ * The component loads the document, from a URL or from the object given,
+ * generates the project in the browser, and shows the three stages as a
+ * stepper. A fetch failure or a composition failure is reported in place of the
+ * stage's progress, and the operations the composer could not convert are
+ * listed beside the download, so an incomplete project never passes for a
+ * complete one.
+ *
+ * @evidence contracts/common.md#principled-implementation The three stages run once, in order, from an effect: load the document, compose it with NestiaEditorComposer, and expose the files for download. Document-loading and composer failure results set their stage error states. Operations the composer skipped are listed with the download. Unexpected errors outside these operations are logged by the outer catch without setting an error state; only completed stages advance the stepper.
+ * @evidence contracts/common.md#clear-and-simple-design One component owns the stepper state; document loading and operation counting stay in the private `getDocument` and `aggregateOperation`, and archiving and composition are delegated to their own namespaces.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The option defaults (keyword, simulate, e2e enabled) are the documented product defaults, and the archive name comes from the shared default package constant, not from a fixture name.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the stages and how failures appear.
+ */
 export declare function NestiaEditorIframe(props: NestiaEditorIframe.IProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Properties of {@link NestiaEditorIframe}.
+ *
+ * `swagger` is an OpenAPI document or the URL to fetch it from. The options
+ * mirror the generator options; `mode` is internal.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace holds the property type of the component with the same name, so the component and its inputs are one public identity.
+ * @evidence contracts/common.md#clear-and-simple-design It contains one interface and nothing else.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It adds no behavior; the option defaults live in the component that reads them.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what `swagger` accepts and which members are internal.
+ */
 export declare namespace NestiaEditorIframe {
     interface IProps {
+        /** Source document or URL loaded once when this component mounts. */
         swagger: string | SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument;
+        /** Generated package identity; defaults to @ORGANIZATION/PROJECT. */
         package?: string;
+        /** Enable keyword parameter objects; enabled when omitted. */
         keyword?: boolean;
+        /** Include SDK simulators; enabled when omitted. */
         simulate?: boolean;
+        /** Include generated E2E functions; enabled when omitted. */
         e2e?: boolean;
     }
 }

package/lib/NestiaEditorIframe.js

@@ -19,6 +19,22 @@ const js_yaml_1 = require("js-yaml");
 const react_1 = __importDefault(require("react"));
 const NestiaEditorArchiver_1 = require("./internal/NestiaEditorArchiver");
 const NestiaEditorComposer_1 = require("./internal/NestiaEditorComposer");
+const NestiaEditorDefaultPackage_1 = require("./internal/NestiaEditorDefaultPackage");
+/**
+ * Composes a project from an OpenAPI document and offers it as a zip download.
+ *
+ * The component loads the document, from a URL or from the object given,
+ * generates the project in the browser, and shows the three stages as a
+ * stepper. A fetch failure or a composition failure is reported in place of the
+ * stage's progress, and the operations the composer could not convert are
+ * listed beside the download, so an incomplete project never passes for a
+ * complete one.
+ *
+ * @evidence contracts/common.md#principled-implementation The three stages run once, in order, from an effect: load the document, compose it with NestiaEditorComposer, and expose the files for download. Document-loading and composer failure results set their stage error states. Operations the composer skipped are listed with the download. Unexpected errors outside these operations are logged by the outer catch without setting an error state; only completed stages advance the stepper.
+ * @evidence contracts/common.md#clear-and-simple-design One component owns the stepper state; document loading and operation counting stay in the private `getDocument` and `aggregateOperation`, and archiving and composition are delegated to their own namespaces.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The option defaults (keyword, simulate, e2e enabled) are the documented product defaults, and the archive name comes from the shared default package constant, not from a fixture name.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the stages and how failures appear.
+ */
 function NestiaEditorIframe(props) {
     var _a;
     const [step, setStep] = react_1.default.useState(0);
@@ -26,7 +42,8 @@ function NestiaEditorIframe(props) {
     const [operations, setOperationCount] = react_1.default.useState({});
     const [composerError, setComposerError] = react_1.default.useState(null);
     const [files, setFiles] = react_1.default.useState(null);
-    const archive = NestiaEditorArchiver_1.NestiaEditorArchiver.name((_a = props.package) !== null && _a !== void 0 ? _a : "@ORGANIZATION/PROJECT");
+    const [skipped, setSkipped] = react_1.default.useState([]);
+    const archive = NestiaEditorArchiver_1.NestiaEditorArchiver.name((_a = props.package) !== null && _a !== void 0 ? _a : NestiaEditorDefaultPackage_1.NESTIA_EDITOR_DEFAULT_PACKAGE);
     react_1.default.useEffect(() => {
         (() => __awaiter(this, void 0, void 0, function* () {
             // LOADING OPENAPI DOCUMENTS
@@ -50,7 +67,7 @@ function NestiaEditorIframe(props) {
                         keyword: (_b = props.keyword) !== null && _b !== void 0 ? _b : true,
                         simulate: (_c = props.simulate) !== null && _c !== void 0 ? _c : true,
                         e2e: (_d = props.e2e) !== null && _d !== void 0 ? _d : true,
-                        package: (_e = props.package) !== null && _e !== void 0 ? _e : "@ORGANIZATION/PROJECT",
+                        package: (_e = props.package) !== null && _e !== void 0 ? _e : NestiaEditorDefaultPackage_1.NESTIA_EDITOR_DEFAULT_PACKAGE,
                     });
                 }
                 catch (exp) {
@@ -67,6 +84,7 @@ function NestiaEditorIframe(props) {
             }
             // READY TO DOWNLOAD
             setStep(2);
+            setSkipped(result.data.skipped);
             setFiles(result.data.files);
         }))().catch((exp) => {
             console.error("unknown error", exp);
@@ -81,10 +99,10 @@ function NestiaEditorIframe(props) {
                 overflow: "auto",
             }, children: [(0, jsx_runtime_1.jsx)(material_1.Typography, { variant: "h4", children: "Nestia Editor" }), (0, jsx_runtime_1.jsx)("hr", {}), (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsxs)(material_1.Stepper, { activeStep: step, orientation: "vertical", nonLinear: true, children: [(0, jsx_runtime_1.jsxs)(material_1.Step, { children: [(0, jsx_runtime_1.jsx)(material_1.StepLabel, { children: (0, jsx_runtime_1.jsx)(material_1.Typography, { variant: "h5", children: "Loading OpenAPI Document" }) }), (0, jsx_runtime_1.jsxs)(material_1.StepContent, { children: [(0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)(material_1.CircularProgress, { size: 100, color: "success" }), (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)("br", {}), typeof props.swagger === "string" ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("p", { children: "Fetching OpenAPI Document from" }), (0, jsx_runtime_1.jsx)("p", { children: (0, jsx_runtime_1.jsx)("a", { href: props.swagger, target: "_blank", children: props.swagger }) })] })) : ("Delivering OpenAPI Document to the composer"), fetchError !== null ? ((0, jsx_runtime_1.jsxs)(material_1.Alert, { severity: "error", children: [(0, jsx_runtime_1.jsx)(material_1.AlertTitle, { children: "Fetch Error" }), fetchError] })) : null] })] }, 0), (0, jsx_runtime_1.jsxs)(material_1.Step, { children: [(0, jsx_runtime_1.jsx)(material_1.StepLabel, { children: (0, jsx_runtime_1.jsx)(material_1.Typography, { variant: "h5", children: "Generating Software Development Kit" }) }), (0, jsx_runtime_1.jsxs)(material_1.StepContent, { children: [(0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)(material_1.CircularProgress, { size: 100, color: "success" }), (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)("br", {}), "Generating SDK functions...", (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsxs)("ul", { children: [(0, jsx_runtime_1.jsxs)("li", { children: ["total operations: #", Object.values(operations)
                                                             .reduce((a, b) => a + b, 0)
-                                                            .toLocaleString()] }), Object.entries(operations).map(([method, count]) => ((0, jsx_runtime_1.jsxs)("li", { children: [method, ": #", count.toLocaleString()] })))] }), composerError !== null ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsxs)(material_1.Alert, { severity: "error", children: [(0, jsx_runtime_1.jsx)(material_1.AlertTitle, { children: "Composition Error" }), (0, jsx_runtime_1.jsx)("pre", { children: JSON.stringify(composerError, null, 2) })] })] })) : null] })] }, 1), (0, jsx_runtime_1.jsxs)(material_1.Step, { children: [(0, jsx_runtime_1.jsx)(material_1.StepLabel, { children: (0, jsx_runtime_1.jsx)(material_1.Typography, { variant: "h5", children: "Downloading TypeScript Project" }) }), (0, jsx_runtime_1.jsxs)(material_1.StepContent, { children: [(0, jsx_runtime_1.jsx)("br", {}), files !== null ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("p", { children: [Object.keys(files).length.toLocaleString(), " files are ready."] }), (0, jsx_runtime_1.jsxs)(material_1.Button, { variant: "contained", color: "success", size: "large", onClick: () => NestiaEditorArchiver_1.NestiaEditorArchiver.download({
+                                                            .toLocaleString()] }), Object.entries(operations).map(([method, count]) => ((0, jsx_runtime_1.jsxs)("li", { children: [method, ": #", count.toLocaleString()] }, method)))] }), composerError !== null ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsxs)(material_1.Alert, { severity: "error", children: [(0, jsx_runtime_1.jsx)(material_1.AlertTitle, { children: "Composition Error" }), (0, jsx_runtime_1.jsx)("pre", { children: JSON.stringify(composerError, null, 2) })] })] })) : null] })] }, 1), (0, jsx_runtime_1.jsxs)(material_1.Step, { children: [(0, jsx_runtime_1.jsx)(material_1.StepLabel, { children: (0, jsx_runtime_1.jsx)(material_1.Typography, { variant: "h5", children: "Downloading TypeScript Project" }) }), (0, jsx_runtime_1.jsxs)(material_1.StepContent, { children: [(0, jsx_runtime_1.jsx)("br", {}), files !== null ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("p", { children: [Object.keys(files).length.toLocaleString(), " files are ready."] }), (0, jsx_runtime_1.jsxs)(material_1.Button, { variant: "contained", color: "success", size: "large", onClick: () => NestiaEditorArchiver_1.NestiaEditorArchiver.download({
                                                         name: archive,
                                                         files,
-                                                    }), children: ["Download ", archive] })] })) : null] })] }, 2)] })] }) }));
+                                                    }), children: ["Download ", archive] }), skipped.length !== 0 ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsx)("br", {}), (0, jsx_runtime_1.jsxs)(material_1.Alert, { severity: "warning", children: [(0, jsx_runtime_1.jsx)(material_1.AlertTitle, { children: "Skipped Operations" }), "The project leaves out operations that could not be converted:", (0, jsx_runtime_1.jsx)("ul", { children: skipped.map((s) => ((0, jsx_runtime_1.jsxs)("li", { children: [s.method, " ", s.path, ": ", s.messages.join(" ")] }, `${s.method} ${s.path}`))) })] })] })) : null] })) : null] })] }, 2)] })] }) }));
 }
 const getDocument = (url) => __awaiter(void 0, void 0, void 0, function* () {
     try {

package/lib/NestiaEditorIframe.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaEditorIframe.js","sourceRoot":"","sources":["../src/NestiaEditorIframe.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaEditorIframe.js","sourceRoot":"","sources":["../src/NestiaEditorIframe.tsx"],"names":[],"mappings":"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"}

package/lib/NestiaEditorIframe.mjs

@@ -1,3 +1,4 @@
+import "./internal/NestiaEditorDefaultPackage.mjs";
 import { NestiaEditorArchiver } from "./internal/NestiaEditorArchiver.mjs";
 import { NestiaEditorComposer } from "./internal/NestiaEditorComposer.mjs";
 import { Alert, AlertTitle, Button, CircularProgress, Step, StepContent, StepLabel, Stepper, Typography } from "@mui/material";
@@ -5,12 +6,28 @@ import React from "react";
 import { load } from "js-yaml";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/NestiaEditorIframe.tsx
+/**
+* Composes a project from an OpenAPI document and offers it as a zip download.
+*
+* The component loads the document, from a URL or from the object given,
+* generates the project in the browser, and shows the three stages as a
+* stepper. A fetch failure or a composition failure is reported in place of the
+* stage's progress, and the operations the composer could not convert are
+* listed beside the download, so an incomplete project never passes for a
+* complete one.
+*
+* @evidence contracts/common.md#principled-implementation The three stages run once, in order, from an effect: load the document, compose it with NestiaEditorComposer, and expose the files for download. Document-loading and composer failure results set their stage error states. Operations the composer skipped are listed with the download. Unexpected errors outside these operations are logged by the outer catch without setting an error state; only completed stages advance the stepper.
+* @evidence contracts/common.md#clear-and-simple-design One component owns the stepper state; document loading and operation counting stay in the private `getDocument` and `aggregateOperation`, and archiving and composition are delegated to their own namespaces.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The option defaults (keyword, simulate, e2e enabled) are the documented product defaults, and the archive name comes from the shared default package constant, not from a fixture name.
+* @evidence contracts/common.md#meaningful-documentation The comment states the stages and how failures appear.
+*/
 function NestiaEditorIframe(props) {
 	const [step, setStep] = React.useState(0);
 	const [fetchError, setFetchError] = React.useState(null);
 	const [operations, setOperationCount] = React.useState({});
 	const [composerError, setComposerError] = React.useState(null);
 	const [files, setFiles] = React.useState(null);
+	const [skipped, setSkipped] = React.useState([]);
 	const archive = NestiaEditorArchiver.name(props.package ?? "@ORGANIZATION/PROJECT");
 	React.useEffect(() => {
 		(async () => {
@@ -43,6 +60,7 @@ function NestiaEditorIframe(props) {
 				return;
 			}
 			setStep(2);
+			setSkipped(result.data.skipped);
 			setFiles(result.data.files);
 		})().catch((exp) => {
 			console.error("unknown error", exp);
@@ -109,7 +127,7 @@ function NestiaEditorIframe(props) {
 								method,
 								": #",
 								count.toLocaleString()
-							] }))] }),
+							] }, method))] }),
 							composerError !== null ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("br", {}), /* @__PURE__ */ jsxs(Alert, {
 								severity: "error",
 								children: [/* @__PURE__ */ jsx(AlertTitle, { children: "Composition Error" }), /* @__PURE__ */ jsx("pre", { children: JSON.stringify(composerError, null, 2) })]
@@ -118,16 +136,37 @@ function NestiaEditorIframe(props) {
 						/* @__PURE__ */ jsxs(Step, { children: [/* @__PURE__ */ jsx(StepLabel, { children: /* @__PURE__ */ jsx(Typography, {
 							variant: "h5",
 							children: "Downloading TypeScript Project"
-						}) }), /* @__PURE__ */ jsxs(StepContent, { children: [/* @__PURE__ */ jsx("br", {}), files !== null ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("p", { children: [Object.keys(files).length.toLocaleString(), " files are ready."] }), /* @__PURE__ */ jsxs(Button, {
-							variant: "contained",
-							color: "success",
-							size: "large",
-							onClick: () => NestiaEditorArchiver.download({
-								name: archive,
-								files
+						}) }), /* @__PURE__ */ jsxs(StepContent, { children: [/* @__PURE__ */ jsx("br", {}), files !== null ? /* @__PURE__ */ jsxs(Fragment, { children: [
+							/* @__PURE__ */ jsxs("p", { children: [Object.keys(files).length.toLocaleString(), " files are ready."] }),
+							/* @__PURE__ */ jsxs(Button, {
+								variant: "contained",
+								color: "success",
+								size: "large",
+								onClick: () => NestiaEditorArchiver.download({
+									name: archive,
+									files
+								}),
+								children: ["Download ", archive]
 							}),
-							children: ["Download ", archive]
-						})] }) : null] })] }, 2)
+							skipped.length !== 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+								/* @__PURE__ */ jsx("br", {}),
+								/* @__PURE__ */ jsx("br", {}),
+								/* @__PURE__ */ jsxs(Alert, {
+									severity: "warning",
+									children: [
+										/* @__PURE__ */ jsx(AlertTitle, { children: "Skipped Operations" }),
+										"The project leaves out operations that could not be converted:",
+										/* @__PURE__ */ jsx("ul", { children: skipped.map((s) => /* @__PURE__ */ jsxs("li", { children: [
+											s.method,
+											" ",
+											s.path,
+											": ",
+											s.messages.join(" ")
+										] }, `${s.method} ${s.path}`)) })
+									]
+								})
+							] }) : null
+						] }) : null] })] }, 2)
 					]
 				})
 			]

package/lib/NestiaEditorModule.d.ts

@@ -1,5 +1,51 @@
 import type { OpenApiV3, OpenApiV3_1, OpenApiV3_2, SwaggerV2 } from "@typia/interface";
+/**
+ * Serves the editor from a NestJS application.
+ *
+ * Call {@link setup} before `listen()` to expose the editor page, its bundle,
+ * and the OpenAPI document under a path of the application.
+ *
+ * @evidence contracts/common.md#principled-implementation The module registers static routes on the application's own HTTP adapter, so the editor needs no second server.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with one entry point; asset reading and location resolution stay in module-private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The routes use the adapter's public `get` method, and the one read of NestJS internals is the global prefix, described at `setup`.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the entry point and that it must run before `listen()`.
+ */
 export declare namespace NestiaEditorModule {
+    /**
+     * Registers the editor routes on a NestJS application.
+     *
+     * The routes are `<prefix>/index.html`, the bundle under `<prefix>/assets/`,
+     * `<prefix>/swagger.json`, and redirects from `<prefix>` and `<prefix>/` to
+     * the page, where the prefix joins the application's global prefix and
+     * `path`. A document given as an object is served as is. A document given by
+     * location is fetched on the first request, after `listen()`, because a path
+     * is resolved against the address the application listens on, and the fetched
+     * document is cached; a failed fetch answers 502 and is not cached.
+     *
+     * Setup reads each page-referenced JavaScript asset once. Static setup work
+     * scales with page and asset bytes; later requests reuse the registered
+     * strings. A location-based document is fetched and serialized on demand.
+     *
+     * Each Swagger route shares one successful serialized document and one
+     * in-flight fetch. A failed fetch clears the pending promise so later
+     * requests can try again. The location and document remain fixed for that
+     * registration.
+     *
+     * The application adapter owns the registered closures and their strings for
+     * the route lifetime. Setup creates no process-global history. This API
+     * supplies no fetch cancellation or timeout, so an unresolved request remains
+     * pending until its transport settles.
+     *
+     * Built assets use Node filesystem APIs and native path joining from the
+     * installed module directory. Page script URLs are validated independently
+     * from filesystem paths. Swagger locations use URL resolution against
+     * application.getUrl.
+     *
+     * @evidence contracts/common.md#principled-implementation The prefix is built by joining the global prefix and the path and dropping empty segments, so slashes never double; the static files are read once at setup, and the swagger route is lazy for a location because the listening address, which relative locations need, does not exist before `listen()`.
+     * @evidence contracts/common.md#clear-and-simple-design One function performs the registration; reading the built page and bundle, reading the global prefix, and resolving a location are separate module-private helpers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts NestJS exposes no public getter for the global prefix, so `getGlobalPrefix` reads the internal `config.globalPrefix` and falls back to an empty prefix when it is absent; this is the single foreign-internal read, kept as a stated limitation rather than replaced by a shadow copy of the prefix.
+     * @evidence contracts/common.md#meaningful-documentation The comment lists the routes and prefix rule, explains setup versus request-time work and cached-document ownership, and states the absent timeout/cancellation limitation.
+     */
     const setup: (props: {
         path: string;
         application: INestApplication;

package/lib/NestiaEditorModule.js

@@ -41,26 +41,78 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaEditorModule = void 0;
 const fs = __importStar(require("fs"));
+const path_1 = __importDefault(require("path"));
+const NestiaEditorDefaultPackage_1 = require("./internal/NestiaEditorDefaultPackage");
+/**
+ * Serves the editor from a NestJS application.
+ *
+ * Call {@link setup} before `listen()` to expose the editor page, its bundle,
+ * and the OpenAPI document under a path of the application.
+ *
+ * @evidence contracts/common.md#principled-implementation The module registers static routes on the application's own HTTP adapter, so the editor needs no second server.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with one entry point; asset reading and location resolution stay in module-private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The routes use the adapter's public `get` method, and the one read of NestJS internals is the global prefix, described at `setup`.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the entry point and that it must run before `listen()`.
+ */
 var NestiaEditorModule;
 (function (NestiaEditorModule) {
+    /**
+     * Registers the editor routes on a NestJS application.
+     *
+     * The routes are `<prefix>/index.html`, the bundle under `<prefix>/assets/`,
+     * `<prefix>/swagger.json`, and redirects from `<prefix>` and `<prefix>/` to
+     * the page, where the prefix joins the application's global prefix and
+     * `path`. A document given as an object is served as is. A document given by
+     * location is fetched on the first request, after `listen()`, because a path
+     * is resolved against the address the application listens on, and the fetched
+     * document is cached; a failed fetch answers 502 and is not cached.
+     *
+     * Setup reads each page-referenced JavaScript asset once. Static setup work
+     * scales with page and asset bytes; later requests reuse the registered
+     * strings. A location-based document is fetched and serialized on demand.
+     *
+     * Each Swagger route shares one successful serialized document and one
+     * in-flight fetch. A failed fetch clears the pending promise so later
+     * requests can try again. The location and document remain fixed for that
+     * registration.
+     *
+     * The application adapter owns the registered closures and their strings for
+     * the route lifetime. Setup creates no process-global history. This API
+     * supplies no fetch cancellation or timeout, so an unresolved request remains
+     * pending until its transport settles.
+     *
+     * Built assets use Node filesystem APIs and native path joining from the
+     * installed module directory. Page script URLs are validated independently
+     * from filesystem paths. Swagger locations use URL resolution against
+     * application.getUrl.
+     *
+     * @evidence contracts/common.md#principled-implementation The prefix is built by joining the global prefix and the path and dropping empty segments, so slashes never double; the static files are read once at setup, and the swagger route is lazy for a location because the listening address, which relative locations need, does not exist before `listen()`.
+     * @evidence contracts/common.md#clear-and-simple-design One function performs the registration; reading the built page and bundle, reading the global prefix, and resolving a location are separate module-private helpers.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts NestJS exposes no public getter for the global prefix, so `getGlobalPrefix` reads the internal `config.globalPrefix` and falls back to an empty prefix when it is absent; this is the single foreign-internal read, kept as a stated limitation rather than replaced by a shadow copy of the prefix.
+     * @evidence contracts/common.md#meaningful-documentation The comment lists the routes and prefix rule, explains setup versus request-time work and cached-document ownership, and states the absent timeout/cancellation limitation.
+     */
     NestiaEditorModule.setup = (props) => __awaiter(this, void 0, void 0, function* () {
-        const prefix = "/" +
-            [getGlobalPrefix(props.application), props.path]
-                .join("/")
-                .split("/")
-                .filter((str) => str.length !== 0)
-                .join("/");
+        const prefix = [getGlobalPrefix(props.application), props.path]
+            .join("/")
+            .split("/")
+            .filter((str) => str.length !== 0)
+            .map((str) => "/" + str)
+            .join("");
         const adaptor = props.application.getHttpAdapter();
+        const index = yield getIndex(props);
         const staticFiles = [
             {
                 path: "/index.html",
                 type: "text/html",
-                content: yield getIndex(props),
+                content: index,
             },
-            yield getJavaScript(),
+            ...(yield getJavaScripts(index)),
         ];
         for (const f of staticFiles) {
             adaptor.get(prefix + f.path, (_, res) => {
@@ -75,9 +127,17 @@ var NestiaEditorModule;
         let document = typeof props.swagger === "string"
             ? null
             : JSON.stringify(props.swagger, null, 2);
+        let pending = null;
         adaptor.get(prefix + "/swagger.json", (_, res) => __awaiter(this, void 0, void 0, function* () {
             try {
-                document !== null && document !== void 0 ? document : (document = JSON.stringify(yield getSwagger(yield resolveLocation(props.application, props.swagger)), null, 2));
+                if (document === null) {
+                    pending !== null && pending !== void 0 ? pending : (pending = (() => __awaiter(this, void 0, void 0, function* () {
+                        return JSON.stringify(yield getSwagger(yield resolveLocation(props.application, props.swagger)), null, 2);
+                    }))().finally(() => {
+                        pending = null;
+                    }));
+                    document = yield pending;
+                }
             }
             catch (error) {
                 res.status(502);
@@ -87,7 +147,7 @@ var NestiaEditorModule;
             res.type("application/json");
             return res.send(document);
         }));
-        for (const p of ["", "/"])
+        for (const p of prefix.length === 0 ? ["/"] : ["", "/"])
             adaptor.get(prefix + p, (_, res) => {
                 return res.redirect(prefix + "/index.html");
             });
@@ -97,23 +157,35 @@ var NestiaEditorModule;
         : ""; };
 })(NestiaEditorModule || (exports.NestiaEditorModule = NestiaEditorModule = {}));
 const getIndex = (props) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a;
     const content = yield fs.promises.readFile(`${__dirname}/../dist/index.html`, "utf8");
+    // Replacement functions, because a replacement string would read its dollar
+    // patterns, which a package name may legitimately contain.
     return content
-        .replace(`"@ORGANIZATION/PROJECT"`, JSON.stringify((_a = props.package) !== null && _a !== void 0 ? _a : "@ORGANIZATION/PROJECT"))
-        .replace("window.simulate = false", `window.simulate = ${!!props.simulate}`)
-        .replace("window.e2e = false", `window.e2e = ${!!props.e2e}`);
+        .replace(JSON.stringify(NestiaEditorDefaultPackage_1.NESTIA_EDITOR_DEFAULT_PACKAGE), () => { var _a; return JSON.stringify((_a = props.package) !== null && _a !== void 0 ? _a : NestiaEditorDefaultPackage_1.NESTIA_EDITOR_DEFAULT_PACKAGE); })
+        .replace("window.simulate = false", () => `window.simulate = ${!!props.simulate}`)
+        .replace("window.e2e = false", () => `window.e2e = ${!!props.e2e}`);
 });
-const getJavaScript = () => __awaiter(void 0, void 0, void 0, function* () {
-    const directory = yield fs.promises.readdir(`${__dirname}/../dist/assets`);
-    const path = directory[0];
-    if (path === undefined)
-        throw new Error("Unreachable code, no JS file exists.");
-    return {
-        path: `/assets/${path}`,
-        type: "application/javascript",
-        content: yield fs.promises.readFile(`${__dirname}/../dist/assets/${path}`, "utf8"),
-    };
+const getJavaScripts = (index) => __awaiter(void 0, void 0, void 0, function* () {
+    const scripts = new Set();
+    for (const match of index.matchAll(/<script\b[^>]*\bsrc\s*=\s*(["'])(.*?)\1[^>]*>/gi)) {
+        const url = new URL(match[2], "https://nestia.invalid/");
+        if (url.origin !== "https://nestia.invalid" ||
+            url.pathname.startsWith("/assets/") === false ||
+            url.pathname.endsWith(".js") === false ||
+            url.search.length !== 0 ||
+            url.hash.length !== 0)
+            throw new Error(`Unsupported editor script asset: ${match[2]}`);
+        scripts.add(url.pathname);
+    }
+    if (scripts.size === 0)
+        throw new Error("The editor page references no JavaScript asset.");
+    return Promise.all([...scripts].map((asset) => __awaiter(void 0, void 0, void 0, function* () {
+        return ({
+            path: asset,
+            type: "application/javascript",
+            content: yield fs.promises.readFile(path_1.default.join(__dirname, "../dist", asset.slice(1)), "utf8"),
+        });
+    })));
 });
 /** An absolute URL as is; a path of the application at its own address. */
 const resolveLocation = (application, location) => __awaiter(void 0, void 0, void 0, function* () {