@kosdev-code/kos-ui-plugin 2.1.11 → 2.1.13

package/lib/hooks/use-extension-i18n.d.ts

@@ -2,12 +2,20 @@ import { ExtensionComponentProps } from './use-extension-component';
 import { PluginExtension } from '../../types/plugins';
 import { useKosTranslation } from '@kosdev-code/kos-ui-sdk';
 
+/**
+ * Base properties that all extension data includes
+ */
+export interface ExtensionBaseData {
+    id: string;
+    title: string;
+    namespace: string;
+}
 /**
  * Result from useExtensionI18n hook
  */
 export interface UseExtensionI18nResult<TData = unknown, TProps = unknown> {
-    /** All extensions for this extension point */
-    extensions: PluginExtension<TData>[];
+    /** All extensions for this extension point - data includes base properties (id, title, namespace) plus custom TData */
+    extensions: PluginExtension<ExtensionBaseData & TData>[];
     /** Translation function configured with all unique namespaces from extensions */
     t: ReturnType<typeof useKosTranslation>["t"];
     /** i18n utilities (e.g., exists check) */
@@ -24,18 +32,16 @@ export interface UseExtensionI18nResult<TData = unknown, TProps = unknown> {
  * 3. Configuring i18n with those namespaces
  * 4. Getting the extension component
  *
- * **For type safety:** Pass the inferred type from the schema as a generic parameter.
- * Use `getExtensionPointSchema()` to retrieve the Zod schema and infer the type in a types file.
+ * **For type safety:** Define only the custom properties from your extension schema.
+ * The hook automatically merges base properties (id, title, namespace) with your custom type.
  *
  * @example
  * ```tsx
- * // Step 1: Create a types file with inferred types (do this once)
+ * // Step 1: Define only your custom extension properties
  * // src/types/nav-link-types.ts
- * import { getExtensionPointSchema } from '@kosdev-code/kos-ui-plugin';
- * import { z } from 'zod';
- *
- * const NavLinkSchema = getExtensionPointSchema('app.navigation.link');
- * export type NavLinkData = z.infer<typeof NavLinkSchema>;
+ * export interface NavLinkData {
+ *   viewKey: string;  // Only define your custom properties - base props are added automatically!
+ * }
  *
  * // Step 2: Use the type with the hook
  * import { NavLinkData } from '../types/nav-link-types';
@@ -44,11 +50,11 @@ export interface UseExtensionI18nResult<TData = unknown, TProps = unknown> {
  *   EXTENSION_ID_NAV_LINK
  * );
  *
- * // Now extensions is properly typed as PluginExtension<NavLinkData>[]
+ * // extensions.data includes both base properties AND your custom properties
  * const navLinks = extensions.map(link => ({
- *   title: t(`${link.data.namespace}:${link.data.title}`),
- *   viewKey: link.data.viewKey, // TypeScript knows this exists!
- *   icon: <Component module={link.id} navKey={link.data.viewKey} /> // module is required, navKey is from TProps
+ *   title: t(`${link.data.namespace}:${link.data.title}`),  // namespace and title from base
+ *   viewKey: link.data.viewKey,  // viewKey from your custom NavLinkData
+ *   icon: <Component module={link.id} navKey={link.data.viewKey} />
  * }));
  * ```
  *

package/lib/hooks/use-extension-i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-extension-i18n.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-extension-i18n.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACvE,8CAA8C;IAC9C,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;IACrC,iFAAiF;IACjF,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,0CAA0C;IAC1C,IAAI,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,oHAAoH;IACpH,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,uBAAuB,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IACxE,kDAAkD;IAClD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAChE,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE;IACR,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GACA,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,CAwBvC"}
+{"version":3,"file":"use-extension-i18n.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-extension-i18n.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACvE,uHAAuH;IACvH,UAAU,EAAE,eAAe,CAAC,iBAAiB,GAAG,KAAK,CAAC,EAAE,CAAC;IACzD,iFAAiF;IACjF,CAAC,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,0CAA0C;IAC1C,IAAI,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,oHAAoH;IACpH,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,uBAAuB,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;IACxE,kDAAkD;IAClD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAChE,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE;IACR,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GACA,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,CAwBvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-plugin",
-  "version": "2.1.11",
+  "version": "2.1.13",
   "type": "module",
   "exports": {
     ".": {
@@ -21,7 +21,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "e8a6dea773acaa706c5bfee1913e758d7bbfc032"
+      "gitHash": "b11908d79cb7e6923c43abbe2d9b43b1eb3e05c5"
     }
   },
   "publishConfig": {