Initialize the AI Media module

Problem/Motivation

AI Media generates images, SVGs and videos from the Media Library. It moved from a private GitHub repository to drupal.org, and needs what a first public release needs: a canonical repository, CI, a project page and README, styling that follows the admin theme, core HTMX, a settings page, and the docs and tests every Vardot-maintained module ships.

Steps to reproduce

N/A

Proposed resolution

Done (merged into 1.0.x):

• git.drupalcode.org is the canonical repository, on 1.0.x with the existing history. The 1.0.x-dev release is out.
• !1 GitLab CI on the drupal/gitlab_templates, and the README.
• !2 Require enshrined/svg-sanitize ^1.0, since every 0.x release has advisories.
• !3 Follow the active admin theme: Claro, Gin and Default Admin.
• !5 Ship less custom CSS and JS (ai-media.admin.css, ai-media.admin.js), and generate with core HTMX instead of Form API AJAX.
• !6 A settings page at /admin/config/ai/ai-media: Media Library tabs, generators, description, name and alternative text, files and providers.
• !7 Follow the Vardot module standard: GitLab templates, docs on GitLab Pages, README outline and a Varbase E2E suite.

In progress, in one merge request:

• !20 Safety, AI Prompts, AI Context, Add media and editorial UX: guardrail stops and AI tags on every call, plain error messages, generating on core's Add media page, a Safety tab that picks one of the site's guardrail sets, AI Prompts for the generator prompts, AI Media as an AI Context consumer type (no submodule), a static or animated SVG generator, and the experimental video generator in AI Media itself, off by default, and a per-generator Media Library tab setting.
• Documents are not part of AI Media: the document generator was taken out, so AI Media no longer needs dompdf/dompdf or league/commonmark. A generator from another module still plugs in the same way.

!4 is superseded: its changes reached 1.0.x with !5. !8 to !19 are closed in favour of !20.

Remaining tasks

• ✅ File an issue
• ✅ Addition/Change/Update/Fix
• ✅ Push the existing history to a 1.0.x branch on git.drupalcode.org
• ✅ Make 1.0.x the default branch
• ✅ Create the 1.0.x-dev release
• ✅ Replace the placeholder project page
• ✅ Add GitLab CI using the drupal/gitlab_templates
• ✅ Write the README for the first public release
• ✅ Follow the active admin theme (Claro, Gin, Default Admin)
• ✅ Ship less custom CSS and JS
• ✅ Generate with core HTMX
• ✅ Settings page
• ✅ Follow the Vardot module standard (templates, docs, E2E suite)
• ❌ Safety, AI Prompts, AI Context, Add media and editorial UX (!20)
• ❌ Take documents out of AI Media (!20)
• ❌ Make github.com/Vardot/ai_media a mirror
• ✅ Testing to ensure no regression
• ❌ Automated unit/functional testing coverage
• ❌ Developer Documentation support
• ❌ User Guide Documentation support
• ➖ UX/UI designer responsibilities
• ✅ Accessibility and Readability
• ❌ Reviewed by a human
• ❌ Code review by maintainers
• ❌ Full testing and approval
• ❌ Credit contributors
• ❌ Review with the product owner
• ❌ Update Release Notes
• ❌ Release

User interface changes

• The "Generate … with AI" tabs follow the active admin theme, with the theme's own "New" flag where it has one.
• Generate and Generate again update the form in place with core HTMX. Enter in the Name field no longer starts a new generation.

Screenshots, on Varbase 11 with Gin, real OpenAI and Anthropic results (MR !20):

Review a generated image: name and alternative text prefilled from the description, a preview and a full size link, then save

Review a generated SVG, sanitized, made with Anthropic

Generate on core's Add media page, with examples, the provider disclosure and the cost line

Settings: the Safety tab picks one of the site's own guardrail sets

API changes

• Requires Drupal core ^11.3 (core HTMX), drupal/ai ^1.5 and enshrined/svg-sanitize ^1.0.
• No longer requires dompdf/dompdf or league/commonmark: there is no document generator.
• Assets renamed to css/ai-media.admin.css and js/ai-media.admin.js.

Data model changes

• The settings page adds keys to ai_media.settings. No update hooks: missing keys fall back to defaults at runtime.
• No document media source or document media type.

Release notes snippet

• First public release of AI Media: generate images, SVGs and videos with AI from the Media Library.

AI-Generated: Yes