@bndynet/vue-site 1.4.0 → 1.4.1

package/dist/create-app.d.ts

@@ -1,2 +1,11 @@
 import { SiteConfig } from './types';
+/**
+ * Returns the site config passed to `createSiteApp()`. Can be called from anywhere — plain
+ * modules, `bootstrap.ts` (after the app is created), utility functions, etc. — without a Vue
+ * injection context. Returns `undefined` if `createSiteApp` has not been called yet.
+ *
+ * For reactive, component-scoped access to the full `SiteContext` (config + nav + refreshAuthNav),
+ * use {@link useSiteConfig} inside a Vue component instead.
+ */
+export declare function getSiteConfig(): SiteConfig | undefined;
 export declare function createSiteApp(config: SiteConfig): Promise<import('vue').App<Element>>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { SiteConfig } from './types';
-export { createSiteApp } from './create-app';
+export { createSiteApp, getSiteConfig } from './create-app';
 export { useTheme, themeRefKey } from './composables/useTheme';
 export { useLocale, localeRefKey } from './composables/useLocale';
 export { useLocalize } from './composables/useLocalize';
@@ -10,4 +10,22 @@ export { useSiteConfig } from './composables/useSiteConfig';
 export { builtinThemePalettes } from './theme/presets';
 export { ElMessage, ElMessageBox, ElNotification, } from 'element-plus';
 export type { SiteConfig, SiteEnvConfig, SiteViteConfig, SiteCustomConfig, SiteExternalLink, ShellConfig, ShellAction, ShellActionLoader, NavItem, StandalonePage, PageLayout, AuthRule, AuthContext, AuthConfig, RouterConfig, ThemeConfig, ThemeOption, ThemePaletteVars, ResolvedNavItem, LocaleCode, LocalizedString, IconRegistry, MessageRef, MessageTree, LocaleOption, I18nConfig, PageLoader, } from './types';
+/**
+ * Type-safe identity for a single config object. Use the single-argument form for a standalone
+ * config file.
+ *
+ * When composing multiple config files (e.g. `site.config.prod.ts` importing a shared
+ * `site.config.common.ts`), use the two-argument form so `custom` is deep-merged: properties
+ * from the base `custom` are preserved unless explicitly overridden.
+ *
+ * @example
+ * // site.config.common.ts
+ * export default defineConfig({ custom: { apiBaseUrl: '/api', appName: 'MyApp' }, ... })
+ *
+ * // site.config.prod.ts
+ * import common from './site.config.common'
+ * export default defineConfig(common, { custom: { apiBaseUrl: 'https://prod.example.com/api' } })
+ * // Result: custom.apiBaseUrl is overridden, custom.appName is preserved.
+ */
 export declare function defineConfig(config: SiteConfig): SiteConfig;
+export declare function defineConfig(base: SiteConfig, overrides: Partial<SiteConfig>): SiteConfig;