@upendra19/swagger-ui-custom 1.0.0

package/.agignore

@@ -0,0 +1 @@
+dist/

package/.browserslistrc

@@ -0,0 +1,29 @@
+[node-production]
+maintained node versions
+
+[node-development]
+node 22
+
+[browser-production]
+> 1%
+last 2 versions
+Firefox ESR
+not dead
+
+[browser-development]
+last 1 chrome version
+last 1 firefox version
+last 1 safari version
+
+[isomorphic-production]
+> 1%
+last 2 versions
+Firefox ESR
+not dead
+maintained node versions
+
+[isomorphic-development]
+last 1 chrome version
+last 1 firefox version
+last 1 safari version
+node 22

package/.dockerignore

@@ -0,0 +1,8 @@
+/.git
+/.github
+/dev-helpers
+/docs
+/src
+/swagger-ui-dist-package
+/test
+/node_modules

package/.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+end_of_line = lf
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+insert_final_newline = true
+[*.md]
+trim_trailing_whitespace = false

package/.eslintrc.js

@@ -0,0 +1,78 @@
+/**
+ * @prettier
+ */
+const path = require("node:path")
+
+module.exports = {
+  parser: "@babel/eslint-parser",
+  env: {
+    browser: true,
+    node: true,
+    es6: true,
+    jest: true,
+    "jest/globals": true,
+  },
+  parserOptions: {
+    ecmaFeatures: { jsx: true },
+    babelOptions: { configFile: path.join(__dirname, "babel.config.js") },
+  },
+  extends: [
+    "eslint:recommended",
+    "plugin:react/recommended",
+    "plugin:prettier/recommended",
+  ],
+  plugins: ["react", "import", "jest", "prettier"],
+  settings: {
+    react: {
+      pragma: "React",
+      version: "15.0",
+    },
+  },
+  rules: {
+    semi: [2, "never"],
+    strict: 0,
+    quotes: [
+      2,
+      "double",
+      {
+        avoidEscape: true,
+        allowTemplateLiterals: true,
+      },
+    ],
+    "no-unused-vars": 2,
+    "no-multi-spaces": 1,
+    camelcase: [
+      "error",
+      {
+        allow: [
+          "^UNSAFE_",
+          "^requestSnippetGenerator_",
+          "^JsonSchema_",
+          "^curl_",
+          "^dom_",
+          "^api_",
+          "^client_",
+          "^grant_",
+          "^code_",
+          "^redirect_",
+          "^spec",
+        ],
+      },
+    ],
+    "no-use-before-define": [2, "nofunc"],
+    "no-underscore-dangle": 0,
+    "no-unused-expressions": 1,
+    "comma-dangle": 0,
+    "no-console": [
+      2,
+      {
+        allow: ["warn", "error"],
+      },
+    ],
+    "react/jsx-no-bind": 1,
+    "react/jsx-no-target-blank": 2,
+    "react/display-name": 0,
+    "import/no-extraneous-dependencies": 2,
+    "react/jsx-filename-extension": 2,
+  },
+}

package/.lintstagedrc

@@ -0,0 +1,4 @@
+{
+  "*.{js,jsx}": ["eslint --max-warnings 0"],
+  "*.scss": ["stylelint '**/*.scss'"]
+}

package/.nvmrc

@@ -0,0 +1 @@
+22.11.0

package/.prettierrc.yaml

@@ -0,0 +1,5 @@
+semi: false
+trailingComma: es5
+endOfLine: lf
+requirePragma: true
+insertPragma: true

package/.releaserc

@@ -0,0 +1,26 @@
+{
+  "branches": [
+    {"name": "master"}
+  ],
+  "tagFormat": "v${version}",
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    [
+      "@semantic-release/exec",
+      {
+        "verifyReleaseCmd": "echo \"NEXT_RELEASE_VERSION=${nextRelease.version}\" >> $GITHUB_ENV"
+      }
+    ],
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/npm",
+    "@semantic-release/github",
+    ["@semantic-release/git", {
+      "assets": [
+        "dist/*.{js,html,css}",
+        "package.json",
+        "package-lock.json"
+      ],
+      "message": "chore(release): cut the ${nextRelease.version} release\n\n${nextRelease.notes}"
+    }]
+  ]
+}

package/AUTHORIZATION_CONFIG.md

@@ -0,0 +1,350 @@
+# Configuration Guide for Swagger UI Customization
+
+## Overview
+Swagger UI now supports configuration-based customization for common UI features. You can control these features via configuration props instead of modifying component code.
+
+## Available Configurations
+
+### 1. Authorization UI Control (`showAuthorization`)
+### 2. Try It Out Button Control (`showTryItOut`)
+### 3. Info Section Links Control (`showInfoLinks`)
+### 4. Operations Accordion Control (`operationsCollapsible`)
+### 5. Operation Utilities Control (`showOperationUtilities`)
+
+---
+
+## 2. Try It Out Button Control
+
+### Configuration: `showTryItOut`
+
+Control whether the "Try it out" button is displayed on API operations.
+
+#### Default Behavior
+By default, `showTryItOut` is set to `true`, which means the "Try it out" button will be displayed.
+
+#### Hiding the Try It Out Button
+
+To hide the "Try it out" button:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Hide "Try it out" button
+  showTryItOut: false
+})
+```
+
+#### Showing the Try It Out Button (Default)
+
+To show the "Try it out" button:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Show "Try it out" button (or just omit this line)
+  showTryItOut: true
+})
+```
+
+### What Changes
+
+When `showTryItOut` is set to `false`:
+- ✅ The "Try it out" button is hidden
+- ✅ Users cannot interact with the API through the UI
+- ✅ Perfect for read-only API documentation
+
+When `showTryItOut` is set to `true` (default):
+- ✅ The "Try it out" button is visible
+- ✅ Users can test API endpoints directly
+- ✅ Interactive API exploration enabled
+
+---
+
+## 3. Info Section Links Control
+
+### Configuration: `showInfoLinks`
+
+Control whether links in the info section are displayed (spec URL, contact, license, terms of service, external docs).
+
+#### Default Behavior
+By default, `showInfoLinks` is set to `true`, which means all info section links will be displayed.
+
+#### Hiding Info Section Links
+
+To hide all links in the info section:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Hide info section links
+  showInfoLinks: false
+})
+```
+
+#### Showing Info Section Links (Default)
+
+To show all links in the info section:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Show info section links (or just omit this line)
+  showInfoLinks: true
+})
+```
+
+### What Changes
+
+When `showInfoLinks` is set to `false`:
+- ✅ Spec URL link is hidden
+- ✅ Contact information links are hidden
+- ✅ License links are hidden
+- ✅ Terms of service link is hidden
+- ✅ External documentation link is hidden
+- ✅ Cleaner, more focused documentation view
+
+When `showInfoLinks` is set to `true` (default):
+- ✅ All info section links are visible
+- ✅ Users can access contact information
+- ✅ Users can view license details
+- ✅ Full API metadata is available
+
+### Use Cases
+
+**Hide links when:**
+- You want a cleaner, minimal documentation view
+- You're embedding Swagger UI and don't want external links
+- You're creating internal documentation without public contact info
+- You want to control where users navigate
+
+**Show links when:**
+- You want users to access full API metadata
+- You want to provide contact and license information
+- You're creating public API documentation
+- Standard Swagger UI behavior is desired
+
+---
+
+## 4. Operations Accordion Control
+
+### Configuration: `operationsCollapsible`
+
+Control whether API operations can be collapsed/expanded (accordion behavior).
+
+#### Default Behavior
+By default, `operationsCollapsible` is set to `true`, which means operations can be collapsed and expanded (standard accordion behavior).
+
+#### Keeping Operations Always Expanded
+
+To keep all operations always expanded and disable the accordion functionality:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Keep operations always expanded
+  operationsCollapsible: false
+})
+```
+
+#### Enabling Accordion Behavior (Default)
+
+To allow users to collapse/expand operations:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Enable accordion (or just omit this line)
+  operationsCollapsible: true
+})
+```
+
+### What Changes
+
+When `operationsCollapsible` is set to `false`:
+- ✅ All operations are always shown expanded
+- ✅ Arrow buttons (up/down) are hidden
+- ✅ Clicking on operation headers does nothing
+- ✅ Users can see all operation details immediately
+
+When `operationsCollapsible` is set to `true` (default):
+- ✅ Operations can be collapsed/expanded
+- ✅ Arrow buttons are visible
+- ✅ Clicking toggles the operation details
+- ✅ Standard accordion behavior
+
+---
+
+## 1. Authorization UI Control
+
+### Configuration: `showAuthorization`
+
+Control whether authorization UI elements (Authorize button and lock icons) are displayed.
+
+## Configuration
+
+### Default Behavior
+By default, `showAuthorization` is set to `true`, which means the authorization UI will be displayed (backward compatible).
+
+### Hiding Authorization UI
+
+To hide the Authorize button and lock icons, set `showAuthorization: false` in your Swagger UI configuration:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  presets: [
+    SwaggerUIBundle.presets.apis,
+    SwaggerUIStandalonePreset
+  ],
+  plugins: [
+    SwaggerUIBundle.plugins.DownloadUrl
+  ],
+  layout: "StandaloneLayout",
+  
+  // Add this line to hide authorization UI
+  showAuthorization: false
+})
+```
+
+### Showing Authorization UI
+
+To show the Authorize button and lock icons (default behavior):
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  // ... other config options
+  
+  // Explicitly enable authorization UI (or just omit this line)
+  showAuthorization: true
+})
+```
+
+## What Gets Hidden/Shown
+
+When `showAuthorization` is set to `false`:
+- ✅ The main "Authorize" button in the top-right area is hidden
+- ✅ The lock icons next to each API operation are hidden
+- ✅ Users cannot access the authorization popup
+
+When `showAuthorization` is set to `true` (default):
+- ✅ The main "Authorize" button is visible
+- ✅ The lock icons appear next to operations that require authentication
+- ✅ Users can click to configure authorization
+
+## Example: Testing Locally
+
+To test this in your dev environment, edit `dev-helpers/dev-helper-initializer.js`:
+
+```javascript
+window.onload = function() {
+  window["SwaggerUIBundle"] = window["swagger-ui-bundle"]
+  window["SwaggerUIStandalonePreset"] = window["swagger-ui-standalone-preset"]
+  
+  const ui = SwaggerUIBundle({
+    url: "https://petstore.swagger.io/v2/swagger.json",
+    dom_id: "#swagger-ui",
+    presets: [
+      SwaggerUIBundle.presets.apis,
+      SwaggerUIStandalonePreset
+    ],
+    plugins: [
+      SwaggerUIBundle.plugins.DownloadUrl
+    ],
+    layout: "StandaloneLayout",
+    
+    // Hide authorization UI
+    showAuthorization: false
+  })
+
+  window.ui = ui
+}
+```
+
+---
+
+## Combined Example
+
+You can use all configurations together for a streamlined, read-only API documentation view:
+
+```javascript
+const ui = SwaggerUIBundle({
+  url: "https://petstore.swagger.io/v2/swagger.json",
+  dom_id: "#swagger-ui",
+  presets: [
+    SwaggerUIBundle.presets.apis,
+    SwaggerUIStandalonePreset
+  ],
+  plugins: [
+    SwaggerUIBundle.plugins.DownloadUrl
+  ],
+  layout: "StandaloneLayout",
+  
+  // Hide authorization UI
+  showAuthorization: false,
+  
+  // Hide "Try it out" button
+  showTryItOut: false,
+  
+  // Keep all operations expanded
+  operationsCollapsible: false,
+  
+  // Hide utility buttons
+  showOperationUtilities: false
+})
+```
+
+This creates a clean, read-only documentation view where:
+- ✅ No authorization UI clutter
+- ✅ No "Try it out" button (read-only mode)
+- ✅ All API operations are immediately visible
+- ✅ No utility buttons (copy, jump-to)
+- ✅ Users can quickly scan all endpoints
+- ✅ Perfect for public API documentation
+
+---
+
+## Files Modified
+
+The following files were modified to support these features:
+
+### Authorization Control (`showAuthorization`):
+1. **`src/core/config/defaults.js`** - Added `showAuthorization: true` default config
+2. **`src/core/config/type-cast/mappings.js`** - Added type-cast mapping for the config
+3. **`src/core/components/layouts/base.jsx`** - Made main Authorize button conditional
+4. **`src/core/components/operation-summary.jsx`** - Made operation lock icons conditional
+
+### Operations Accordion Control (`operationsCollapsible`):
+1. **`src/core/config/defaults.js`** - Added `operationsCollapsible: true` default config
+2. **`src/core/config/type-cast/mappings.js`** - Added type-cast mapping for the config
+3. **`src/core/containers/OperationContainer.jsx`** - Made operations always expanded when disabled
+4. **`src/core/components/operation-summary.jsx`** - Hid arrow buttons when not collapsible
+
+## Benefits
+
+✅ **Configurable** - Easy to toggle on/off via configuration
+✅ **Backward Compatible** - Defaults maintain existing behavior
+✅ **Future-Proof** - Just change the config value to restore features
+✅ **Clean Architecture** - No need to modify component code to hide/show features
+✅ **Flexible** - Use individually or combine for custom experiences
+

package/Dockerfile

@@ -0,0 +1,39 @@
+# Looking for information on environment variables?
+# We don't declare them here — take a look at our docs.
+# https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md
+
+FROM nginx:1.29.3-alpine
+
+LABEL maintainer="vladimir.gorej@gmail.com" \
+      org.opencontainers.image.authors="vladimir.gorej@gmail.com" \
+      org.opencontainers.image.url="docker.swagger.io/swaggerapi/swagger-ui" \
+      org.opencontainers.image.source="https://github.com/swagger-api/swagger-ui" \
+      org.opencontainers.image.description="SwaggerUI Docker image" \
+      org.opencontainers.image.licenses="Apache-2.0"
+
+RUN apk add --update-cache --no-cache "nodejs" "libxml2>=2.13.9-r0" "libexpat>=2.7.2-r0" "libxslt>=1.1.42-r2" "xz-libs>=5.6.3-r1" "c-ares>=1.34.5-r0"
+
+LABEL maintainer="char0n"
+
+ENV API_KEY="**None**" \
+    SWAGGER_JSON="/app/swagger.json" \
+    PORT="8080" \
+    PORT_IPV6="" \
+    BASE_URL="/" \
+    SWAGGER_JSON_URL="" \
+    CORS="true" \
+    EMBEDDING="false"
+
+COPY --chmod=0644 ./docker/default.conf.template ./docker/cors.conf ./docker/embedding.conf /etc/nginx/templates/
+
+COPY --chmod=0644 ./dist/* /usr/share/nginx/html/
+COPY --chmod=0755 ./docker/docker-entrypoint.d/ /docker-entrypoint.d/
+COPY --chmod=0644 ./docker/configurator /usr/share/nginx/configurator
+
+# Simulates running NGINX as a non root; in future we want to use nginxinc/nginx-unprivileged.
+# In future we will have separate unpriviledged images tagged as v5.1.2-unprivileged.
+RUN chmod 777 /etc/nginx/conf.d/ /usr/share/nginx/html/ /var/cache/nginx/ /var/run/ && \
+    chmod 666 /etc/nginx/conf.d/default.conf /usr/share/nginx/html/swagger-initializer.js && \
+    chmod 755 /etc/nginx/templates /usr/share/nginx/configurator
+
+EXPOSE 8080