lightnet 3.4.0 → 3.4.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # lightnet
 
+## 3.4.2
+
+### Patch Changes
+
+- [#256](https://github.com/LightNetDev/LightNet/pull/256) [`3c005c1`](https://github.com/LightNetDev/LightNet/commit/3c005c10ed55061f00f7d9c74e03be879bd5bb85) Thanks [@smn-cds](https://github.com/smn-cds)! - Improve error messages.
+
+## 3.4.1
+
+### Patch Changes
+
+- [#254](https://github.com/LightNetDev/LightNet/pull/254) [`46c0f7c`](https://github.com/LightNetDev/LightNet/commit/46c0f7c693a46a7a2e06e72c4a333368aa8f7485) Thanks [@smn-cds](https://github.com/smn-cds)! - Improve responsive image variants:
+
+  - Improve image quality on search result items
+  - Limit the size of the media list image
+  - Streamline details page cover image variants
+  - Streamline gallery image variants
+
 ## 3.4.0
 
 ### Minor Changes

package/__e2e__/fixtures/basics/node_modules/.bin/astro

@@ -6,9 +6,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../astro/astro.js" "$@"

package/__e2e__/fixtures/basics/package.json

@@ -4,11 +4,11 @@
   "version": "0.0.1",
   "private": "true",
   "dependencies": {
-    "@astrojs/react": "^4.2.3",
+    "@astrojs/react": "^4.2.4",
     "@astrojs/tailwind": "^6.0.2",
     "@lightnet/decap-admin": "^3.1.0",
-    "astro": "^5.6.1",
-    "lightnet": "^3.4.0",
+    "astro": "^5.6.2",
+    "lightnet": "^3.4.1",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "sharp": "^0.33.5",

package/package.json

@@ -2,7 +2,7 @@
   "name": "lightnet",
   "type": "module",
   "license": "MIT",
-  "version": "3.4.0",
+  "version": "3.4.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/LightNetDev/lightnet",
@@ -45,17 +45,16 @@
     "@iconify-json/mdi": "^1.2.3",
     "@iconify/tailwind": "^1.2.0",
     "@tailwindcss/typography": "^0.5.16",
-    "@types/react": "^19.1.0",
+    "@types/react": "^19.1.2",
     "daisyui": "^4.12.24",
     "fuse.js": "^7.1.0",
-    "i18next": "^24.2.3",
-    "marked": "^15.0.7",
-    "yaml": "^2.7.1",
-    "zod-validation-error": "^3.4.0"
+    "i18next": "^25.0.0",
+    "marked": "^15.0.8",
+    "yaml": "^2.7.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.51.1",
-    "@types/node": "^22.14.0",
+    "@types/node": "^22.14.1",
     "vitest": "^3.1.1"
   },
   "scripts": {

package/src/astro-integration/integration.ts

@@ -23,7 +23,8 @@ export function lightnet(lightnetConfig: LightnetConfig): AstroIntegration {
         const config = verifySchema(
           configSchema,
           lightnetConfig,
-          "Invalid config passed to LightNet integration.",
+          "Invalid LightNet configuration",
+          "Fix these errors on the LightNet configuration inside astro.config.mjs:",
         )
 
         injectRoute({

package/src/components/MediaGallery.astro

@@ -52,7 +52,7 @@ const items = itemsInput.filter((item) => !!item)
                 class="h-full w-full object-contain"
                 src={item.data.image}
                 alt=""
-                widths={[120, 160, 240, 320, 640]}
+                widths={[256, 512, 768, 1024]}
                 sizes={
                   "(max-width: 640px) calc(calc(100vw - 3.5rem ) / 2), " +
                   "(max-width: 768px) calc(calc(100vw - 5rem ) / 3), " +

package/src/components/MediaList.astro

@@ -62,6 +62,7 @@ const mediaTypes = Object.fromEntries(
             <Image
               class="max-h-32 w-auto max-w-32 rounded-sm object-contain shadow-md"
               src={item.data.image}
+              width={256}
               alt=""
             />
           </div>

package/src/content/get-media-items.ts

@@ -23,5 +23,6 @@ const prepareItem = async (item: unknown) => {
     mediaItemEntrySchema,
     item,
     (id) => `Invalid media item: ${id}`,
+    (id) => `Fix these issues inside "src/content/media/${id}.json":`,
   )
 }

package/src/content/get-media-types.ts

@@ -7,7 +7,8 @@ export const getMediaType = async (id: string) => {
   return verifySchema(
     mediaTypeEntrySchema,
     await getEntry("media-types", id),
-    `Received invalid media type ${id}.`,
+    (id) => `Invalid media type: "${id}"`,
+    (id) => `Fix these issues inside "src/content/media-types/${id}.json":`,
   )
 }
 
@@ -17,7 +18,8 @@ export const getMediaTypes = async () => {
     verifySchema(
       mediaTypeEntrySchema,
       type,
-      (id) => `Received invalid media type '${id}'.`,
+      (id) => `Invalid media type: "${id}"`,
+      (id) => `Fix these issues inside "src/content/media-types/${id}.json":`,
     ),
   )
 }

package/src/content/resolve-category-label.ts

@@ -12,8 +12,8 @@ export const resolveCategoryLabel = (
   const category = categories.find((c) => c.id === categoryId)
   if (!category) {
     throw new AstroError(
-      `Unknown category: ${categoryId}`,
-      "Make sure you add the category to the categories content collection.",
+      `Missing category "${categoryId}"`,
+      `To fix the issue, add a category at "src/content/categories/${categoryId}.json".`,
     )
   }
   return translate(category.data.label)

package/src/i18n/resolve-default-locale.ts

@@ -11,8 +11,8 @@ export const resolveDefaultLocale = ({
   const defaultLanguage = languages.find((l) => l.isDefaultSiteLanguage)
   if (!defaultLanguage) {
     throw new AstroError(
-      "No default site language has been set",
-      "Make sure you have set one language to be the default language by setting the isDefaultSiteLanguage to `true`.",
+      "No default site language set",
+      "To fix the issue, set isDefaultSiteLanguage for one language in the LightNet configuration in your astro.config.mjs file.",
     )
   }
   return defaultLanguage.code

package/src/i18n/resolve-language.ts

@@ -12,7 +12,10 @@ export const resolveLanguage = (bcp47: string) => {
   const language = languages[bcp47]
 
   if (!language) {
-    throw new AstroError(`There is no language definition for: ${bcp47}`)
+    throw new AstroError(
+      `Missing language code "${bcp47}"`,
+      `To fix the issue, add a language with the code "${bcp47}" to the LightNet configuration in your astro.config.mjs file.`,
+    )
   }
   return {
     ...language,

package/src/i18n/translate.ts

@@ -47,7 +47,7 @@ export function useTranslate(bcp47: string | undefined): TranslateFn {
     if (value.match(/^(?:ln|x)\../i)) {
       throw new AstroError(
         `Missing translation: '${key}' is undefined for language '${resolvedLocale}'.`,
-        `Add a translation for '${key}' to src/translations/${resolvedLocale}.yml`,
+        `To fix the issue, add a translation for '${key}' to src/translations/${resolvedLocale}.yml`,
       )
     }
     return value

package/src/layouts/components/Favicon.astro

@@ -17,8 +17,8 @@ const favicons = config.favicon?.map((favicon) => {
   const type = faviconTypes[extname(favicon.href)]
   if (!type) {
     throw new AstroError(
-      `Unsupported favicon ${favicon.href}`,
-      "favicon must be a .ico, .gif, .jpg, .png, or .svg file",
+      `Unsupported favicon type "${extname(favicon.href)}"`,
+      "To fix the issue, set the favicon href to a path ending with .ico, .gif, .jpg, .png, or .svg.",
     )
   }
   return { ...favicon, type }

package/src/pages/api/search.ts

@@ -32,7 +32,7 @@ async function createSearchItem(mediaItem: MediaItemEntry) {
   } = await getImage({
     src: image,
     format: "webp",
-    width: 144,
+    width: 256,
   })
   return {
     title,

package/src/pages/details-page/DetailsPageRoute.astro

@@ -33,8 +33,8 @@ if (detailsPage?.layout === "custom") {
   ] as () => Promise<any>
   if (!customDetailsImport) {
     throw new AstroError(
-      `Unknown details page ${detailsPage.customComponent}`,
-      "Make sure to add your details component within /src/details-pages/",
+      `Missing custom details page "${detailsPage.customComponent}"`,
+      `To fix the issue, add your details page on "/src/details-pages/${detailsPage.customComponent}".`,
     )
   }
   CustomDetails = (await customDetailsImport()).default

package/src/pages/details-page/components/MediaCollection.astro

@@ -14,7 +14,10 @@ const { collectionId, disableItem } = Astro.props
 
 const collection = await getEntry("media-collections", collectionId)
 if (!collection) {
-  throw new AstroError(`Unknown media collection id ${collection}.`)
+  throw new AstroError(
+    `Missing media-collection "${collectionId}".`,
+    `To fix the issue, add a media-collection at "src/content/media-collections/${collectionId}.json".`,
+  )
 }
 const items = (
   await queryMediaItems(getMediaItems(), {

package/src/pages/details-page/components/main-details/AudioPlayer.astro

@@ -9,7 +9,7 @@ const { src, className } = Astro.props
 if (!src.endsWith(".mp3")) {
   throw new AstroError(
     `Unsupported audio file ${src}`,
-    "Mp3 is the only supported format.",
+    "To fix the issue, reference a mp3 file.",
   )
 }
 ---

package/src/pages/details-page/components/main-details/Cover.astro

@@ -21,7 +21,7 @@ const isPortraitImage = image.height > image.width
   <Image
     class:list={isPortraitImage ? "h-52 w-auto sm:h-72" : "h-auto w-52 sm:w-72"}
     alt=""
-    widths={[208, 288, 576, 864]}
+    widths={[256, 512, 768, 1024]}
     sizes="(max-width: 640px) 13rem, 18rem"
     src={image}
     quality="high"

package/src/pages/search-page/hooks/use-search.ts

@@ -20,7 +20,9 @@ export function useSearch() {
       try {
         const response = await fetch("/api/search.json")
         if (!response.ok) {
-          throw new Error("Network response was not ok")
+          throw new Error(
+            "Was not able to load search results from /api/search.json.",
+          )
         }
         const { items }: SearchResponse = await response.json()
         fuse.current = new Fuse(items, {

package/src/utils/verify-schema.ts

@@ -1,15 +1,15 @@
 import { AstroError } from "astro/errors"
 import { z } from "astro/zod"
-import { fromZodError } from "zod-validation-error"
 
 export async function verifySchemaAsync<T extends z.Schema>(
   schema: T,
   toVerify: unknown,
   errorMessage: string | ((id: string | undefined) => string),
+  hint: string | ((id: string | undefined) => string),
 ): Promise<z.output<T>> {
   const parsed = await schema.safeParseAsync(toVerify)
   if (!parsed.success) {
-    throwParseError(toVerify, errorMessage, parsed)
+    throwParseError(toVerify, errorMessage, hint, parsed)
   }
   return parsed.data
 }
@@ -18,10 +18,11 @@ export function verifySchema<T extends z.Schema>(
   schema: T,
   toVerify: unknown,
   errorMessage: string | ((id: string | undefined) => string),
+  hint: string | ((id: string | undefined) => string),
 ): z.output<T> {
   const parsed = schema.safeParse(toVerify, {})
   if (!parsed.success) {
-    throwParseError(toVerify, errorMessage, parsed)
+    throwParseError(toVerify, errorMessage, hint, parsed)
   }
   return parsed.data
 }
@@ -29,10 +30,15 @@ export function verifySchema<T extends z.Schema>(
 function throwParseError(
   toVerify: unknown,
   errorMessage: string | ((id: string | undefined) => string),
+  hint: string | ((id: string | undefined) => string),
   parsed: z.SafeParseError<unknown>,
 ) {
   const id = z.object({ id: z.string() }).safeParse(toVerify).data?.id
   const message =
     typeof errorMessage === "string" ? errorMessage : errorMessage(id)
-  throw new AstroError(message, fromZodError(parsed.error).toString())
+  const hintFinal = typeof hint === "string" ? hint : hint(id)
+  const issues = parsed.error.errors
+    .map((e) => `- ${e.path.join(".")}: ${e.message}`)
+    .join("\n")
+  throw new AstroError(message, `${hintFinal}\n\n${issues}`)
 }