@kosdev-code/kos-codegen-core 3.0.19 → 3.0.21

package/lib/generators/member-mutators/add-service-request.d.ts

@@ -1,6 +1,14 @@
 import { CodegenFileSystem } from '../../codegen-filesystem';
 import { ProjectConfiguration } from '../../project-discovery';
 export type ServiceRequestMode = "lifecycle" | "method";
+/**
+ * What to do when the generated types do not declare the requested endpoint.
+ *
+ * `auto` never silently substitutes mocking for a real request — the result says
+ * plainly that it did, and why, so the caller reports a missing endpoint rather
+ * than a finished feature.
+ */
+export type ServiceRequestMockMode = "auto" | "always" | "never";
 export interface AddServiceRequestOptions {
     modelName: string;
     modelProject: string;
@@ -20,6 +28,31 @@ export interface AddServiceRequestOptions {
      * `lifecycle` mode; defaults to `LOAD` there.
      */
     lifecycle?: string;
+    /**
+     * What to do about an endpoint the generated types do not declare.
+     *
+     * `never`  — a hard error; nothing is written.
+     * `auto`   — (default) emit the provisional, mock-backed form and say so.
+     * `always` — emit a KosMock route even for an endpoint that IS typed, for
+     *   developing against something the spec declares but the device does not
+     *   serve yet. A typed endpoint keeps its typed request; only the mock is added.
+     */
+    mock?: ServiceRequestMockMode;
+    /**
+     * The raw wire shape a PROVISIONAL endpoint is expected to serve, as TypeScript
+     * type text (`DeviceGrantSyncBean[]`, `{ id: string; label: string }`). This is
+     * the UNWRAPPED `data` payload: the client strips the `{status, data}` envelope
+     * before the transform runs. Defaults to `unknown`, which compiles but leaves
+     * the response boundary undescribed.
+     */
+    rawType?: string;
+    /**
+     * Sample payload for the mock route, as TypeScript expression text. Typed
+     * against the raw wire shape, so a sample that does not match it fails the
+     * build rather than the demo. Without one the route answers with a placeholder
+     * and the transform is never exercised.
+     */
+    sample?: string;
     /** Import specifier for the generated typed service module (relative to the model
      *  file). If omitted, auto-resolved when the project has exactly one. */
     serviceModule?: string;
@@ -32,9 +65,54 @@ export interface AddServiceRequestOptions {
     serviceModulePath?: string;
     modelPath?: string;
 }
-export declare function addServiceRequestToModel(codegenFs: CodegenFileSystem, options: AddServiceRequestOptions, projects?: Map<string, ProjectConfiguration>): {
+export interface AddServiceRequestResult {
     modelFilePath: string;
+    /** The model's services module the descriptor was written to. */
+    servicesFilePath: string;
     serviceModule: string;
     mode: ServiceRequestMode;
-};
+    /** Catalog entry the method points at — reused when the endpoint was known. */
+    endpointKey: string;
+    /** False when an existing catalog entry for this (path, method) was reused. */
+    endpointCreated: boolean;
+    /**
+     * Whether the path was actually checked. False when the generated module
+     * exposes no `paths` this can read — which is not evidence the endpoint exists.
+     */
+    pathValidated: boolean;
+    /** True when the endpoint is absent from the generated types and was mocked. */
+    provisional: boolean;
+    /** The mock module, when one was written. */
+    mocksFilePath?: string;
+    /** Function the app must call to arm the routes, when one was written. */
+    mockRegisterFunction?: string;
+    /** `GET /api/board/grants`, when a route was registered. */
+    mockRoute?: string;
+    /** True when no sample was supplied, so the mock serves a placeholder. */
+    mockSamplePlaceholder?: boolean;
+    /** Exactly what to undo when the endpoint lands, in order. */
+    removalSteps?: string[];
+}
+/**
+ * Everything needed to report a rejected path, carried on the error rather than
+ * flattened into its message — so a tool surface can present the alternatives
+ * with their warning attached instead of as a list of corrections.
+ */
+export interface UntypedEndpointDetails {
+    servicePath: string;
+    method: string;
+    /** True when the path is typed, but not for this method. */
+    pathTypedForOtherMethods: boolean;
+    /** Methods this path DOES support, when it is typed at all. */
+    methodsForPath: string[];
+    /** Nearest paths in the same API — alternatives to rule out, not to adopt. */
+    otherEndpointsInThisApi: string[];
+    warning: string;
+    waysForward: string[];
+}
+/** A rejected path, with the alternatives kept apart from the verdict. */
+export interface UntypedEndpointError extends Error {
+    details: UntypedEndpointDetails;
+}
+export declare function addServiceRequestToModel(codegenFs: CodegenFileSystem, options: AddServiceRequestOptions, projects?: Map<string, ProjectConfiguration>): AddServiceRequestResult;
 //# sourceMappingURL=add-service-request.d.ts.map

package/lib/generators/member-mutators/add-service-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-service-request.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/member-mutators/add-service-request.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAepE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;6EACyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwBD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,wBAAwB,EACjC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAmJ5E"}
+{"version":3,"file":"add-service-request.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/member-mutators/add-service-request.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AA6BpE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;6EACyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,eAAe,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,wBAAwB,EAAE,OAAO,CAAC;IAClC,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8EAA8E;IAC9E,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAqB,SAAQ,KAAK;IACjD,OAAO,EAAE,sBAAsB,CAAC;CACjC;AA6RD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,wBAAwB,EACjC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C,uBAAuB,CAqXzB"}

package/lib/generators/member-mutators/index.d.ts

@@ -5,5 +5,5 @@ export { addTopicHandlerToModel, type AddTopicHandlerOptions, } from './add-topi
 export { addConfigPropertyToModel, type AddConfigPropertyOptions, } from './add-config-property';
 export { addPropertyToModel, type AddPropertyOptions } from './add-property';
 export { addComputedToModel, type AddComputedOptions } from './add-computed';
-export { addServiceRequestToModel, type AddServiceRequestOptions, } from './add-service-request';
+export { addServiceRequestToModel, type AddServiceRequestOptions, type AddServiceRequestResult, type ServiceRequestMockMode, type UntypedEndpointDetails, type UntypedEndpointError, } from './add-service-request';
 //# sourceMappingURL=index.d.ts.map

package/lib/generators/member-mutators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/member-mutators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/member-mutators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC"}

package/lib/generators/registration/upsert-chain-entry.d.ts

@@ -0,0 +1,13 @@
+export interface UpsertChainEntryResult {
+    changed: boolean;
+    /** The full file text after the edit (only when `changed`). */
+    content?: string;
+    /** Whether an import for the bean had to be added (only when `changed`). */
+    importAdded?: boolean;
+    note?: string;
+    error?: string;
+}
+/** Number of `.model(...)` entries in a chain file. */
+export declare function countChainEntries(content: string): number;
+export declare function upsertChainEntry(content: string, bean: string, importSpec: string): UpsertChainEntryResult;
+//# sourceMappingURL=upsert-chain-entry.d.ts.map

package/lib/generators/registration/upsert-chain-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-chain-entry.d.ts","sourceRoot":"","sources":["../../../../../../packages/kos-codegen-core/src/lib/generators/registration/upsert-chain-entry.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwCD,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,sBAAsB,CA4CxB"}

package/lib/generators/service-catalog.d.ts

@@ -35,5 +35,17 @@ export interface ServiceCatalogQuery {
  * should tell the user to run `api:generate`, not treat it as "no endpoints".
  */
 export declare function listServiceCatalog(codegenFs: CodegenFileSystem, query: ServiceCatalogQuery, projects?: Map<string, ProjectConfiguration>): ServiceCatalogEntry[];
+/**
+ * The operations a generated service module types, for callers that hold the
+ * module rather than a project name — path validation, above all.
+ *
+ * `paths` normally lives in the `openapi.d.ts` beside the module, but the module
+ * may declare it inline instead. Returns null when NEITHER does: that is "these
+ * types cannot answer the question", which a caller must not read as "the
+ * endpoint does not exist".
+ *
+ * @param serviceModuleFile Root-relative path of the module, with or without `.ts`.
+ */
+export declare function readServiceModuleOperations(codegenFs: CodegenFileSystem, serviceModuleFile: string): ServiceOperation[] | null;
 export {};
 //# sourceMappingURL=service-catalog.d.ts.map

package/lib/generators/service-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-catalog.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/service-catalog.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIjE,8EAA8E;AAC9E,QAAA,MAAM,eAAe,oDAAqD,CAAC;AAC3E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAID,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C,mBAAmB,EAAE,CAiCvB"}
+{"version":3,"file":"service-catalog.d.ts","sourceRoot":"","sources":["../../../../../packages/kos-codegen-core/src/lib/generators/service-catalog.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIjE,8EAA8E;AAC9E,QAAA,MAAM,eAAe,oDAAqD,CAAC;AAC3E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAID,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C,mBAAmB,EAAE,CAiCvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iBAAiB,EAC5B,iBAAiB,EAAE,MAAM,GACxB,gBAAgB,EAAE,GAAG,IAAI,CAa3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-codegen-core",
-  "version": "3.0.19",
+  "version": "3.0.21",
   "type": "commonjs",
   "main": "./index.js",
   "module": "./index.mjs",
@@ -25,7 +25,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "442efeac4f5ebe09b50bc6dfa13190bc3799fbbe"
+      "gitHash": "a5481c29ff5f1e4f0c89ed967aea9b0f0b9ee171"
     }
   }
 }

package/templates/kos-container-model/model/index.ts.template

@@ -8,6 +8,4 @@ export type { <%= nameProperCase %>Model } from "./<%= nameDashCase %>-model";
 export type { <%= modelNameProperCase %>Model } from "./<%= modelNameDashCase %>-model";
 export type * from "./types";
 
-<% if (dataServices) { %>// Export services if configured
-export * as <%= modelNameProperCase %>Services from "./services";<% } %>
 

package/templates/kos-container-model/model/types/index.d.ts.template

@@ -1,10 +1,10 @@
 
-<% if (parentAware) { %>import type {KosParentAware} from  "@kosdev-code/kos-ui-sdk";<% } %>
+<% if (locals.parentAware) { %>import type {KosParentAware} from  "@kosdev-code/kos-ui-sdk";<% } %>
 
 
 // ---------------  <%= modelNameProperCase %> ---------------
 
-export interface <%= modelNameProperCase %>Options <% if (parentAware) { %>extends KosParentAware<% } %>  {
+export interface <%= modelNameProperCase %>Options <% if (locals.parentAware) { %>extends KosParentAware<% } %>  {
     
 }
 

package/templates/kos-model/model/index.ts__template__

@@ -4,6 +4,3 @@ export { <%= nameProperCase %> } from "./<%= nameDashCase %>-model";
 // Export types
 export type { <%= nameProperCase %>Model } from "./<%= nameDashCase %>-model";
 export type * from "./types";
-
-<% if (dataServices) { %>// Export services if configured
-export * as <%= nameProperCase %>Services from "./services";<% } %>

package/templates/kos-model-project/project/.eslintrc.json.template

@@ -0,0 +1,33 @@
+{
+  "extends": ["<%= offsetFromRoot %>.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/dependency-checks": [
+          "error",
+          {
+            "ignoredFiles": [
+              "{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}",
+              "{projectRoot}/vite.config.{js,ts,mjs,mts}"
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/templates/kos-model-project/project/.kos.json.template

@@ -0,0 +1,14 @@
+{
+  "name": "<%= projectName %>",
+  "type": "kos.model",
+  "version": "0.0.0-SNAPSHOT",
+  "models": {},
+  "generator": {
+    "projectType": "model",
+    "defaults": {
+      "model": {
+        "folder": "models"
+      }
+    }
+  }
+}

package/templates/kos-model-project/project/README.md.template

@@ -0,0 +1,7 @@
+# <%= projectName %>
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build <%= projectName %>` to build the library.

package/templates/kos-model-project/project/package.json.template

@@ -0,0 +1,9 @@
+{
+  "name": "<%= importPath %>",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "dependencies": {}
+}

package/templates/kos-model-project/project/project.json.template

@@ -0,0 +1,35 @@
+{
+  "name": "<%= projectName %>",
+  "$schema": "<%= offsetFromRoot %>node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "<%= projectRoot %>/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/vite:build",
+      "outputs": ["{options.outputPath}"],
+      "defaultConfiguration": "production",
+      "options": {
+        "outputPath": "dist/<%= projectRoot %>"
+      },
+      "configurations": {
+        "development": {
+          "mode": "development"
+        },
+        "production": {
+          "mode": "production"
+        }
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint"
+    },
+    "api": {
+      "command": "kosui api:generate --project=<%= projectName %>",
+      "options": {
+        "host": "http://127.0.0.1:8081",
+        "defaultVersion": "snapshot"
+      }
+    }
+  }
+}

package/templates/kos-model-project/project/src/index.ts.template

@@ -0,0 +1 @@
+export * from './lib/<%= projectName %>';

package/templates/kos-model-project/project/src/lib/__projectName__.ts.template

@@ -0,0 +1,3 @@
+export function <%= projectNameCamelCase %>(): string {
+  return '<%= projectName %>';
+}

package/templates/kos-model-project/project/tsconfig.json.template

@@ -0,0 +1,20 @@
+{
+  "extends": "<%= offsetFromRoot %>tsconfig.base.json",
+  "compilerOptions": {
+    "module": "esnext",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

package/templates/kos-model-project/project/tsconfig.lib.json.template

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "<%= offsetFromRoot %>dist/out-tsc",
+    "declaration": true,
+    "types": ["node", "vite/client"],
+    "module": "esnext"
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/kos-model-project/project/vite.config.ts.template

@@ -0,0 +1,47 @@
+/// <reference types='vitest' />
+import { defineConfig } from 'vite';
+import dts from 'vite-plugin-dts';
+import * as path from 'path';
+import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+import { nxCopyAssetsPlugin } from '@nx/vite/plugins/nx-copy-assets.plugin';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '<%= offsetFromRoot %>node_modules/.vite/<%= projectRoot %>',
+  plugins: [
+    nxViteTsPaths(),
+    nxCopyAssetsPlugin(['*.md']),
+    dts({
+      entryRoot: 'src',
+      tsconfigPath: path.join(__dirname, 'tsconfig.lib.json'),
+      pathsToAliases: false,
+    }),
+  ],
+  // Uncomment this if you are using workers.
+  // worker: {
+  //  plugins: [ nxViteTsPaths() ],
+  // },
+  // Configuration for building your library.
+  // See: https://vitejs.dev/guide/build.html#library-mode
+  build: {
+    outDir: '<%= offsetFromRoot %>dist/<%= projectRoot %>',
+    emptyOutDir: true,
+    reportCompressedSize: true,
+    commonjsOptions: {
+      transformMixedEsModules: true,
+    },
+    lib: {
+      // Could also be a dictionary or array of multiple entry points.
+      entry: 'src/index.ts',
+      name: '<%= projectName %>',
+      fileName: 'index',
+      // Change this to the formats you want to support.
+      // Don't forget to update your package.json as well.
+      formats: ['es' as const],
+    },
+    rollupOptions: {
+      // External packages that should not be bundled into your library.
+      external: [],
+    },
+  },
+}));

package/templates/kos-view-model/__nameDashCase__-view-model.ts.template

@@ -0,0 +1,30 @@
+/**
+ * UI-only state for the <%= nameProperCase %> view, held <% if (constructorParams.length) { %>beside the KOS data models it
+ * reads rather than inside them<% } else { %>outside the KOS data models<% } %>. A ViewModel is not registered and is
+ * not part of the model graph; create one per component with
+ * `useViewModel(() => new <%= nameProperCase %>ViewModel(<%= constructorArgs %>))`.
+ */
+<% if (internal) { %>import {
+  kosViewModel,
+  kosLoggerAware,
+  type KosViewModelLoggerAware,
+} from "../../../core/core/decorators";
+<% } else { %>import {
+  kosViewModel,
+  kosLoggerAware,
+  type KosViewModelLoggerAware,
+} from "@kosdev-code/kos-ui-sdk";
+<% } %><% modelImports.forEach(function (imp) { %>import type { <%= imp.types.join(", ") %> } from "<%= imp.module %>";
+<% }); %>
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+export interface <%= nameProperCase %>ViewModel extends KosViewModelLoggerAware {}
+
+@kosViewModel({ typeId: "<%= typeId %>"<% if (devToolsEnabled) { %>, devToolsEnabled: true<% } %> })
+@kosLoggerAware()
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+export class <%= nameProperCase %>ViewModel {
+<% if (constructorParams.length === 0) { %>  constructor() {}
+<% } else { %>  constructor(
+<% constructorParams.forEach(function (param, index) { %>    private readonly <%= param.name %>: <%= param.type %><% if (index < constructorParams.length - 1) { %>,<% } %>
+<% }); %>  ) {}
+<% } %>}

package/templates/kos-view-model/index.ts.template

@@ -0,0 +1 @@
+export { <%= nameProperCase %>ViewModel } from "./<%= nameDashCase %>-view-model";

package/templates/kos-container-model/services/__modelNameDashCase__-services.ts.template

@@ -1,22 +0,0 @@
-import {
-  KosLog,
-  type ElementType,
-  type ServiceResponse
-} from '@kosdev-code/kos-ui-sdk';
-
-import API, { type KosApi, type ApiPath, type ApiResponse } from '../../../utils/service';
-
-const log = KosLog.createLogger({name: "<%= nameDashCase %>-service", group: "Services"});
-
-const SERVICE_PATH: ApiPath = "ENTER_SERVICE_PATH"
-export type <%= nameProperCase %>Response = ApiResponse<typeof SERVICE_PATH,'get'>;
-
-
-/**
- * @category Service
- * Retrieves the initial list of  <%= name %> data.
- */
-export const get<%= nameProperCase %> = async (): Promise<ServiceResponse<<%= nameProperCase %>ClientResponse>> => {
-  log.debug('sending GET for  <%= name %>');
-  return await API.get(SERVICE_PATH);
-};

package/templates/kos-container-model/services/index.ts.template

@@ -1 +0,0 @@
-export * from "./<%= modelNameDashCase %>-services";

package/templates/kos-model/services/__nameDashCase__-services.ts.template

@@ -1,58 +0,0 @@
-<% const hasFutureSupport = futureAware && futureAware !== 'none'; %>
-import {
-  KosLog,
-  type ElementType,
-  type ServiceResponse<% if (hasFutureSupport) { %>,
-  type FutureResponse<% } %>
-} from '@kosdev-code/kos-ui-sdk';
-
-import API, { type ApiPath, type ApiResponse } from '../../../utils/service';
-
-const log = KosLog.createLogger({name: "<%= nameDashCase %>-service", group: "Services"});
-
-const SERVICE_PATH: ApiPath = "ENTER_SERVICE_PATH"
-export type <%= nameProperCase %>Response = ApiResponse<typeof SERVICE_PATH, 'get'>;
-
-
-/**
- * @category Service
- * Retrieves the initial  <%= name %> data.
- */
-export const get<%= nameProperCase %> = async (): Promise<ServiceResponse<<%= nameProperCase %>Response>> => {
-  log.debug('sending GET for  <%= name %>');
-  return await API.get(SERVICE_PATH);
-};
-
-<% if (hasFutureSupport) { %>
-/**
- * @category Service - Future Operation
- * Placeholder for a long-running operation that returns a Future for progress tracking
- * 
- * Replace this with your actual long-running service operation
- */
-export const perform<%= nameProperCase %>Operation = async (): Promise<FutureResponse> => {
-  // TODO: Implement your long-running service operation here
-  // This should return a Future that can be tracked for progress
-  
-  log.debug('starting long-running <%= name %> operation');
-  
-  // Example pattern:
-  // return API.post(OPERATION_SERVICE_PATH, {
-  //   // operation parameters
-  // });
-  
-  // Placeholder - replace with actual implementation
-  throw new Error('perform<%= nameProperCase %>Operation not yet implemented');
-};
-
-// Additional Future-aware service types (add as needed)
-export type <%= nameProperCase %>OperationProgress = {
-  // Define your progress data structure here
-
-};
-
-export type <%= nameProperCase %>OperationResult = {
-  // Define your operation result structure here
-
-};
-<% } %>

package/templates/kos-model/services/index.ts.template

@@ -1 +0,0 @@
-export * from "./<%= nameDashCase %>-services";