@hagicode/hagilight-starlight 0.8.1-dev.87.1.57ea49d → 0.8.1-dev.92.1.85649f3

package/README.md

@@ -41,6 +41,16 @@ Disable the picker to keep Starlight's built-in toggle or compose `@hagicode/hag
 hagilight({ themes: { enabled: false } })
 ```
 
+### Body images
+
+`hagilight()` registers the content-image plugin from `@hagicode/hagilight-core/content-images` for the whole site. Every Markdown or MDX body image outside a `<picture>` element gets `loading="lazy"`, `decoding="async"`, and the class `hagilight-content-image`. Values the author set are kept, and logos and showcase images are not changed.
+
+Turn it off for the site:
+
+```js
+hagilight({ contentImages: { enabled: false } })
+```
+
 ### HagiCode showcase
 
 After the body (and any translation notice) of every documentation article, the plugin renders a static HagiCode showcase: a headline, lead, and tagline with calls to action to the website and the documentation, three pillars (Smart, Efficient, Fun), a three-image gallery with captions, and a closing row with the Windows download button beside a selectable, copy-ready share sentence. The layout follows the showcase's own width: one column when narrow, a three-up pillar row, a gallery mosaic, and a two-column closing row from 36rem, and the pillars beside the pitch from 56rem (for example in the wide content mode). All text is localized for the ten published locales (`en-US`, `zh-CN`, `zh-Hant`, `ja-JP`, `ko-KR`, `de-DE`, `fr-FR`, `es-ES`, `pt-BR`, `ru-RU`) and falls back to English for any other language. Links come from the same locale-aware catalog as the footer.

package/dist/index.d.ts

@@ -63,6 +63,8 @@ export interface HagilightStarlightOptions {
     hagicodePromotion?: HagilightToggleOptions;
     /** Floating promotion banner rendered after the footer. */
     promoto?: HagilightToggleOptions;
+    /** Body-image baseline (`loading`, `decoding`, marker class) for Markdown and MDX. Defaults to enabled. */
+    contentImages?: HagilightToggleOptions;
     /** Header and footer link customization passed to `resolveSiteLinks`. */
     links?: SiteLinksOptions;
 }

package/dist/index.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 import { resolveFaviconHeadEntry } from '@hagicode/hagilight-core/favicon';
+import { checkContentImageRegistration, registerContentImages } from '@hagicode/hagilight-core/content-images';
 import { resolveRssLocales } from '@hagicode/hagilight-core/rss';
 import { RSS_OWNER, registerStarlightRssOwner, } from '@hagicode/hagilight-core/rss-ownership';
 import { isValidSeoImageReference, resolveSeoImageUrl } from '@hagicode/hagilight-core/seo';
@@ -199,7 +200,7 @@ function resolveDefaultSeoLocale(defaultLocale, locales) {
     }
     return found.route;
 }
-function createConfiguredIntegration(instanceId, serializedOptions, rssConfig, rssLocaleFeedUrls, componentIds, getConfiguredRssFeed, generateRss, unregisterRssOwner) {
+function createConfiguredIntegration(instanceId, serializedOptions, rssConfig, rssLocaleFeedUrls, componentIds, getConfiguredRssFeed, generateRss, unregisterRssOwner, contentImagesEnabled) {
     const optionsId = `virtual:hagilight-starlight/${instanceId}/options`;
     const rssConfigId = 'virtual:hagilight-starlight/rss-config';
     const headerPath = componentIds.header ? packageFile('Header.astro') : undefined;
@@ -303,7 +304,8 @@ const isNotFound = /(?:^|\\/)404(?:\\.html)?\\/?$/u.test(Astro.url.pathname);
         name: `@hagicode/hagilight-starlight:${instanceId}`,
         [RSS_OWNER]: { package: 'starlight', enabled: generateRss },
         hooks: {
-            'astro:config:setup'({ injectRoute, updateConfig }) {
+            'astro:config:setup'({ config, injectRoute, updateConfig, logger }) {
+                registerContentImages({ config, logger, enabled: contentImagesEnabled });
                 if (generateRss) {
                     injectRoute({
                         pattern: '/rss.xml',
@@ -320,6 +322,7 @@ const isNotFound = /(?:^|\\/)404(?:\\.html)?\\/?$/u.test(Astro.url.pathname);
             },
             'astro:config:done'({ config, logger }) {
                 unregisterRssOwner();
+                checkContentImageRegistration({ config, logger, enabled: contentImagesEnabled });
                 if (config.image?.service?.entrypoint === NOOP_IMAGE_SERVICE) {
                     logger.warn(NOOP_IMAGE_SERVICE_WARNING);
                 }
@@ -363,6 +366,8 @@ export default function hagilight(options = {}) {
     });
     const promoto = optionalRecord(input.promoto, 'promoto');
     const promotoEnabled = optionalBoolean(promoto, 'enabled', 'promoto enabled') !== false;
+    const contentImages = optionalRecord(input.contentImages, 'contentImages');
+    const contentImagesEnabled = optionalBoolean(contentImages, 'enabled', 'contentImages enabled') !== false;
     const instanceId = randomUUID();
     const componentIds = {
         header: headerEnabled
@@ -471,7 +476,7 @@ export default function hagilight(options = {}) {
                         new URL(`rss.${filename}.xml`, baseUrl).toString(),
                     ]))
                     : {};
-                addIntegration(createConfiguredIntegration(instanceId, serializedOptions, { options: rssOptions, locales: rssLocales }, rssLocaleFeedUrls, componentIds, () => getRssFeedUrl(config) ?? rssFeedUrl, generateRss, unregisterRssOwner));
+                addIntegration(createConfiguredIntegration(instanceId, serializedOptions, { options: rssOptions, locales: rssLocales }, rssLocaleFeedUrls, componentIds, () => getRssFeedUrl(config) ?? rssFeedUrl, generateRss, unregisterRssOwner, contentImagesEnabled));
                 updateConfig({
                     ...(config.logo === undefined ? { logo: { src: defaultLogo, alt: 'HagiCode' } } : {}),
                     customCss: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight-starlight",
-  "version": "0.8.1-dev.87.1.57ea49d",
+  "version": "0.8.1-dev.92.1.85649f3",
   "type": "module",
   "description": "Starlight plugin and components for HagiCode documentation",
   "repository": {
@@ -53,7 +53,7 @@
     "assets/showcase/*"
   ],
   "dependencies": {
-    "@hagicode/hagilight-core": "0.8.1-dev.87.1.57ea49d"
+    "@hagicode/hagilight-core": "0.8.1-dev.92.1.85649f3"
   },
   "peerDependencies": {
     "@astrojs/starlight": "^0.42.4",