@vendure/admin-ui 3.6.0-minor-202511061555 → 3.6.0-minor-202512162029

package/.eslintrc.json

@@ -0,0 +1,99 @@
+{
+  "root": true,
+  "ignorePatterns": [
+    "projects/**/*"
+  ],
+  "overrides": [
+    {
+      "files": [
+        "*.ts"
+      ],
+      "parserOptions": {
+        "project": [
+          "tsconfig.json"
+        ],
+        "createDefaultProgram": true
+      },
+      "extends": [
+        "plugin:@typescript-eslint/recommended",
+        "plugin:@angular-eslint/recommended",
+        "plugin:@angular-eslint/template/process-inline-templates"
+      ],
+      "plugins": [
+        "import"
+      ],
+      "rules": {
+        "@angular-eslint/directive-selector": [
+          "error",
+          {
+            "type": "attribute",
+            "prefix": "vdr",
+            "style": "camelCase"
+          }
+        ],
+        "@angular-eslint/component-selector": [
+          "error",
+          {
+            "type": "element",
+            "prefix": "vdr",
+            "style": "kebab-case"
+          }
+        ],
+        "@angular-eslint/prefer-standalone": [
+          "off"
+        ],
+        "@angular-eslint/no-input-rename": "off",
+        "@typescript-eslint/array-type": [
+          "error",
+          {
+            "default": "array-simple"
+          }
+        ],
+        "@typescript-eslint/naming-convention": "off",
+        "@typescript-eslint/consistent-type-definitions": "off",
+        "@typescript-eslint/dot-notation": "off",
+        "@typescript-eslint/explicit-member-accessibility": [
+          "off",
+          {
+            "accessibility": "explicit"
+          }
+        ],
+        "@typescript-eslint/member-ordering": "off",
+        "@typescript-eslint/no-empty-function": "error",
+        "@typescript-eslint/no-empty-interface": "off",
+        "@typescript-eslint/no-floating-promises": "off",
+        "@typescript-eslint/no-var-requires": "error",
+        "arrow-parens": [
+          "off",
+          "always"
+        ],
+        "id-blacklist": "off",
+        "id-match": "off",
+        "import/order": "error",
+        "jsdoc/check-alignment": "off",
+        "jsdoc/newline-after-description": "off",
+        "max-len": [
+          "error",
+          {
+            "code": 170
+          }
+        ],
+        "no-empty": "error",
+        "no-underscore-dangle": "off",
+        "prefer-arrow/prefer-arrow-functions": "off"
+      }
+    },
+    {
+      "files": [
+        "*.html"
+      ],
+      "extends": [
+        "plugin:@angular-eslint/template/recommended"
+      ],
+      "rules": {
+        "@angular-eslint/template/no-negated-async": "off",
+        "@angular-eslint/template/eqeqeq": "off"
+      }
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,50 @@
+# Vendure Admin UI
+
+This is the administration interface for Vendure.
+
+It is an Angular application built with the Angular CLI.
+
+The UI is powered by the [Clarity Design System](https://clarity.design).
+
+## Structure
+
+### Library
+
+The Admin UI is structured as an Angular library conforming to the [ng-packagr format](https://github.com/ng-packagr/ng-packagr). This library is what is published to npm as `@vendure/admin-ui`. The library consists
+of a set of modules which are accessible from consuming applications as sub-packages:
+
+* `@vendure/admin-ui/core`
+* `@vendure/admin-ui/catalog`
+* `@vendure/admin-ui/orders`
+
+etc. These library packages are located at [./src/lib](./src/lib)
+
+When built with `npm run build`, the output will be located in the `./package` sub directory. This is also the root of the published npm package.
+
+### Application
+
+In addition to the library, there is also a full application located at [./src/app](./src/app). This application is used both during development of the Admin UI, and also as the "default" Admin UI without any UI extensions, as provided as the default by the [admin-ui-plugin](../admin-ui-plugin).
+
+## Localization
+
+Localization of UI strings is handled by [ngx-translate](https://ngx-translate.org). The translation strings should use the [ICU MessageFormat](https://unicode-org.github.io/icu/userguide/format_parse/messages).
+
+Translation keys are automatically extracted by running:
+```
+npm run extract-translations
+```
+This scan the source files for any translation keys, and add them to each of the translation files located in [`./src/lib/static/i18n-messages/`](./src/lib/static/i18n-messages/).
+
+A report is generated for each language detailing what percentage of the translation tokens are translated into that language:
+
+```text
+Extracting translation tokens for "src\lib\static\i18n-messages\de.json"
+de: 592 of 650 tokens translated (91%)
+```
+
+This report data is also saved to the [i18n-coverage.json](./i18n-coverage.json) file.
+
+To add support for a new language, create a new empty json file (`{}`) in the `i18n-messages` directory named `<languageCode>.json`, where `languageCode` is one of the supported codes as given in the [LanguageCode enum type](../core/src/api/schema/common/language-code.graphql), then run `npm run extract-translations`
+
+To verify localization changes add `<languageCode>.json` to `./src/lib/static/vendure-ui-config.json` in the array `availableLanguages`. This will make the localization available in Admin UI development mode using `npm run dev`
+

package/angular.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "../../node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "vendure-admin": {
+      "root": "",
+      "sourceRoot": "src",
+      "projectType": "application",
+      "prefix": "vdr",
+      "schematics": {
+        "@schematics/angular:component": {
+          "style": "scss"
+        }
+      },
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:application",
+          "options": {
+            "baseHref": "/admin/",
+            "outputPath": {
+              "base": "dist"
+            },
+            "index": "src/lib/static/index.html",
+            "polyfills": [
+              "src/lib/static/polyfills.ts"
+            ],
+            "tsConfig": "src/tsconfig.app.json",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "src/lib/static/",
+                "output": "/"
+              }
+            ],
+            "styles": [
+              "src/lib/static/styles/styles.scss"
+            ],
+            "stylePreprocessorOptions": {
+              "includePaths": [
+                "./src/lib/static/styles",
+                "./src/lib/static/fonts"
+              ],
+              "sass": {
+                "silenceDeprecations": ["mixed-decls", "color-functions", "global-builtin", "import"]
+              }
+            },
+            "allowedCommonJsDependencies": [
+              "graphql-tag",
+              "zen-observable",
+              "lodash",
+              "dayjs",
+              "apollo-upload-client",
+              "@clr/icons",
+              "@clr/icons/shapes/all-shapes",
+              "@vendure/common/lib/generated-types",
+              "@vendure/common/lib/simple-deep-clone",
+              "@vendure/common/lib/shared-constants",
+              "@vendure/common/lib/shared-utils",
+              "@vendure/common/lib/normalize-string",
+              "@vendure/common/lib/unique",
+              "@vendure/common/lib/omit",
+              "@vendure/common/lib/pick",
+              "@messageformat/core"
+            ],
+            "extractLicenses": false,
+            "sourceMap": true,
+            "optimization": false,
+            "namedChunks": true,
+            "browser": "src/main.ts"
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "6kb"
+                }
+              ],
+              "fileReplacements": [
+                {
+                  "replace": "src/environments/environment.ts",
+                  "with": "src/environments/environment.prod.ts"
+                }
+              ],
+              "optimization": {
+                "styles": {
+                  "inlineCritical": false
+                }
+              },
+              "outputHashing": "all",
+              "namedChunks": false,
+              "extractLicenses": true
+            }
+          },
+          "defaultConfiguration": ""
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "options": {
+            "buildTarget": "vendure-admin:build"
+          },
+          "configurations": {
+            "production": {
+              "buildTarget": "vendure-admin:build:production"
+            },
+            "plugin": {
+              "buildTarget": "vendure-admin:build:plugin-watch"
+            },
+            "plugin-dev": {
+              "buildTarget": "vendure-admin:build:plugin-dev-watch"
+            }
+          }
+        },
+        "extract-i18n": {
+          "builder": "@angular-devkit/build-angular:extract-i18n",
+          "options": {
+            "buildTarget": "vendure-admin:build"
+          }
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "main": "src/test.ts",
+            "polyfills": "src/lib/static/polyfills.ts",
+            "tsConfig": "src/tsconfig.spec.json",
+            "karmaConfig": "src/karma.conf.js",
+            "styles": [
+              "src/lib/static/styles/styles.scss"
+            ],
+            "scripts": [],
+            "assets": [
+              "src/lib/static/favicon.ico",
+              "src/lib/static/assets"
+            ],
+            "stylePreprocessorOptions": {
+              "includePaths": [
+                "./src/lib/static/styles",
+                "./src/lib/static/fonts"
+              ]
+            }
+          }
+        },
+        "lint": {
+          "builder": "@angular-eslint/builder:lint",
+          "options": {
+            "lintFilePatterns": [
+              "src/**/*.ts",
+              "src/**/*.html"
+            ]
+          }
+        }
+      }
+    },
+    "vendure-admin-lib": {
+      "projectType": "library",
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "vdr",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:ng-packagr",
+          "options": {
+            "tsConfig": "./tsconfig.lib.json",
+            "project": "./src/lib/ng-package.json"
+          },
+          "configurations": {
+            "production": {
+              "tsConfig": "./tsconfig.lib.prod.json"
+            }
+          }
+        }
+      }
+    }
+  },
+  "schematics": {
+    "@schematics/angular:component": {
+      "skipTests": true,
+      "changeDetection": "OnPush",
+      "project": "vendure-admin-lib"
+    }
+  },
+  "cli": {
+    "packageManager": "npm",
+    "analytics": "61fa89f7-706a-46c0-bcdb-b1d3664195ce",
+    "schematicCollections": [
+      "@angular-eslint/schematics"
+    ]
+  }
+}

package/i18n-coverage.json

@@ -0,0 +1,116 @@
+{
+  "generatedOn": "2025-05-15T23:57:55.420Z",
+  "lastCommit": "15b63cd8c0ce7954f79e25c724f97821c4611861",
+  "translationStatus": {
+    "ar": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "cs": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "de": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "en": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "es": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "fa": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "fr": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "he": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "hr": {
+      "tokenCount": 797,
+      "translatedCount": 795,
+      "percentage": 100
+    },
+    "it": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "ja": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "nb": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "ne": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "pl": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "pt_BR": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "pt_PT": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "ru": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "sv": {
+      "tokenCount": 797,
+      "translatedCount": 792,
+      "percentage": 99
+    },
+    "tr": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "uk": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "zh_Hans": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    },
+    "zh_Hant": {
+      "tokenCount": 797,
+      "translatedCount": 796,
+      "percentage": 100
+    }
+  }
+}