starlight-obsidian 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # starlight-obsidian
 
+## 0.7.0
+
+### Minor Changes
+
+- [#37](https://github.com/HiDeoo/starlight-obsidian/pull/37) [`96f7cef`](https://github.com/HiDeoo/starlight-obsidian/commit/96f7cef43c4a08923c24221fbfb95b4ef840779f) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Adds support for running [multiple instances](https://starlight-obsidian.vercel.app/guides/multiple-instances/) of the plugin for different Obsidian vaults and configurations.
+
 ## 0.6.0
 
 ### Minor Changes

package/index.ts

@@ -1,3 +1,5 @@
+import { randomBytes } from 'node:crypto'
+
 import type { StarlightPlugin, StarlightUserConfig } from '@astrojs/starlight/types'
 import type { AstroIntegrationLogger } from 'astro'
 import { z } from 'astro/zod'
@@ -5,7 +7,7 @@ import { z } from 'astro/zod'
 import { starlightObsidianIntegration } from './libs/integration'
 import { getObsidianPaths, getVault } from './libs/obsidian'
 import { throwUserError } from './libs/plugin'
-import { addObsidianFiles, getSidebarFromConfig, getSidebarGroupPlaceholder } from './libs/starlight'
+import { addObsidianFiles, getSidebarFromConfig, getSidebarGroupPlaceholder, type SidebarGroup } from './libs/starlight'
 
 const starlightObsidianConfigSchema = z.object({
   /**
@@ -104,100 +106,119 @@ const starlightObsidianConfigSchema = z.object({
   vault: z.string(),
 })
 
+let pluginsCount = 0
+
 export const obsidianSidebarGroup = getSidebarGroupPlaceholder()
 
 export default function starlightObsidianPlugin(userConfig: StarlightObsidianUserConfig): StarlightPlugin {
-  const parsedConfig = starlightObsidianConfigSchema.safeParse(userConfig)
+  return makeStarlightObsidianPlugin(obsidianSidebarGroup)(userConfig)
+}
+
+export function createStarlightObsidianPlugin(): [plugin: typeof starlightObsidianPlugin, sidebarGroup: SidebarGroup] {
+  const sidebarGroup = getSidebarGroupPlaceholder(Symbol(randomBytes(24).toString('base64url')))
+  return [makeStarlightObsidianPlugin(sidebarGroup), sidebarGroup]
+}
+
+function makeStarlightObsidianPlugin(
+  sidebarGroup: SidebarGroup,
+): (userConfig: StarlightObsidianUserConfig) => StarlightPlugin {
+  pluginsCount++
+
+  return function starlightObsidianPlugin(userConfig) {
+    const parsedConfig = starlightObsidianConfigSchema.safeParse(userConfig)
 
-  if (!parsedConfig.success) {
-    const isUsingDeprecatedCopyStarlightFrontmatter = parsedConfig.error.issues.some(
-      (issue) => issue.path.join('.') === 'copyStarlightFrontmatter',
-    )
+    if (!parsedConfig.success) {
+      const isUsingDeprecatedCopyStarlightFrontmatter = parsedConfig.error.issues.some(
+        (issue) => issue.path.join('.') === 'copyStarlightFrontmatter',
+      )
+
+      if (isUsingDeprecatedCopyStarlightFrontmatter) {
+        throwUserError(
+          'The `copyStarlightFrontmatter` option has been deprecated in favor of the `copyFrontmatter` option.',
+          'For more information see https://starlight-obsidian.vercel.app/configuration/#copyfrontmatter',
+        )
+      }
 
-    if (isUsingDeprecatedCopyStarlightFrontmatter) {
       throwUserError(
-        'The `copyStarlightFrontmatter` option has been deprecated in favor of the `copyFrontmatter` option.',
-        'For more information see https://starlight-obsidian.vercel.app/configuration/#copyfrontmatter',
+        `The provided plugin configuration is invalid.\n${parsedConfig.error.issues.map((issue) => issue.message).join('\n')}`,
       )
     }
 
-    throwUserError(
-      `The provided plugin configuration is invalid.\n${parsedConfig.error.issues.map((issue) => issue.message).join('\n')}`,
-    )
-  }
+    const config = parsedConfig.data
+
+    return {
+      name: 'starlight-obsidian-plugin',
+      hooks: {
+        async setup({ addIntegration, command, config: starlightConfig, logger, updateConfig }) {
+          if (command !== 'build' && command !== 'dev') {
+            return
+          }
+
+          const customCss = [...(starlightConfig.customCss ?? []), 'starlight-obsidian/styles/common']
+
+          if (config.autoLinkHeadings) {
+            customCss.push('starlight-obsidian/styles/autolinks-headings')
+          }
+
+          const updatedStarlightConfig: Partial<StarlightUserConfig> = {
+            components: starlightConfig.components,
+            customCss,
+            sidebar: getSidebarFromConfig(config, starlightConfig.sidebar, sidebarGroup),
+          }
 
-  const config = parsedConfig.data
-
-  return {
-    name: 'starlight-obsidian-plugin',
-    hooks: {
-      async setup({ addIntegration, command, config: starlightConfig, logger, updateConfig }) {
-        if (command !== 'build' && command !== 'dev') {
-          return
-        }
-
-        const customCss = [...(starlightConfig.customCss ?? []), 'starlight-obsidian/styles/common']
-
-        if (config.autoLinkHeadings) {
-          customCss.push('starlight-obsidian/styles/autolinks-headings')
-        }
-
-        const updatedStarlightConfig: Partial<StarlightUserConfig> = {
-          components: starlightConfig.components,
-          customCss,
-          sidebar: getSidebarFromConfig(config, starlightConfig.sidebar),
-        }
-
-        if (!updatedStarlightConfig.components) {
-          updatedStarlightConfig.components = {}
-        }
-
-        if (starlightConfig.components?.PageTitle) {
-          logComponentOverrideWarning(logger, 'PageTitle')
-        } else {
-          updatedStarlightConfig.components.PageTitle = 'starlight-obsidian/overrides/PageTitle.astro'
-        }
-
-        if (config.tableOfContentsOverview === 'title') {
-          if (starlightConfig.components?.PageSidebar) {
-            logComponentOverrideWarning(logger, 'PageSidebar')
+          if (!updatedStarlightConfig.components) {
+            updatedStarlightConfig.components = {}
+          }
+
+          if (starlightConfig.components?.PageTitle) {
+            logComponentOverrideWarning(logger, 'PageTitle')
           } else {
-            updatedStarlightConfig.components.PageSidebar = 'starlight-obsidian/overrides/PageSidebar.astro'
+            updatedStarlightConfig.components.PageTitle = 'starlight-obsidian/overrides/PageTitle.astro'
+          }
+
+          if (config.tableOfContentsOverview === 'title') {
+            if (starlightConfig.components?.PageSidebar) {
+              logComponentOverrideWarning(logger, 'PageSidebar')
+            } else {
+              updatedStarlightConfig.components.PageSidebar = 'starlight-obsidian/overrides/PageSidebar.astro'
+            }
           }
-        }
-
-        if (config.skipGeneration) {
-          logger.warn(
-            `Skipping generation of Starlight pages from Obsidian vault as the 'skipGeneration' option is enabled.`,
-          )
-        } else {
-          try {
-            const start = performance.now()
-            logger.info('Generating Starlight pages from Obsidian vault…')
-
-            const vault = await getVault(config)
-            const obsidianPaths = await getObsidianPaths(vault, config.ignore)
-            await addObsidianFiles(config, vault, obsidianPaths, logger)
-
-            const duration = Math.round(performance.now() - start)
-            logger.info(`Starlight pages generated from Obsidian vault in ${duration}ms.`)
-          } catch (error) {
-            logger.error(error instanceof Error ? error.message : String(error))
-
-            throwUserError('Failed to generate Starlight pages from Obsidian vault.')
+
+          if (config.skipGeneration) {
+            logger.warn(
+              `Skipping generation of Starlight pages from Obsidian vault as the 'skipGeneration' option is enabled.`,
+            )
+          } else {
+            try {
+              const start = performance.now()
+              logger.info(`Generating Starlight pages from Obsidian vault at '${config.vault}'…`)
+
+              const vault = await getVault(config)
+              const obsidianPaths = await getObsidianPaths(vault, config.ignore)
+              await addObsidianFiles(config, vault, obsidianPaths, logger)
+
+              const duration = Math.round(performance.now() - start)
+              logger.info(`Starlight pages generated from Obsidian vault at '${config.vault}' in ${duration}ms.`)
+            } catch (error) {
+              logger.error(error instanceof Error ? error.message : String(error))
+
+              throwUserError(`Failed to generate Starlight pages from Obsidian vault at '${config.vault}'.`)
+            }
           }
-        }
 
-        addIntegration(starlightObsidianIntegration(config))
-        updateConfig(updatedStarlightConfig)
+          addIntegration(starlightObsidianIntegration(config))
+          updateConfig(updatedStarlightConfig)
+        },
       },
-    },
+    }
   }
 }
 
 function logComponentOverrideWarning(logger: AstroIntegrationLogger, component: string) {
-  logger.warn(`It looks like you already have a \`${component}\` component override in your Starlight configuration.`)
-  logger.warn(`To use \`starlight-obsidian\`, remove the override for the \`${component}\` component.\n`)
+  if (pluginsCount < 2) {
+    logger.warn(`It looks like you already have a \`${component}\` component override in your Starlight configuration.`)
+    logger.warn(`To use \`starlight-obsidian\`, remove the override for the \`${component}\` component.\n`)
+  }
 }
 
 export type StarlightObsidianUserConfig = z.input<typeof starlightObsidianConfigSchema>

package/libs/starlight.ts

@@ -66,23 +66,24 @@ const starlightFrontmatterKeys = [
   'sidebar',
 ]
 
-export function getSidebarGroupPlaceholder(): SidebarManualGroup {
+export function getSidebarGroupPlaceholder(label = starlightObsidianSidebarGroupLabel): SidebarManualGroup {
   return {
     items: [],
-    label: starlightObsidianSidebarGroupLabel.toString(),
+    label: label.toString(),
   }
 }
 
 export function getSidebarFromConfig(
   config: StarlightObsidianConfig,
   sidebar: StarlightUserConfig['sidebar'],
+  sidebarGroupPlaceholder: SidebarGroup,
 ): StarlightUserConfig['sidebar'] {
   if (!sidebar || sidebar.length === 0) {
     return sidebar
   }
 
-  function replaceSidebarGroupPlaceholder(group: SidebarManualGroup): SidebarGroup {
-    if (group.label === starlightObsidianSidebarGroupLabel.toString()) {
+  function replaceSidebarGroupPlaceholder(group: SidebarManualGroup): SidebarItem {
+    if (group.label === sidebarGroupPlaceholder.label) {
       return {
         autogenerate: {
           collapsed: config.sidebar.collapsedFolders ?? config.sidebar.collapsed,
@@ -279,7 +280,7 @@ function throwVaultFileError(error: unknown, vaultFile: VaultFile): never {
   throw new Error(`${vaultFile.path} — ${error instanceof Error ? error.message : String(error)}`, { cause: error })
 }
 
-function isSidebarGroup(item: SidebarGroup): item is SidebarManualGroup {
+function isSidebarGroup(item: SidebarItem): item is SidebarManualGroup {
   return typeof item === 'object' && 'items' in item
 }
 
@@ -294,4 +295,5 @@ interface SidebarManualGroup {
   label: string
 }
 
-type SidebarGroup = NonNullable<StarlightUserConfig['sidebar']>[number]
+type SidebarItem = NonNullable<StarlightUserConfig['sidebar']>[number]
+export type SidebarGroup = Exclude<SidebarItem, string>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "starlight-obsidian",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "description": "Starlight plugin to publish Obsidian vaults.",
   "author": "HiDeoo <github@hideoo.dev> (https://hideoo.dev)",