@hagicode/hagilight 0.8.1-dev.87.1.57ea49d → 0.8.1-dev.88.1.80b3713

package/README.md

@@ -34,4 +34,17 @@ time from this package's own manifest, not from Astro. Existing
 feature-package attribution; switch that import to `@hagicode/hagilight/Footer`
 to opt in while keeping the same `locale` and `links` props.
 
+## Body images
+
+`hagilight()` registers the content-image plugin from `@hagicode/hagilight-core/content-images`. Markdown and MDX body images then get `loading="lazy"`, `decoding="async"`, and the class `hagilight-content-image`, with the author's values kept. This registration does not depend on `enabled`, so `hagilight({ enabled: false })` still registers the plugin.
+
+To opt out, pass either form:
+
+```js
+hagilight({ contentImages: false });
+hagilight({ contentImages: { enabled: false } });
+```
+
+Sites that do not use this integration can import the plugin from `@hagicode/hagilight-core` directly; its README describes the options and processor setup.
+
 See the [repository documentation](https://github.com/HagiCode-org/hagilight#readme) for RSS configuration, feed callback types, and integration behavior.

package/dist/integration.d.ts

@@ -15,6 +15,16 @@ export interface HagilightOptions {
      *   `RssFeedCallback`. A built-in empty feed is used when omitted.
      */
     rss?: boolean | HagilightRssOptions;
+    /**
+     * Apply the body-image baseline (`loading`, `decoding`, marker class) to Markdown
+     * and MDX images. Defaults to `true`; `false` or `{ enabled: false }` opts out.
+     * Independent of `enabled`, which controls only sitemap and robots.
+     */
+    contentImages?: boolean | HagilightContentImagesOptions;
+}
+export interface HagilightContentImagesOptions {
+    /** Defaults to `true`. */
+    enabled?: boolean;
 }
 export interface HagilightRssOptions {
     /** Starlight-shaped locale map, for example `{ root: { lang: 'en-US' }, 'zh-CN': { lang: 'zh-CN' } }`. Derived from Astro `i18n` when omitted. */
@@ -29,6 +39,6 @@ export type HagilightFaviconOptions = FaviconOptions;
  * owns sitemap generation, a consumer-owned robots page or public file takes
  * precedence, and an enabled Starlight Hagilight integration owns RSS feeds.
  */
-export declare function hagilight({ enabled, rss }?: HagilightOptions): AstroIntegration;
+export declare function hagilight({ enabled, rss, contentImages }?: HagilightOptions): AstroIntegration;
 /** Inject the bundled HagiCode favicon unless the site head already declares an icon. */
 export declare function hagilightFavicon(options?: HagilightFaviconOptions): AstroIntegration;

package/dist/integration.js

@@ -2,6 +2,7 @@ import { existsSync, readdirSync, statSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { extname, isAbsolute, resolve, win32 } from 'node:path';
 import sitemap from '@astrojs/sitemap';
+import { checkContentImageRegistration, registerContentImages } from '@hagicode/hagilight-core/content-images';
 import { resolveFaviconHeadEntry } from '@hagicode/hagilight-core/favicon';
 import { resolveRssLocales } from '@hagicode/hagilight-core/rss';
 import { resolvePlainAstroRssOwner } from '@hagicode/hagilight-core/rss-ownership';
@@ -47,10 +48,17 @@ const BUILTIN_RSS_FEED_SOURCE = BUILTIN_RSS_FEED.toString();
  * owns sitemap generation, a consumer-owned robots page or public file takes
  * precedence, and an enabled Starlight Hagilight integration owns RSS feeds.
  */
-export function hagilight({ enabled = true, rss } = {}) {
+export function hagilight({ enabled = true, rss, contentImages } = {}) {
     if (typeof enabled !== 'boolean') {
         throw new TypeError('Hagilight sitemap and robots enabled option must be a boolean.');
     }
+    if (contentImages !== undefined && typeof contentImages !== 'boolean' && !isRecord(contentImages)) {
+        throw new TypeError('Hagilight content images option must be a boolean or an options object.');
+    }
+    if (isRecord(contentImages) && contentImages.enabled !== undefined && typeof contentImages.enabled !== 'boolean') {
+        throw new TypeError('Hagilight content images enabled option must be a boolean.');
+    }
+    const contentImagesEnabled = typeof contentImages === 'boolean' ? contentImages : contentImages?.enabled !== false;
     if (rss !== undefined && typeof rss !== 'boolean' && !isRecord(rss)) {
         throw new TypeError('Hagilight RSS option must be a boolean or an options object.');
     }
@@ -65,7 +73,8 @@ export function hagilight({ enabled = true, rss } = {}) {
     return {
         name: '@hagicode/hagilight:discovery',
         hooks: {
-            'astro:config:setup'({ config, injectRoute, addMiddleware, updateConfig }) {
+            'astro:config:setup'({ config, injectRoute, addMiddleware, updateConfig, logger }) {
+                registerContentImages({ config, logger, enabled: contentImagesEnabled });
                 if (!enabled)
                     return;
                 resolveDiscoverySite(config.site);
@@ -114,6 +123,9 @@ export function hagilight({ enabled = true, rss } = {}) {
                     },
                 });
             },
+            'astro:config:done'({ config, logger }) {
+                checkContentImageRegistration({ config, logger, enabled: contentImagesEnabled });
+            },
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight",
-  "version": "0.8.1-dev.87.1.57ea49d",
+  "version": "0.8.1-dev.88.1.80b3713",
   "type": "module",
   "description": "Astro integrations and components for HagiCode sites",
   "repository": {
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@astrojs/sitemap": "^3.7.4",
-    "@hagicode/hagilight-core": "0.8.1-dev.87.1.57ea49d"
+    "@hagicode/hagilight-core": "0.8.1-dev.88.1.80b3713"
   },
   "keywords": [
     "astro-component",