@cobre-npm/ds-v3 0.140.0 → 0.141.0

package/dist/types/components/organisms/CobreTable/CobreTable.vue.d.ts

@@ -51,6 +51,23 @@ export interface CobreTableProps<T> {
      * focus, keyboard handling).
      */
     enableColumnReorder?: boolean;
+    /**
+     * Enable pinning columns to the left or right edge of the table, staying visible during
+     * horizontal scroll. Requires the table to also control columnPinning state
+     * (state: { columnPinning } + onColumnPinningChange) for the pin to persist — this prop only
+     * toggles the sticky rendering/affordances.
+     */
+    enableColumnPinning?: boolean;
+    /**
+     * Labels for the pin/unpin actions in each column's kebab menu (shown when
+     * enableColumnPinning is on). Defaults to Spanish, matching this component's other
+     * built-in text (e.g. emptyStateProps) — pass overrides to localize.
+     */
+    pinMenuLabels?: {
+        pinLeft?: string;
+        pinRight?: string;
+        unpin?: string;
+    };
 }
 declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
@@ -65,7 +82,14 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
             columnId: string;
             method: ColumnReorderMethod;
         }) => any) | undefined;
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onColumn-reorder" | "onColumn-reorder-cancel"> & CobreTableProps<T> & Partial<{}>> & import("vue").PublicProps;
+        readonly "onColumn-pin"?: ((payload: {
+            columnId: string;
+            side: "left" | "right";
+        }) => any) | undefined;
+        readonly "onColumn-unpin"?: ((payload: {
+            columnId: string;
+        }) => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onColumn-reorder" | "onColumn-reorder-cancel" | "onColumn-pin" | "onColumn-unpin"> & CobreTableProps<T> & Partial<{}>> & import("vue").PublicProps;
     expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
     attrs: any;
     slots: {
@@ -85,6 +109,11 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
     }) => void) & ((evt: "column-reorder-cancel", payload: {
         columnId: string;
         method: ColumnReorderMethod;
+    }) => void) & ((evt: "column-pin", payload: {
+        columnId: string;
+        side: "left" | "right";
+    }) => void) & ((evt: "column-unpin", payload: {
+        columnId: string;
     }) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/dist/types/components/organisms/CobreTable/useColumnPinning.d.ts

@@ -0,0 +1,27 @@
+import type { ComputedRef, CSSProperties, Ref } from 'vue';
+import type { Column, Table as TanStackTable, ColumnPinningPosition } from '@tanstack/vue-table';
+export interface ColumnPinningEmits {
+    (event: 'column-pin', payload: {
+        columnId: string;
+        side: 'left' | 'right';
+    }): void;
+    (event: 'column-unpin', payload: {
+        columnId: string;
+    }): void;
+}
+/**
+ * Column pinning for CobreTable, wired to a TanStack table instance. Requires the table to
+ * control columnPinning state (state: { columnPinning } + onColumnPinningChange) for pin
+ * changes to persist — this composable only mutates table.setColumnPinning(); persistence
+ * is the consumer's responsibility (e.g. useDataTable).
+ *
+ * Sticky offsets come straight from TanStack's own column.getStart/getAfter — no hand-rolled
+ * offset math needed. The one thing this composable owns is repartitioning `orderedColumnIds`
+ * on pin/unpin so pinned columns render at the table edges.
+ */
+export declare function useColumnPinning<T>(table: TanStackTable<T>, isEnabled: ComputedRef<boolean>, orderedColumnIds: Ref<string[]>, emit: ColumnPinningEmits): {
+    getIsPinned: (columnId: string) => ColumnPinningPosition;
+    isColumnIdPinned: (columnId: string) => boolean;
+    pinColumn: (columnId: string, side: ColumnPinningPosition) => void;
+    pinnedStyleFor: (column: Column<T>, baseLeftOffsetPx?: number) => CSSProperties;
+};

package/dist/types/components/organisms/CobreTable/useColumnReorder.d.ts

@@ -21,7 +21,7 @@ export interface ColumnReorderEmits {
  * onColumnOrderChange) for the new order to persist — this composable only mutates
  * table.setColumnOrder(); persistence is the consumer's responsibility (e.g. useDataTable).
  */
-export declare function useColumnReorder<T>(table: TanStackTable<T>, isEnabled: ComputedRef<boolean>, emit: ColumnReorderEmits): {
+export declare function useColumnReorder<T>(table: TanStackTable<T>, isEnabled: ComputedRef<boolean>, isPinningEnabled: ComputedRef<boolean>, emit: ColumnReorderEmits): {
     orderedColumnIds: import("vue").Ref<string[], string[]>;
     setHeaderRowEl: (el: Element | ComponentPublicInstance | null) => void;
     setHeaderElRef: (columnId: string, el: Element | ComponentPublicInstance | null) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobre-npm/ds-v3",
-  "version": "0.140.0",
+  "version": "0.141.0",
   "type": "module",
   "packageManager": "pnpm@11.0.4",
   "engines": {