starlight-obsidian 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # starlight-obsidian
 
+## 0.11.0
+
+### Minor Changes
+
+- [#67](https://github.com/HiDeoo/starlight-obsidian/pull/67) [`2969770`](https://github.com/HiDeoo/starlight-obsidian/commit/296977054e79da21b3b081f245b9e4ed69d26066) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Improves error message when the `output` directory configuration option is invalid.
+
+- [#69](https://github.com/HiDeoo/starlight-obsidian/pull/69) [`619d371`](https://github.com/HiDeoo/starlight-obsidian/commit/619d371f1a14d48cf68702f28245ac42deee4a39) Thanks [@AsterisMono](https://github.com/AsterisMono)! - Adds support for translating the generated vault pages sidebar group label.
+
+## 0.10.1
+
+### Patch Changes
+
+- [#63](https://github.com/HiDeoo/starlight-obsidian/pull/63) [`3e638d4`](https://github.com/HiDeoo/starlight-obsidian/commit/3e638d43b191da7685d59d3bc7d86ec3de4a922f) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Setups trusted publishing using OpenID Connect (OIDC) authentication — no code changes.
+
 ## 0.10.0
 
 ### Minor Changes

package/index.ts

@@ -6,6 +6,7 @@ import { z } from 'astro/zod'
 
 import { starlightObsidianIntegration } from './libs/integration'
 import { getObsidianPaths, getVault } from './libs/obsidian'
+import { stripLeadingAndTrailingSlashes } from './libs/path'
 import { throwUserError } from './libs/plugin'
 import { addObsidianFiles, getSidebarFromConfig, getSidebarGroupPlaceholder, type SidebarGroup } from './libs/starlight'
 
@@ -65,7 +66,18 @@ const starlightObsidianConfigSchema = z.object({
    *
    * @default 'notes'
    */
-  output: z.string().default('notes'),
+  output: z
+    .string()
+    .default('notes')
+    .refine(
+      (value) => {
+        const label = stripLeadingAndTrailingSlashes(value)
+        return label !== '' && label !== '.' && !label.startsWith('..')
+      },
+      {
+        message: "The `output` directory cannot be empty, '.', or start with '..'.",
+      },
+    ),
   /**
    * Whether the Starlight Obsidian plugin should skip the generation of the Obsidian vault pages.
    *
@@ -95,9 +107,12 @@ const starlightObsidianConfigSchema = z.object({
       /**
        * The generated vault pages sidebar group label.
        *
+       * The value can be a string, or for multilingual sites, an object with values for each different locale.
+       * When using the object form, the keys must be BCP-47 tags (e.g. `en`, `ar`, or `zh-CN`).
+       *
        * @default 'Notes'
        */
-      label: z.string().default('Notes'),
+      label: z.union([z.string(), z.record(z.string())]).default('Notes'),
     })
     .default({}),
   /**
@@ -179,7 +194,7 @@ function makeStarlightObsidianPlugin(
               ...overrideStarlightComponent(starlightConfig.components, logger, 'PageTitle'),
             },
             customCss: [...(starlightConfig.customCss ?? []), 'starlight-obsidian/styles/common'],
-            sidebar: getSidebarFromConfig(config, starlightConfig.sidebar, sidebarGroup),
+            sidebar: getSidebarFromConfig(config, starlightConfig, sidebarGroup),
           }
 
           if (config.skipGeneration) {

package/libs/path.ts

@@ -52,3 +52,17 @@ export function slashify(filePath: string) {
 export function osPath(filePath: string) {
   return filePath.replaceAll('/', path.sep)
 }
+
+function stripLeadingSlash(href: string) {
+  if (href.startsWith('/')) href = href.slice(1)
+  return href
+}
+
+function stripTrailingSlash(href: string) {
+  if (href.endsWith('/')) href = href.slice(0, -1)
+  return href
+}
+
+export function stripLeadingAndTrailingSlashes(href: string): string {
+  return stripTrailingSlash(stripLeadingSlash(href))
+}

package/libs/starlight.ts

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises'
 import path from 'node:path'
 
-import type { StarlightUserConfig } from '@astrojs/starlight/types'
+import type { HookParameters, StarlightUserConfig } from '@astrojs/starlight/types'
 import type { AstroIntegrationLogger } from 'astro'
 
 import type { StarlightObsidianConfig } from '..'
@@ -75,23 +75,39 @@ export function getSidebarGroupPlaceholder(label = starlightObsidianSidebarGroup
 
 export function getSidebarFromConfig(
   config: StarlightObsidianConfig,
-  sidebar: StarlightUserConfig['sidebar'],
+  starlightConfig: HookParameters<'config:setup'>['config'],
   sidebarGroupPlaceholder: SidebarGroup,
 ): StarlightUserConfig['sidebar'] {
-  if (!sidebar || sidebar.length === 0) {
-    return sidebar
+  if (!starlightConfig.sidebar || starlightConfig.sidebar.length === 0) {
+    return starlightConfig.sidebar
   }
 
   function replaceSidebarGroupPlaceholder(group: SidebarManualGroup): SidebarItem {
     if (group.label === sidebarGroupPlaceholder.label) {
-      return {
+      const defaultLocaleConfig = starlightConfig.locales?.[starlightConfig.defaultLocale ?? 'root']
+      const label =
+        typeof config.sidebar.label === 'string'
+          ? config.sidebar.label
+          : config.sidebar.label[defaultLocaleConfig?.lang ?? 'en']
+
+      if (!label || label.length === 0) {
+        throw new Error('The generated vault pages sidebar group label must have a key for the default language.')
+      }
+
+      const group: SidebarGroup = {
         autogenerate: {
           collapsed: config.sidebar.collapsedFolders ?? config.sidebar.collapsed,
           directory: config.output,
         },
         collapsed: config.sidebar.collapsed,
-        label: config.sidebar.label,
+        label,
       }
+
+      if (typeof config.sidebar.label !== 'string') {
+        group['translations'] = config.sidebar.label
+      }
+
+      return group
     }
 
     if (isSidebarGroup(group)) {
@@ -106,7 +122,7 @@ export function getSidebarFromConfig(
     return group
   }
 
-  return sidebar.map((item) => {
+  return starlightConfig.sidebar.map((item) => {
     return isSidebarGroup(item) ? replaceSidebarGroupPlaceholder(item) : item
   })
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starlight-obsidian",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "description": "Starlight plugin to publish Obsidian vaults.",
   "author": "HiDeoo <github@hideoo.dev> (https://hideoo.dev)",
@@ -55,8 +55,7 @@
   },
   "packageManager": "pnpm@8.14.1",
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "sideEffects": false,
   "keywords": [