@kronor/dtv 4.0.0 → 5.0.0

package/dist/types/framework/native-runtime/index.d.ts

@@ -12,8 +12,8 @@ export type NativeRuntime = Runtime & {
     };
 };
 export declare const cellRenderers: {
-    text: ({ data, columnDefinition }: import("../column-definition").CellRendererProps) => string;
-    json: ({ data }: import("../column-definition").CellRendererProps) => string;
+    text: ({ data, columnDefinition }: import("../column-definition").CellRendererProps<Record<string, any>>) => string;
+    json: ({ data }: import("../column-definition").CellRendererProps<Record<string, any>>) => string;
 };
 export declare const filterTransforms: {
     autocomplete: {

package/dist/types/framework/typelevel.d.ts

@@ -0,0 +1,6 @@
+export type UnionToIntersection<U> = (U extends unknown ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
+export type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type EmptyObject = Record<never, never>;
+//# sourceMappingURL=typelevel.d.ts.map

package/dist/types/framework/typelevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typelevel.d.ts","sourceRoot":"","sources":["../../../src/framework/typelevel.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CACjC,CAAC,SAAS,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAC/C,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAC;AAEZ,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC"}

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

@@ -4,12 +4,14 @@ export type { AppProps, DTVAPI } from '../App';
 export type { View } from '../framework/view';
 export type { Runtime } from '../framework/runtime';
 export type { ColumnDefinition } from '../framework/column-definition';
+export type { FieldQuery } from '../framework/column-definition';
 export type { FilterState } from '../framework/state';
 export type { FilterSchema, FilterField, SuggestionFetcher } from '../framework/filters';
 export { FilterExpr } from '../dsl/filterExpr';
 export { FilterControl } from '../dsl/filterControl';
 export { CellRenderer } from '../dsl/cellRenderer';
 export { FilterTransform } from '../dsl/filterTransform';
+export { rowType } from '../dsl/columns';
 export type { UserDataJson } from '../framework/user-data';
 export type { UserDataLoadAPI, UserDataSaveAPI, UserDataLoadCallback, UserDataSaveCallback } from '../framework/user-data-manager';
 export type { ActionDefinition, ActionAPI } from '../framework/actions';

package/dist/types/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,QAAQ,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG/C,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACR,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACvB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,GAAG,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,QAAQ,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG/C,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACR,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACvB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,KAAK,GAAG,MAAM,QAAQ,CAAC"}

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

@@ -0,0 +1,27 @@
+export type DtvTypegenConfig = {
+    schema: {
+        endpoint: string;
+        headers?: Record<string, string>;
+    };
+    scan: {
+        include: string[];
+        exclude?: string[];
+        dtvImport?: string;
+    };
+    output: {
+        /**
+         * Output file name pattern written next to each view source file.
+         *
+         * Supported placeholders:
+         * - `{viewId}`
+         * - `{collectionName}`
+         */
+        fileNamePattern: string;
+    };
+    scalars?: Record<string, string>;
+    debug?: {
+        /** Include original GraphQL type references as comments in generated output. */
+        includeGraphqlTypeComments?: boolean;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/typegen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/typegen/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC3B,MAAM,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;IAEF,IAAI,EAAE;QACF,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,MAAM,EAAE;QACJ;;;;;;WAMG;QACH,eAAe,EAAE,MAAM,CAAC;KAC3B,CAAC;IAEF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,KAAK,CAAC,EAAE;QACJ,gFAAgF;QAChF,0BAA0B,CAAC,EAAE,OAAO,CAAC;KACxC,CAAC;CACL,CAAC"}

package/docs/typegen.md

@@ -0,0 +1,86 @@
+# DTV Type Generation (CLI)
+
+DTV ships with a CLI command for generating TypeScript types from a Hasura GraphQL schema.
+
+## Install / Run
+
+When `@kronor/dtv` is installed, it exposes a `dtv` executable:
+
+- `dtv typegen -c dtv.config.ts`
+
+(You can also run via `npx dtv typegen ...` depending on how you install it.)
+
+To scaffold a config file:
+
+- `dtv init`
+
+## Configuration
+
+The CLI loads a TypeScript config file (recommended) by transpiling it to ESM and importing it.
+
+Minimal `dtv.config.ts`:
+
+```ts
+import type { DtvTypegenConfig } from '@kronor/dtv/typegen';
+
+const config: DtvTypegenConfig = {
+    schema: {
+        endpoint: 'https://my-hasura.example.com/v1/graphql',
+        headers: {
+            // Example:
+            // Authorization: `Bearer ${process.env.HASURA_TOKEN}`,
+            // 'x-hasura-admin-secret': process.env.HASURA_ADMIN_SECRET ?? '',
+        }
+    },
+
+    scan: {
+        // Scan TS/TSX files for `DSL.view({ ... })` calls (supports aliased/namespaced imports too)
+        include: [
+            'src/**/*.{ts,tsx}'
+        ],
+        exclude: [
+            '**/*.test.*',
+            '**/node_modules/**'
+        ],
+
+        // Optional override if you re-export DTV under a different specifier.
+        // dtvImport: '@kronor/dtv'
+    },
+
+    output: {
+        // File name written next to each view module that calls DSL.view(...)
+        // Supported placeholders: {viewId}, {collectionName}
+        fileNamePattern: 'dtv.generated.{viewId}.ts'
+    },
+
+    // Optional scalar overrides: GraphQL scalar name -> TS type
+    scalars: {
+        // DateTime: 'string'
+        // json: 'unknown'
+        // jsonb: 'unknown'
+    },
+
+    debug: {
+        // When true, include original GraphQL type refs as comments
+        includeGraphqlTypeComments: false
+    }
+};
+
+export default config;
+```
+
+## Output
+
+For each discovered `DSL.view({ id, collectionName, ... })` call, the generator writes one file next to the view source file, named by `output.fileNamePattern`.
+
+That file contains:
+
+- TypeScript types for GraphQL output types reachable from the view’s `collectionName` row type (not exported)
+- One exported alias:
+    - `<ViewIdPascal>Row` – the inferred row type for that view’s `collectionName`
+
+## Current limitations (v1)
+
+- Only TS-authored views are considered. The scanner looks specifically for `DSL.view({ ... })` calls.
+- `id` and `collectionName` must be string literals in the call argument.
+- JSON views are not part of this flow yet.

package/package.json

@@ -1,15 +1,21 @@
 {
   "name": "@kronor/dtv",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "type": "module",
+  "bin": {
+    "dtv": "./bin/dtv.js"
+  },
   "files": [
+    "bin",
     "dist",
     "docs"
   ],
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",
-    "build:lib": "tsc -p tsconfig.lib.json && vite build --config vite.lib.config.ts",
+    "build:cli": "tsc -p tsconfig.cli.json",
+    "build:lib": "npm run build:cli && tsc -p tsconfig.lib.json && vite build --config vite.lib.config.ts",
+    "prepack": "npm run build:lib",
     "dev:playground": "npm run build:lib -- --watch & vite --config vite.playground.config.ts",
     "clean": "rimraf dist",
     "lint": "eslint .",
@@ -25,6 +31,10 @@
     ".": {
       "types": "./dist/types/lib/index.d.ts",
       "import": "./dist/index.es.js"
+    },
+    "./typegen": {
+      "types": "./dist/types/typegen/index.d.ts",
+      "default": "./dist/index.es.js"
     }
   },
   "main": "./dist/index.es.js",
@@ -35,12 +45,17 @@
     "react-dom": "^19.0.0"
   },
   "dependencies": {
+    "commander": "^14.0.0",
+    "fast-glob": "^3.3.3",
+    "graphql": "^16.11.0",
     "graphql-request": "^7.1.2",
     "primeicons": "^7.0.0",
     "primereact": "^10.9.5",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "tailwindcss": "^4.1.1"
+    "tailwindcss": "^4.1.1",
+    "tsx": "^4.20.5",
+    "typescript": "~5.7.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",
@@ -61,8 +76,6 @@
     "jest-environment-jsdom": "^30.0.4",
     "rimraf": "^5.0.5",
     "ts-jest": "^29.4.0",
-    "tsx": "^4.20.5",
-    "typescript": "~5.7.2",
     "typescript-eslint": "^8.24.1",
     "vite": "^6.2.0",
     "vite-plugin-css-injected-by-js": "^3.5.2"