@stonecrop/stonecrop 0.4.33 → 0.4.35

package/dist/stonecrop.d.ts

@@ -41,6 +41,30 @@ export declare type BaseSchema = {
     value?: any;
 };
 
+/**
+ * Base table configuration properties shared across all view types.
+ * @public
+ */
+export declare interface BaseTableConfig {
+    /**
+     * Control whether the table should be allowed to use the full width of its container.
+     *
+     * @defaultValue false
+     */
+    fullWidth?: boolean;
+}
+
+/**
+ * Table configuration for basic view types (uncounted, list, list-expansion).
+ * @public
+ */
+export declare interface BasicTableConfig extends BaseTableConfig {
+    /**
+     * The type of view to display the table in.
+     */
+    view?: 'uncounted' | 'list' | 'list-expansion';
+}
+
 /**
  * Table cell context definition.
  * @public
@@ -247,13 +271,37 @@ colspan?: number | undefined;
 originalIndex?: number | undefined;
 }[]>;
 config: Ref<    {
-view?: "uncounted" | "list" | "list-expansion" | "tree" | "gantt" | "tree-gantt" | undefined;
+view?: "uncounted" | "list" | "list-expansion" | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 fullWidth?: boolean | undefined;
+} | {
+view: "gantt";
 dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree-gantt";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
+dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
 }, TableConfig | {
-view?: "uncounted" | "list" | "list-expansion" | "tree" | "gantt" | "tree-gantt" | undefined;
+view?: "uncounted" | "list" | "list-expansion" | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 fullWidth?: boolean | undefined;
+} | {
+view: "gantt";
 dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree-gantt";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
+dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
 }>;
 connectionHandles: Ref<    {
 id: string;
@@ -482,13 +530,37 @@ colspan?: number | undefined;
 originalIndex?: number | undefined;
 }[]>;
 config: Ref<    {
-view?: "uncounted" | "list" | "list-expansion" | "tree" | "gantt" | "tree-gantt" | undefined;
+view?: "uncounted" | "list" | "list-expansion" | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 fullWidth?: boolean | undefined;
+} | {
+view: "gantt";
+dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree-gantt";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
 }, TableConfig | {
-view?: "uncounted" | "list" | "list-expansion" | "tree" | "gantt" | "tree-gantt" | undefined;
+view?: "uncounted" | "list" | "list-expansion" | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 fullWidth?: boolean | undefined;
+} | {
+view: "gantt";
+dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree-gantt";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
 }>;
 connectionHandles: Ref<    {
 id: string;
@@ -717,13 +789,37 @@ colspan?: number | undefined;
 originalIndex?: number | undefined;
 }[]>;
 config: Ref<    {
-view?: "uncounted" | "list" | "list-expansion" | "tree" | "gantt" | "tree-gantt" | undefined;
+view?: "uncounted" | "list" | "list-expansion" | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 fullWidth?: boolean | undefined;
+} | {
+view: "gantt";
+dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree-gantt";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
 }, TableConfig | {
-view?: "uncounted" | "list" | "list-expansion" | "tree" | "gantt" | "tree-gantt" | undefined;
+view?: "uncounted" | "list" | "list-expansion" | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 fullWidth?: boolean | undefined;
+} | {
+view: "gantt";
+dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
+} | {
+view: "tree-gantt";
+defaultTreeExpansion?: "root" | "branch" | "leaf" | undefined;
 dependencyGraph?: boolean | undefined;
+fullWidth?: boolean | undefined;
 }>;
 connectionHandles: Ref<    {
 id: string;
@@ -1147,6 +1243,24 @@ export declare interface GanttOptions {
     colspan?: number;
 }
 
+/**
+ * Table configuration for gantt view types.
+ * @public
+ */
+export declare interface GanttTableConfig extends BaseTableConfig {
+    /**
+     * The type of view to display the table in.
+     */
+    view: 'gantt';
+    /**
+     * Control whether dependency graph connections should be enabled for Gantt views.
+     * When false, connection handles and dependency lines will be hidden.
+     *
+     * @defaultValue true
+     */
+    dependencyGraph?: boolean;
+}
+
 /**
  * Immutable Doctype type for Stonecrop instances
  * @public
@@ -1537,34 +1651,10 @@ export declare interface TableColumn {
 }
 
 /**
- * Table configuration definition.
+ * Table configuration definition using discriminated unions for type safety.
  * @public
  */
-export declare interface TableConfig {
-    /**
-     * The type of view to display the table in. Possible values:
-     * - `uncounted` - row numbers are not displayed in the table
-     * - `list` - row numbers are displayed in the table
-     * - `list-expansion` - carets are displayed in the number column that expand/collapse the row inline
-     * - `tree` - carets are displayed in the number column that expand/collapse grouped rows
-     * - `gantt` - view that allows specific rows to be displayed with Gantt functionality
-     * - `tree-gantt` - similar to `gantt`, but allows for tree functionality as well
-     */
-    view?: 'uncounted' | 'list' | 'list-expansion' | 'tree' | 'gantt' | 'tree-gantt';
-    /**
-     * Control whether the table should be allowed to use the full width of its container.
-     *
-     * @defaultValue false
-     */
-    fullWidth?: boolean;
-    /**
-     * Control whether dependency graph connections should be enabled for Gantt views.
-     * When false, connection handles and dependency lines will be hidden.
-     *
-     * @defaultValue true
-     */
-    dependencyGraph?: boolean;
-}
+export declare type TableConfig = BasicTableConfig | TreeTableConfig | GanttTableConfig | TreeGanttTableConfig;
 
 /**
  * Table display definition.
@@ -1772,6 +1862,53 @@ export declare type TableSchema = BaseSchema & {
     rows?: TableRow[];
 };
 
+/**
+ * Table configuration for tree-gantt view types.
+ * @public
+ */
+export declare interface TreeGanttTableConfig extends BaseTableConfig {
+    /**
+     * The type of view to display the table in.
+     */
+    view: 'tree-gantt';
+    /**
+     * Default expansion state for tree views. Possible values:
+     * - `root` - Only top-level nodes are visible (fully collapsed)
+     * - `branch` - Shows minimal tree to display all gantt nodes. Expands only the necessary paths to gantt nodes, stops at gantt nodes with no gantt descendants
+     * - `leaf` - All nodes are visible (fully expanded)
+     *
+     * @defaultValue undefined (default behavior is 'leaf' mode)
+     */
+    defaultTreeExpansion?: 'root' | 'branch' | 'leaf';
+    /**
+     * Control whether dependency graph connections should be enabled for Gantt views.
+     * When false, connection handles and dependency lines will be hidden.
+     *
+     * @defaultValue true
+     */
+    dependencyGraph?: boolean;
+}
+
+/**
+ * Table configuration for tree view types.
+ * @public
+ */
+export declare interface TreeTableConfig extends BaseTableConfig {
+    /**
+     * The type of view to display the table in.
+     */
+    view: 'tree';
+    /**
+     * Default expansion state for tree views. Possible values:
+     * - `root` - Only top-level nodes are visible (fully collapsed)
+     * - `branch` - Shows minimal tree to display all gantt nodes. Expands only the necessary paths to gantt nodes, stops at gantt nodes with no gantt descendants
+     * - `leaf` - All nodes are visible (fully expanded)
+     *
+     * @defaultValue undefined (default behavior is 'leaf' mode)
+     */
+    defaultTreeExpansion?: 'root' | 'branch' | 'leaf';
+}
+
 declare const useDataStore: StoreDefinition<"data", Pick<{
 records: Ref<Record<string, any>[], Record<string, any>[]>;
 record: Ref<Record<string, any>, Record<string, any>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/stonecrop",
-  "version": "0.4.33",
+  "version": "0.4.35",
   "description": "schema helper",
   "license": "MIT",
   "type": "module",
@@ -58,9 +58,9 @@
     "typescript": "^5.8.3",
     "vite": "^7.0.6",
     "vitest": "^3.2.4",
-    "@stonecrop/aform": "0.4.33",
-    "@stonecrop/atable": "0.4.33",
-    "stonecrop-rig": "0.2.22"
+    "@stonecrop/aform": "0.4.35",
+    "stonecrop-rig": "0.2.22",
+    "@stonecrop/atable": "0.4.35"
   },
   "publishConfig": {
     "access": "public"