Files
forge/web_src/js/render/swagger.ts
zeekayandHanzo Dev 412997543a rebrand(rel): rip ALL remaining gitea internals from rendered surfaces
- svg icon set: gitea-* → hanzo-* (60 icons — the names render into the DOM
  as class attributes on every page); webhook-type icon content replaced:
  the white Gitea TEACUP → the Hanzo mark (currentColor).
- Actions bot identity: gitea-actions / 'Gitea Actions' / [email protected] →
  hanzo-actions / 'Hanzo Actions' / [email protected] — this signs every
  Actions-generated commit. Virtual user (id -2, no DB row) so no migration;
  old git commits keep their historical author. Legacy name stays reserved
  so nobody can squat it.
- emoji defaults: :gitea:/:gogs:/:codeberg: ripped (pngs deleted); kept
  git/github/gitlab (real interop marks).
- external-render seam tokens (script#, query params, data-attr, CSS var),
  EasyMDE toolbar keys, theme meta-info marker gitea-theme-meta-info →
  hanzo-theme-meta-info (parser + all 9 theme files + tests).
- meta keywords default → git,self-hosted,hanzo; update-checker cron now
  DISABLED by default + pointed at hanzoai/git releases (was phoning
  dl.gitea.com weekly and comparing against the wrong product's versions).
- user-visible snippets/links: cargo registry name, debian keyring paths,
  LDAP filter placeholders, install placeholders, home/appearance/admin
  links, swagger profile-URL description, oauth2 modal DOM ids,
  web_src module gitea-actions.ts → actions-types.ts.
- KEPT (functional, not brand): webhook TYPE key 'gitea' + /gitea/new route
  (existing hooks), ssh-keygen -n gitea signing namespace (verification
  compat), 'gitea doctor' CLI examples (actual binary name), migrate-from-
  Gitea interop naming, swagger enum values.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-24 12:45:20 -07:00

55 lines
2.2 KiB
TypeScript

// AVOID importing other unneeded main site JS modules to prevent unnecessary code and dependencies and chunks.
// This module is used by both the Gitea API page and the frontend external render.
// It doesn't need any code from main site's modules (at the moment).
import SwaggerUI from 'swagger-ui-dist/swagger-ui-es-bundle.js';
import {load as loadYaml} from 'js-yaml';
function syncDarkModeClass(): void {
// if the viewer is embedded in an iframe (external render), use the parent's theme (passed via query param)
// otherwise, if it is for Gitea's API, it is a standalone page, use the site's theme (detected from theme CSS variable)
const url = new URL(window.location.href);
const giteaIsDarkTheme = url.searchParams.get('hanzo-is-dark-theme') ??
window.getComputedStyle(document.documentElement).getPropertyValue('--is-dark-theme').trim();
const isDark = giteaIsDarkTheme ? giteaIsDarkTheme === 'true' : window.matchMedia('(prefers-color-scheme: dark)').matches;
document.documentElement.classList.toggle('dark-mode', isDark);
}
export async function initSwaggerUI(container: HTMLElement, opts: {specText: string}): Promise<void> {
// swagger-ui has built-in dark mode triggered by html.dark-mode class
syncDarkModeClass();
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', syncDarkModeClass);
let spec: any;
const specText = opts.specText.trim();
if (specText.startsWith('{')) {
spec = JSON.parse(specText);
} else {
spec = loadYaml(specText);
}
// Make the page's protocol be at the top of the schemes list
const proto = window.location.protocol.slice(0, -1);
if (spec?.schemes) {
spec.schemes.sort((a: string, b: string) => {
if (a === proto) return -1;
if (b === proto) return 1;
return 0;
});
}
SwaggerUI({
spec,
domNode: container,
deepLinking: window.location.protocol !== 'about:', // pushState fails inside about:srcdoc iframes
docExpansion: 'none',
defaultModelRendering: 'model', // don't show examples by default, because they may be incomplete
presets: [
SwaggerUI.presets.apis,
],
plugins: [
SwaggerUI.plugins.DownloadUrl,
],
});
}