@feugene/granularity 0.1.0 → 0.3.0

package/dist/types/src/granular-provider/shared.d.ts

@@ -0,0 +1,85 @@
+import { type GranularComponentDescriptor, type GranularProvider } from '@feugene/unocss-preset-granular/contract';
+/** Идентификатор провайдера — совпадает с именем пакета. */
+export declare const GRANULARITY_PROVIDER_ID = "@feugene/granularity";
+/** Встроенные темы пакета. Единственный источник правды о списке тем. */
+export declare const granularityThemeNames: readonly ["light", "dark"];
+export type GranularityThemeName = (typeof granularityThemeNames)[number];
+/** Темы, активные по умолчанию, если окружение не переопределяет выбор. */
+export declare const granularityDefaultThemes: readonly GranularityThemeName[];
+/**
+ * Полный реестр публичных компонентов пакета `@feugene/granularity`.
+ *
+ * Ключи — имена компонентов (совпадают с публичным subpath‑экспортом
+ * `@feugene/granularity/components/<Name>`). Значения — browser‑safe
+ * `ds<Name>Config` из `./config.ts` рядом с SFC.
+ *
+ * Для компонентов, у которых есть node-only вариант конфига
+ * (например, `DsButton` с `tokenDefinitionsFromCssSync`), browser‑конфиг
+ * остаётся здесь, а node‑вариант подставляется снаружи через
+ * `createGranularityProvider(overrides)` — см. `./index.ts` (browser)
+ * и `./node.ts` (node).
+ *
+ * Формат записи `<Name>: ds<Name>Config` критичен для regex‑парсинга
+ * в `apps/showcase/scripts/generate-component-api.mjs`, не ломайте его.
+ */
+export declare const granularityComponentConfigs: {
+    DsAlert: GranularComponentDescriptor<"DsAlert">;
+    DsAvatar: GranularComponentDescriptor<"DsAvatar">;
+    DsBadge: GranularComponentDescriptor<"DsBadge">;
+    DsBadgeWrap: GranularComponentDescriptor<"DsBadgeWrap">;
+    DsBottomNav: GranularComponentDescriptor<"DsBottomNav">;
+    DsButton: GranularComponentDescriptor<"DsButton">;
+    DsButtonGroup: GranularComponentDescriptor<"DsButtonGroup">;
+    DsCard: GranularComponentDescriptor<"DsCard">;
+    DsCheckbox: GranularComponentDescriptor<"DsCheckbox">;
+    DsCollapse: GranularComponentDescriptor<"DsCollapse">;
+    DsConfirmDialog: GranularComponentDescriptor<"DsConfirmDialog">;
+    DsDataTable: GranularComponentDescriptor<"DsDataTable">;
+    DsDialog: GranularComponentDescriptor<"DsDialog">;
+    DsDrawer: GranularComponentDescriptor<"DsDrawer">;
+    DsDropdown: GranularComponentDescriptor<"DsDropdown">;
+    DsDropdownMenu: GranularComponentDescriptor<"DsDropdownMenu">;
+    DsEmptyState: GranularComponentDescriptor<"DsEmptyState">;
+    DsFileUpload: GranularComponentDescriptor<"DsFileUpload">;
+    DsFormField: GranularComponentDescriptor<"DsFormField">;
+    DsFormFile: GranularComponentDescriptor<"DsFormFile">;
+    DsFormSection: GranularComponentDescriptor<"DsFormSection">;
+    DsIcon: GranularComponentDescriptor<"DsIcon">;
+    DsImageViewer: GranularComponentDescriptor<"DsImageViewer">;
+    DsInput: GranularComponentDescriptor<"DsInput">;
+    DsInputTag: GranularComponentDescriptor<"DsInputTag">;
+    DsLink: GranularComponentDescriptor<"DsLink">;
+    DsList: GranularComponentDescriptor<"DsList">;
+    DsLoading: GranularComponentDescriptor<"DsLoading">;
+    DsModal: GranularComponentDescriptor<"DsModal">;
+    DsNavbar: GranularComponentDescriptor<"DsNavbar">;
+    DsNumberInput: GranularComponentDescriptor<"DsNumberInput">;
+    DsPagination: GranularComponentDescriptor<"DsPagination">;
+    DsProgressBar: GranularComponentDescriptor<"DsProgressBar">;
+    DsPromptDialog: GranularComponentDescriptor<"DsPromptDialog">;
+    DsRadio: GranularComponentDescriptor<"DsRadio">;
+    DsRadioGroup: GranularComponentDescriptor<"DsRadioGroup">;
+    DsSegmented: GranularComponentDescriptor<"DsSegmented">;
+    DsSelect: GranularComponentDescriptor<"DsSelect">;
+    DsSidebar: GranularComponentDescriptor<"DsSidebar">;
+    DsSkeleton: GranularComponentDescriptor<"DsSkeleton">;
+    DsSwitch: GranularComponentDescriptor<"DsSwitch">;
+    DsTable: GranularComponentDescriptor<"DsTable">;
+    DsTabs: GranularComponentDescriptor<"DsTabs">;
+    DsTextarea: GranularComponentDescriptor<"DsTextarea">;
+    DsToaster: GranularComponentDescriptor<"DsToaster">;
+    DsTooltip: GranularComponentDescriptor<"DsTooltip">;
+    DsTree: GranularComponentDescriptor<"DsTree">;
+    DsTreeSelect: GranularComponentDescriptor<"DsTreeSelect">;
+};
+export type GranularityComponentName = keyof typeof granularityComponentConfigs;
+/**
+ * Собирает granular-provider пакета `@feugene/granularity`.
+ *
+ * Принимает массив `GranularComponentDescriptor`'ов — это компоненты,
+ * у которых есть node-only вариант конфига (например, `DsButton` с
+ * `tokenDefinitionsFromCssSync`). Дескрипторы с именем, которое уже
+ * присутствует в базовом наборе, переопределяют его (побеждает
+ * переданный снаружи), остальные — добавляются в конец списка.
+ */
+export declare function createGranularityProvider(overrides?: readonly GranularComponentDescriptor[]): GranularProvider;

package/dist/types/src/i18n/messages.d.ts

@@ -48,6 +48,8 @@ export declare const dsLocaleLoaders: {
                     danger: string;
                     info: string;
                     primary: string;
+                    slate: string;
+                    azure: string;
                 };
             };
             common: {
@@ -89,6 +91,8 @@ export declare const dsLocaleLoaders: {
                 danger: string;
                 info: string;
                 primary: string;
+                slate: string;
+                azure: string;
             };
         }>;
     };
@@ -134,6 +138,8 @@ export declare const dsLocaleLoaders: {
                     danger: string;
                     info: string;
                     primary: string;
+                    slate: string;
+                    azure: string;
                 };
             };
             common: {
@@ -175,6 +181,8 @@ export declare const dsLocaleLoaders: {
                 danger: string;
                 info: string;
                 primary: string;
+                slate: string;
+                azure: string;
             };
         }>;
     };
@@ -220,6 +228,8 @@ export declare const dsLocaleLoaders: {
                     danger: string;
                     info: string;
                     primary: string;
+                    slate: string;
+                    azure: string;
                 };
             };
             common: {
@@ -261,6 +271,8 @@ export declare const dsLocaleLoaders: {
                 danger: string;
                 info: string;
                 primary: string;
+                slate: string;
+                azure: string;
             };
         }>;
     };

package/dist/types/src/index.d.ts

@@ -6,54 +6,49 @@ export * from './components/DsBottomNav';
 export * from './components/DsButton';
 export * from './components/DsButtonGroup';
 export * from './components/DsCard';
+export * from './components/DsCheckbox';
 export * from './components/DsCollapse';
 export * from './components/DsConfirmDialog';
-export * from './components/DsCheckbox';
 export * from './components/DsDataTable';
+export * from './components/DsDialog';
 export * from './components/DsDrawer';
 export * from './components/DsDropdown';
 export * from './components/DsDropdownMenu';
-export { default as DsDialog } from './components/DsDialog';
-export { dsDialogSafelist } from './components/DsDialog';
-export type { DsDialogSectionConfig, DsDialogSize } from './components/DsDialog';
 export * from './components/DsEmptyState';
 export * from './components/DsFileUpload';
-export * from './components/DsFormFile';
 export * from './components/DsFormField';
+export * from './components/DsFormFile';
 export * from './components/DsFormSection';
 export * from './components/DsIcon';
 export * from './components/DsImageViewer';
 export * from './components/DsInput';
-export * from './components/DsNumberInput';
 export * from './components/DsInputTag';
-export * from './components/DsList';
 export * from './components/DsLink';
+export * from './components/DsList';
 export * from './components/DsLoading';
-export { default as DsModal } from './components/DsModal';
-export { dsModalConfig } from './components/DsModal';
-export { dsModalClassTokens, dsModalSafelist, getDsModalPanelClass } from './components/DsModal';
+export * from './components/DsModal';
 export * from './components/DsNavbar';
+export * from './components/DsNumberInput';
 export * from './components/DsPagination';
 export * from './components/DsProgressBar';
 export * from './components/DsPromptDialog';
 export * from './components/DsRadio';
 export * from './components/DsRadioGroup';
+export * from './components/DsSegmented';
 export * from './components/DsSelect';
 export * from './components/DsSidebar';
 export * from './components/DsSkeleton';
-export * from './components/DsSegmented';
 export * from './components/DsSwitch';
 export * from './components/DsTable';
 export * from './components/DsTabs';
-export * from './components/DsToaster';
 export * from './components/DsTextarea';
+export * from './components/DsToaster';
+export * from './components/DsTooltip';
 export * from './components/DsTree';
 export * from './components/DsTreeSelect';
-export * from './components/DsTooltip';
-export * from './directives';
-export * from './fileValidation';
-export * from './i18n';
 export { initThemeEarly, useTheme } from './composables/useTheme';
 export type { ThemeName, UseThemeOptions } from './composables/useTheme';
 export { useToast } from './composables/useToast';
 export type { Toast, ToastInput, ToastVariant } from './composables/useToast';
+export type * from './fileValidation/types';
+export * from './directives';

package/dist/types/src/vue/index.d.ts

@@ -0,0 +1,2 @@
+export { createGranularity, defineInstallable, installGranularity, } from './plugin';
+export type { CreateGranularityOptions, GranularityInstallableComponent, GranularityInstallableDirective, } from './plugin';

package/dist/types/src/vue/plugin.d.ts

@@ -0,0 +1,92 @@
+import type { App, Component, Directive, Plugin } from 'vue';
+/**
+ * Лёгкий контейнер, который может быть зарегистрирован в Vue:
+ * - SFC-компонент (Vue сам компилирует `__name` из имени файла) — достаточно просто передать сам компонент,
+ * - SFC-компонент с опциональным `install` (по аналогии с Element Plus / Naive UI),
+ * - объект с собственным `install`,
+ * - либо объект `{ name, component }`, если имя нужно задать явно.
+ */
+export type GranularityInstallableComponent = (Component & {
+    name?: string;
+    __name?: string;
+    install?: (app: App) => void;
+}) | {
+    install: (app: App) => void;
+} | {
+    name: string;
+    component: Component;
+};
+/**
+ * Директива — либо пара `{ name, directive }`, либо объект с `install`.
+ */
+export type GranularityInstallableDirective = {
+    name: string;
+    directive: Directive;
+} | {
+    install: (app: App) => void;
+};
+export interface CreateGranularityOptions {
+    /**
+     * Список компонентов для глобальной регистрации.
+     * Пакет сам по себе ничего не импортирует — пользователь передаёт сюда только те компоненты,
+     * которые ему действительно нужны. За счёт этого tree-shaking остаётся полным.
+     */
+    components?: GranularityInstallableComponent[];
+    /**
+     * Список директив. Передавайте ровно те, что нужны, по аналогии с компонентами.
+     */
+    directives?: GranularityInstallableDirective[];
+    /**
+     * Произвольные `provide`-значения. Ключи могут быть `symbol` или строкой.
+     * Пакет не навязывает конкретные ключи (например, i18n) — выбор за пользователем.
+     */
+    provides?: Array<{
+        key: string | symbol;
+        value: unknown;
+    }>;
+    /**
+     * Произвольные `app.config.globalProperties` — по умолчанию ничего не ставим.
+     */
+    globalProperties?: Record<string, unknown>;
+}
+/**
+ * Вспомогательная обёртка: превращает произвольный компонент в `GranularityInstallableComponent`
+ * с явным именем регистрации.
+ *
+ * ```ts
+ * import { DsButton } from '@feugene/granularity/components/DsButton'
+ * import { defineInstallable } from '@feugene/granularity/vue'
+ *
+ * const installable = defineInstallable(DsButton, 'DsButton')
+ * ```
+ */
+export declare function defineInstallable<T extends Component>(component: T, name: string): GranularityInstallableComponent;
+/**
+ * Применяет опции к переданному приложению. Экспортируется отдельно от фабрики —
+ * удобно, когда плагин не нужен (например, в тестах).
+ */
+export declare function installGranularity(app: App, options?: CreateGranularityOptions): void;
+/**
+ * Создаёт Vue-плагин `{ install }`, который при `app.use(...)` зарегистрирует переданные
+ * компоненты, директивы и provide-значения. Сам модуль НЕ импортирует ни компонентов,
+ * ни директив из пакета — всё приходит снаружи. Это сохраняет гранулярность:
+ * бандлер увидит только те символы, которые вы реально передали.
+ *
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { createGranularity } from '@feugene/granularity/vue'
+ * import { DsButton } from '@feugene/granularity/components/DsButton'
+ * import { DsInput }  from '@feugene/granularity/components/DsInput'
+ * import { vHotkey }  from '@feugene/granularity/directives/hotkey'
+ *
+ * createApp(App)
+ *   .use(createGranularity({
+ *     // Достаточно передать сами компоненты — имя будет взято из `__name` (Vue SFC)
+ *     // или из `name`; можно также указать явно через `{ name, component }`.
+ *     components: [DsButton, DsInput],
+ *     directives: [{ name: 'hotkey', directive: vHotkey }],
+ *   }))
+ *   .mount('#app')
+ * ```
+ */
+export declare function createGranularity(options?: CreateGranularityOptions): Plugin;

package/dist/vue/index.js

@@ -0,0 +1,47 @@
+//#region src/vue/plugin.ts
+function e(e, t) {
+	return { install(n) {
+		n.component(t, e);
+	} };
+}
+function t(e, t) {
+	if (typeof t.install == "function") {
+		t.install(e);
+		return;
+	}
+	if (typeof t.name == "string" && t.component && (typeof t.component == "object" || typeof t.component == "function")) {
+		let { name: n, component: r } = t;
+		e.component(n, r);
+		return;
+	}
+	let n = t.name ?? t.__name;
+	if (n) {
+		e.component(n, t);
+		return;
+	}
+	console.warn("[granularity] component passed to createGranularity has no `install`, `name`, or `__name` — skipped.");
+}
+function n(e, t) {
+	if ("install" in t && typeof t.install == "function") {
+		t.install(e);
+		return;
+	}
+	if ("name" in t && "directive" in t) {
+		e.directive(t.name, t.directive);
+		return;
+	}
+	console.warn("[granularity] directive passed to createGranularity has no `install` or `{ name, directive }` — skipped.");
+}
+function r(e, r = {}) {
+	for (let n of r.components ?? []) t(e, n);
+	for (let t of r.directives ?? []) n(e, t);
+	for (let { key: t, value: n } of r.provides ?? []) e.provide(t, n);
+	if (r.globalProperties) for (let [t, n] of Object.entries(r.globalProperties)) e.config.globalProperties[t] = n;
+}
+function i(e = {}) {
+	return { install(t) {
+		r(t, e);
+	} };
+}
+//#endregion
+export { i as createGranularity, e as defineInstallable, r as installGranularity };