@wordrhyme/plugin 0.1.0-alpha.5

package/dist/client-WXWbuuvd.d.ts

@@ -0,0 +1,100 @@
+import './manifest-CPSCN_Ft.js';
+
+type ComponentType = (props: any) => any;
+type Target = NavTarget | NavGroupTarget | RouteTarget | SettingsTarget | DashboardTarget | GenericTarget;
+interface NavTarget {
+    slot: 'nav.sidebar';
+    path: string;
+    icon?: string;
+    order?: number;
+    requiredPermission?: string;
+    parent?: string;
+}
+interface NavGroupTarget {
+    slot: 'nav.sidebar.group';
+    path?: string;
+    icon?: string;
+    order?: number;
+}
+interface RouteTarget {
+    slot: 'plugin.route';
+    path: string;
+    order?: number;
+    params?: Record<string, string>;
+}
+interface SettingsTarget {
+    slot: 'settings.plugin';
+    category?: string;
+    order?: number;
+    visibility?: 'platform' | 'all';
+}
+interface DashboardTarget {
+    slot: 'dashboard.widgets' | 'dashboard.overview';
+    order?: number;
+    colSpan?: 1 | 2 | 3 | 4;
+}
+interface GenericTarget {
+    slot: string;
+    order?: number;
+}
+interface SlotContext {
+    [key: string]: unknown;
+}
+interface UIExtensionDef {
+    id: string;
+    label: string;
+    icon?: string;
+    category?: string;
+    component?: ComponentType;
+    remoteComponent?: string;
+    targets: Target[];
+    /** If true, the extension is registered for component matching but hidden from sidebar */
+    hidden?: boolean;
+}
+type ExtensionComponentMap = Record<string, ComponentType>;
+type ToolbarHandlerMap = Record<string, () => void>;
+declare function defineExtension(ext: UIExtensionDef): UIExtensionDef;
+declare function navExtension(ext: {
+    id: string;
+    label: string;
+    icon?: string;
+    component?: ComponentType;
+    remoteComponent?: string;
+    path: string;
+    order?: number;
+    requiredPermission?: string;
+    /** If true, registers component but hides from sidebar (menu managed by host) */
+    hidden?: boolean;
+}): UIExtensionDef;
+declare function routeExtension(ext: {
+    id: string;
+    label: string;
+    icon?: string;
+    component?: ComponentType;
+    remoteComponent?: string;
+    path: string;
+    order?: number;
+    params?: Record<string, string>;
+}): UIExtensionDef;
+declare function settingsExtension(ext: {
+    id: string;
+    label: string;
+    icon?: string;
+    component?: ComponentType;
+    remoteComponent?: string;
+    order?: number;
+    category?: string;
+    visibility?: 'platform' | 'all';
+}): UIExtensionDef;
+declare function dashboardExtension(ext: {
+    id: string;
+    label: string;
+    icon?: string;
+    component?: ComponentType;
+    remoteComponent?: string;
+    order?: number;
+    colSpan?: 1 | 2 | 3 | 4;
+}): UIExtensionDef;
+declare function multiSlotExtension(ext: UIExtensionDef): UIExtensionDef;
+
+export { type DashboardTarget as D, type ExtensionComponentMap as E, type GenericTarget as G, type NavGroupTarget as N, type RouteTarget as R, type SettingsTarget as S, type Target as T, type UIExtensionDef as U, type NavTarget as a, type SlotContext as b, type ToolbarHandlerMap as c, dashboardExtension as d, defineExtension as e, multiSlotExtension as m, navExtension as n, routeExtension as r, settingsExtension as s };

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+export { D as DashboardTarget, G as GenericTarget, a as NavTarget, S as SettingsTarget, b as SlotContext, T as Target, U as UIExtensionDef, d as dashboardExtension, e as defineExtension, m as multiSlotExtension, n as navExtension, s as settingsExtension } from './client-WXWbuuvd.js';
+export { d as AggregationStrategy, l as PluginCapabilities, P as PluginManifest, m as PluginNotificationType, n as PluginStatus, z as adminExtensionSchema, L as dashboardTargetSchema, T as navTargetSchema, V as pluginManifestSchema, Z as settingsTargetSchema, _ as targetSchema } from './manifest-CPSCN_Ft.js';
+import 'zod';

package/dist/client.js

@@ -0,0 +1,29 @@
+import {
+  dashboardExtension,
+  defineExtension,
+  multiSlotExtension,
+  navExtension,
+  settingsExtension
+} from "./chunk-MZOLSLJ7.js";
+import {
+  adminExtensionSchema,
+  dashboardTargetSchema,
+  navTargetSchema,
+  pluginManifestSchema,
+  settingsTargetSchema,
+  targetSchema
+} from "./chunk-QNCOGISF.js";
+export {
+  adminExtensionSchema,
+  dashboardExtension,
+  dashboardTargetSchema,
+  defineExtension,
+  multiSlotExtension,
+  navExtension,
+  navTargetSchema,
+  pluginManifestSchema,
+  settingsExtension,
+  settingsTargetSchema,
+  targetSchema
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/dev-utils.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Plugin Development Utilities
+ *
+ * Shared utilities for plugin development, including automatic port assignment.
+ */
+type PluginRemoteSurface = 'admin' | 'web';
+interface ResolvedPluginRemoteEntry {
+    remoteEntry: string;
+    source: 'dev' | 'manifest';
+}
+interface ResolvePluginRemoteEntryOptions {
+    pluginId: string;
+    manifestRemoteEntry: string;
+    devRemoteEntry?: string | undefined;
+    surface?: PluginRemoteSurface | undefined;
+    isDev?: boolean | undefined;
+    probeTimeoutMs?: number | undefined;
+    entryChunkPaths?: readonly string[] | undefined;
+}
+/**
+ * Calculate a deterministic dev port for a plugin based on its ID.
+ *
+ * This allows multiple plugins to run simultaneously without port conflicts,
+ * while keeping the port assignment automatic and predictable.
+ *
+ * Port range: 3010-3109 (100 possible ports)
+ *
+ * @param pluginId - Full plugin ID (e.g., "com.wordrhyme.hello-world")
+ * @returns Port number for the plugin's dev server
+ *
+ * @example
+ * getPluginDevPort('com.wordrhyme.hello-world')  // e.g., 3042
+ * getPluginDevPort('com.wordrhyme.analytics')    // e.g., 3015
+ */
+declare function getPluginDevPort(pluginId: string): number;
+/**
+ * Get the dev remote entry URL for a plugin.
+ *
+ * @param pluginId - Full plugin ID
+ * @returns Full URL to the plugin's remoteEntry.js in dev mode
+ */
+declare function getPluginDevRemoteEntry(pluginId: string): string;
+/**
+ * Calculate a deterministic public web dev port for a plugin.
+ *
+ * Public web remotes run beside admin remotes, so they use the same stable
+ * plugin hash with a +100 offset.
+ */
+declare function getPluginWebDevPort(pluginId: string): number;
+/**
+ * Get the public web dev remote entry URL for a plugin.
+ */
+declare function getPluginWebDevRemoteEntry(pluginId: string): string;
+/**
+ * Normalize plugin ID to a valid Module Federation name.
+ *
+ * MF names must be valid JavaScript identifiers.
+ * "com.wordrhyme.hello-world" → "plugin_hello_world"
+ *
+ * @param pluginId - Full plugin ID
+ * @returns Valid MF module name
+ */
+declare function getPluginMfName(pluginId: string): string;
+declare function isPluginDevRemoteEnabled(pluginId: string): boolean;
+declare function resolvePluginRemoteEntry({ pluginId, manifestRemoteEntry, devRemoteEntry, surface, isDev, probeTimeoutMs, entryChunkPaths, }: ResolvePluginRemoteEntryOptions): Promise<ResolvedPluginRemoteEntry>;
+declare function appendRemoteEntryCacheBust(remoteEntry: string, value: string | number): string;
+
+export { type PluginRemoteSurface, type ResolvePluginRemoteEntryOptions, type ResolvedPluginRemoteEntry, appendRemoteEntryCacheBust, getPluginDevPort, getPluginDevRemoteEntry, getPluginMfName, getPluginWebDevPort, getPluginWebDevRemoteEntry, isPluginDevRemoteEnabled, resolvePluginRemoteEntry };

package/dist/dev-utils.js

@@ -0,0 +1,21 @@
+import {
+  appendRemoteEntryCacheBust,
+  getPluginDevPort,
+  getPluginDevRemoteEntry,
+  getPluginMfName,
+  getPluginWebDevPort,
+  getPluginWebDevRemoteEntry,
+  isPluginDevRemoteEnabled,
+  resolvePluginRemoteEntry
+} from "./chunk-YQDKOEUI.js";
+export {
+  appendRemoteEntryCacheBust,
+  getPluginDevPort,
+  getPluginDevRemoteEntry,
+  getPluginMfName,
+  getPluginWebDevPort,
+  getPluginWebDevRemoteEntry,
+  isPluginDevRemoteEnabled,
+  resolvePluginRemoteEntry
+};
+//# sourceMappingURL=dev-utils.js.map

package/dist/dev-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/entity-extensions-B5BbZH-m.d.ts

@@ -0,0 +1,56 @@
+import { E as EntityExtensionFieldType, a as EntityExtensionField } from './manifest-CPSCN_Ft.js';
+import { H as HookContext, a as PluginContext, b as HookHandlerOptions } from './types-8P7XyoyQ.js';
+
+/**
+ * Projection customization hook for entity extension values.
+ *
+ * Advanced plugins can listen to this hook to customize the projection that the
+ * framework persists. Normal plugins do not need to listen to it.
+ */
+declare const EXTENSION_PROJECT_SAVE_HOOK_ID = "extension.project.save";
+/** @deprecated Use EXTENSION_PROJECT_SAVE_HOOK_ID / "extension.project.save". */
+declare const ENTITY_EXTENSION_VALUES_SAVE_HOOK_ID = "entity.extension.values.save";
+interface EntityExtensionValueSavePayload {
+    ownerPluginId: string;
+    organizationId: string;
+    /** Global extension target id, e.g. "com.example.shop.stores". */
+    targetId: string;
+    entityId: string;
+    values: Record<string, unknown>;
+    fields: Record<string, EntityExtensionField & {
+        type: EntityExtensionFieldType;
+    }>;
+    projections?: EntityExtensionProjectionValue[];
+    storedByPluginId?: string;
+}
+interface EntityExtensionProjectionValue {
+    pluginId: string;
+    field: string;
+    type: EntityExtensionFieldType;
+    value: unknown;
+    display: string | null;
+    searchText?: string | null;
+    refEntity: string | null;
+    refId: string | null;
+}
+interface EntityExtensionValueSaveResult {
+    projections?: EntityExtensionProjectionValue[];
+    storedByPluginId?: string;
+}
+type EntityExtensionValueSaveHandler = (payload: EntityExtensionValueSavePayload, context: HookContext) => Promise<EntityExtensionValueSaveResult | undefined> | EntityExtensionValueSaveResult | undefined;
+/**
+ * @deprecated Use `ctx.hooks.on("extension.project.save", handler)`.
+ */
+declare function registerSaver(ctx: Pick<PluginContext, 'pluginId' | 'hooks'>, handler: EntityExtensionValueSaveHandler, options?: HookHandlerOptions): () => void;
+/**
+ * @deprecated Use `ctx.hooks.on("extension.project.save", handler)`.
+ */
+declare const entityExtensions: {
+    registerSaver: typeof registerSaver;
+};
+/**
+ * @deprecated Use `ctx.hooks.on("extension.project.save", handler)`.
+ */
+declare function registerEntityExtensionValueSaver(ctx: Pick<PluginContext, 'pluginId' | 'hooks'>, handler: EntityExtensionValueSaveHandler, options?: HookHandlerOptions): () => void;
+
+export { ENTITY_EXTENSION_VALUES_SAVE_HOOK_ID as E, EXTENSION_PROJECT_SAVE_HOOK_ID as a, type EntityExtensionProjectionValue as b, type EntityExtensionValueSaveHandler as c, type EntityExtensionValueSavePayload as d, type EntityExtensionValueSaveResult as e, entityExtensions as f, registerEntityExtensionValueSaver as r };

package/dist/globalization.d.ts

@@ -0,0 +1,80 @@
+export { default as Decimal } from 'decimal.js';
+
+type TextDirection = 'ltr' | 'rtl';
+type TranslationMessages = Record<string, string>;
+type I18nTextField = string | Record<string, string | null | undefined> | null | undefined;
+interface LanguageInfo {
+    locale: string;
+    name: string;
+    nativeName?: string | null | undefined;
+    isDefault?: boolean | undefined;
+    isEnabled?: boolean | undefined;
+    sortOrder?: number | null | undefined;
+    direction?: TextDirection | undefined;
+}
+interface CurrencyInfo {
+    code: string;
+    nameI18n: Record<string, string>;
+    symbol: string;
+    decimalDigits: number;
+    isBase: boolean;
+    currentRate: string | null;
+}
+type CurrencyInfoInput = {
+    code: string;
+    nameI18n?: Record<string, string> | null | undefined;
+    symbol?: string | null | undefined;
+    decimalDigits?: number | null | undefined;
+    isBase?: boolean | null | undefined;
+    currentRate?: string | null | undefined;
+};
+interface GlobalizationState {
+    locale: string;
+    direction: TextDirection;
+    availableLocales: string[];
+    languages?: LanguageInfo[] | undefined;
+    currency: string;
+    currencies: CurrencyInfo[];
+    baseCurrency: CurrencyInfo;
+    timezone?: string | undefined;
+    fallbackLocale?: string | undefined;
+    messages?: TranslationMessages | undefined;
+    t?: Translator | undefined;
+    p?: PriceFormatter | undefined;
+    changeLocale?: ((locale: string) => void | Promise<void>) | undefined;
+    changeCurrency?: ((currencyCode: string) => void | Promise<void>) | undefined;
+}
+interface FormatPriceOptions {
+    showSymbol?: boolean | undefined;
+    currencyDisplay?: 'symbol' | 'code' | 'name' | 'narrowSymbol' | undefined;
+    notation?: 'standard' | 'compact' | undefined;
+    signDisplay?: 'auto' | 'always' | 'exceptZero' | 'never' | undefined;
+    decimalDigits?: number | undefined;
+    locale?: string | undefined;
+    toCurrency?: string | CurrencyInfo | undefined;
+}
+type Translator = (key: string, paramsOrFallback?: Record<string, string | number> | string) => string;
+type PriceFormatter = (cents: number, fromCurrencyOrOptions?: string | CurrencyInfo | FormatPriceOptions, options?: FormatPriceOptions) => string;
+declare const DEFAULT_CURRENCY: CurrencyInfo;
+declare function getTextDirection(locale: string): TextDirection;
+declare function normalizeCurrencyInfo(currency: CurrencyInfoInput, fallback?: CurrencyInfo): CurrencyInfo;
+declare function normalizeCurrencies(currencies: readonly CurrencyInfoInput[]): CurrencyInfo[];
+declare function findCurrency(currencies: readonly CurrencyInfo[], currencyCode: string | undefined): CurrencyInfo | undefined;
+declare function getBaseCurrency(currencies: readonly CurrencyInfo[]): CurrencyInfo;
+declare function resolveCurrencyInfo(currency: string | CurrencyInfo | undefined, currencies: readonly CurrencyInfo[], fallback?: CurrencyInfo): CurrencyInfo;
+declare function bankersRound(value: number, decimalDigits: number): number;
+declare function toCents(displayAmount: number, decimalDigits: number): number;
+declare function fromCents(cents: number, decimalDigits: number): number;
+declare function convertCurrency(cents: number, fromCurrency: CurrencyInfo, toCurrency: CurrencyInfo, currenciesOrBaseCurrency: readonly CurrencyInfo[] | CurrencyInfo): number;
+declare function formatCurrencyAmount(cents: number, currency: CurrencyInfo, locale: string, options?: FormatPriceOptions): string;
+declare function formatPrice(cents: number, fromCurrency: string | CurrencyInfo, state: GlobalizationState, options?: FormatPriceOptions): string;
+declare function getI18nText(field: I18nTextField, locale: string, fallbackLocale?: string): string;
+declare function createTranslator(messages: TranslationMessages | undefined): Translator;
+declare function createPriceFormatter(state: GlobalizationState, defaultFromCurrency?: string | CurrencyInfo): PriceFormatter;
+declare function withGlobalizationHelpers(state: GlobalizationState, handlers?: Pick<GlobalizationState, 'changeLocale' | 'changeCurrency'>): GlobalizationState;
+declare function buildGlobalizationUrl(url: string | URL, updates: {
+    locale?: string | null | undefined;
+    currency?: string | null | undefined;
+}): string;
+
+export { type CurrencyInfo, type CurrencyInfoInput, DEFAULT_CURRENCY, type FormatPriceOptions, type GlobalizationState, type I18nTextField, type LanguageInfo, type PriceFormatter, type TextDirection, type TranslationMessages, type Translator, bankersRound, buildGlobalizationUrl, convertCurrency, createPriceFormatter, createTranslator, findCurrency, formatCurrencyAmount, formatPrice, fromCents, getBaseCurrency, getI18nText, getTextDirection, normalizeCurrencies, normalizeCurrencyInfo, resolveCurrencyInfo, toCents, withGlobalizationHelpers };

package/dist/globalization.js

@@ -0,0 +1,43 @@
+import {
+  DEFAULT_CURRENCY,
+  Decimal,
+  bankersRound,
+  buildGlobalizationUrl,
+  convertCurrency,
+  createPriceFormatter,
+  createTranslator,
+  findCurrency,
+  formatCurrencyAmount,
+  formatPrice,
+  fromCents,
+  getBaseCurrency,
+  getI18nText,
+  getTextDirection,
+  normalizeCurrencies,
+  normalizeCurrencyInfo,
+  resolveCurrencyInfo,
+  toCents,
+  withGlobalizationHelpers
+} from "./chunk-46KUIGB6.js";
+export {
+  DEFAULT_CURRENCY,
+  Decimal,
+  bankersRound,
+  buildGlobalizationUrl,
+  convertCurrency,
+  createPriceFormatter,
+  createTranslator,
+  findCurrency,
+  formatCurrencyAmount,
+  formatPrice,
+  fromCents,
+  getBaseCurrency,
+  getI18nText,
+  getTextDirection,
+  normalizeCurrencies,
+  normalizeCurrencyInfo,
+  resolveCurrencyInfo,
+  toCents,
+  withGlobalizationHelpers
+};
+//# sourceMappingURL=globalization.js.map

package/dist/globalization.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}