@kosdev-code/kos-codegen-core 0.1.0-next.792 → 0.1.0-next.796

package/index.d.ts

@@ -12,6 +12,6 @@ export { setCodegenLogger, getCodegenLogger } from './lib/logger';
 export { getCurrentDirectoryName, getProject, getKosProjectConfiguration, getKosModelConfiguration, getKosModelConfigProp, addKosModelConfiguration, } from './lib/kos-config';
 export type { KosModelConfiguration, KosProjectConfiguration, } from './lib/kos-config';
 export { getTemplateDir } from './lib/template-resolver';
-export { generateSplashProject, generateInit, normalizeOptions, appendBarrelExport, updateModelIndex, generateHook, generateContext, generateContainerModel, generateCompanionModel, generateModel, addFutureToModel, addContainerSupportToModel, addModelEffectToModel, addDependencyToModel, addChildToModel, addTopicHandlerToModel, addConfigPropertyToModel, addServiceRequestToModel, addPropertyToModel, addComputedToModel, validateModel, describeModel, lookupSdkType, resolveModelFilePath, generateComponent, PLUGIN_TYPES, CONTRIBUTION_TYPE_MAP, LOCALIZED_PLUGIN_TYPES, KOS_JSON_PATHS, PluginHandlerFactory, BasePluginHandler, KosConfigBuilder, ValidationError, } from './lib/generators';
-export type { SplashProjectOptions, KosInitOptions, KosBaseGeneratorOptions, NormalizedOptions, HookOptions, ContextOptions, ContainerModelOptions, CompanionModelOptions, ModelOptions, GenerateModelParams, AddFutureToModelOptions, NormalizedAddFutureToModelOptions, AddContainerSupportOptions, AddModelEffectOptions, AddDependencyOptions, AddChildOptions, ChildShape, AddTopicHandlerOptions, AddConfigPropertyOptions, AddServiceRequestOptions, AddPropertyOptions, AddComputedOptions, ValidateModelOptions, ValidationFinding, ValidationResult, DescribeModelOptions, DescribedMember, ModelDescription, ModelFileQuery, LookupSdkTypeOptions, SdkSymbolDeclaration, SdkTypeLookupResult, ComponentOptions, NormalizedComponentOptions, PluginConfiguration, PluginContribution, ExperienceConfig, PluginType, PluginHandler, } from './lib/generators';
+export { generateSplashProject, generateInit, generatePolyglotWorkspace, ensureJavaAggregatorPom, finalizeArchetypeModule, addJavaArtifactToManifests, syncCiManifests, discoverUiArtifacts, discoverJavaArtifacts, buildKabTargets, UPDATE_RELEASE_VERSION_SCRIPT, UPDATE_RELEASE_VERSION_SCRIPT_PATH, normalizeOptions, appendBarrelExport, updateModelIndex, generateHook, generateContext, generateContainerModel, generateCompanionModel, generateModel, addFutureToModel, addContainerSupportToModel, addModelEffectToModel, addDependencyToModel, addChildToModel, addTopicHandlerToModel, addConfigPropertyToModel, addServiceRequestToModel, addPropertyToModel, addComputedToModel, validateModel, describeModel, lookupSdkType, resolveModelFilePath, generateComponent, PLUGIN_TYPES, CONTRIBUTION_TYPE_MAP, LOCALIZED_PLUGIN_TYPES, KOS_JSON_PATHS, PluginHandlerFactory, BasePluginHandler, KosConfigBuilder, ValidationError, } from './lib/generators';
+export type { SplashProjectOptions, KosInitOptions, KabTargetsOptions, KabTargetDefinition, PolyglotWorkspaceOptions, PolyglotWorkspaceResult, EnsureJavaAggregatorOptions, FinalizeArchetypeModuleOptions, AddJavaArtifactOptions, CiSyncOptions, CiSyncResult, CiSyncManifestResult, DiscoveredArtifact, KosBaseGeneratorOptions, NormalizedOptions, HookOptions, ContextOptions, ContainerModelOptions, CompanionModelOptions, ModelOptions, GenerateModelParams, AddFutureToModelOptions, NormalizedAddFutureToModelOptions, AddContainerSupportOptions, AddModelEffectOptions, AddDependencyOptions, AddChildOptions, ChildShape, AddTopicHandlerOptions, AddConfigPropertyOptions, AddServiceRequestOptions, AddPropertyOptions, AddComputedOptions, ValidateModelOptions, ValidationFinding, ValidationResult, DescribeModelOptions, DescribedMember, ModelDescription, ModelFileQuery, LookupSdkTypeOptions, SdkSymbolDeclaration, SdkTypeLookupResult, ComponentOptions, NormalizedComponentOptions, PluginConfiguration, PluginContribution, ExperienceConfig, PluginType, PluginHandler, } from './lib/generators';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/kos-codegen-core/src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGhF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAGlE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,iCAAiC,EACjC,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/kos-codegen-core/src/index.ts"],"names":[],"mappings":"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"}

package/index.js

@@ -537,6 +537,294 @@ function generateInit(codegenFs, options) {
   };
   writeJson(codegenFs, "nx.json", nxConfig);
 }
+const BUILD_SCRIPTS = [
+  "build/build-ui.sh",
+  "build/build-java.sh",
+  "build/build-release.sh",
+  "build/release_version_prebuild.sh",
+  "build/docker-build.sh"
+];
+function generatePolyglotWorkspace(codegenFs, templateDir, options) {
+  const normalized = normalizeAllValues({ name: options.name });
+  const vars = {
+    ...normalized,
+    keyset: options.keyset || "prod.kos",
+    appUiName: `${normalized.nameDashCase}-ui`,
+    nodeVersion: options.nodeVersion || process.version.replace(/^v/, ""),
+    jdkMajor: options.jdkMajor || "17",
+    mavenVersion: options.mavenVersion || "3.9.9"
+  };
+  generateFilesFromTemplates(
+    codegenFs,
+    path__namespace.join(templateDir, "root"),
+    ".",
+    vars
+  );
+  generateFilesFromTemplates(
+    codegenFs,
+    path__namespace.join(templateDir, "build"),
+    "build",
+    vars
+  );
+  generateFilesFromTemplates(
+    codegenFs,
+    path__namespace.join(templateDir, "github"),
+    ".github",
+    vars
+  );
+  generateFilesFromTemplates(
+    codegenFs,
+    path__namespace.join(templateDir, "java"),
+    "java",
+    vars
+  );
+  return { executablePaths: [...BUILD_SCRIPTS] };
+}
+const UI_PROJECT_DIRS = [
+  "apps",
+  "libs",
+  "plugins",
+  "splash",
+  "themes",
+  "content",
+  "translations"
+];
+function joinArtifactPath(outputPath, fileName) {
+  return `${outputPath.replace(/\/+$/, "")}/${fileName}`;
+}
+function discoverUiArtifacts(codegenFs) {
+  const artifacts = [];
+  for (const dir of UI_PROJECT_DIRS) {
+    for (const file of codegenFs.listFiles(`ui/${dir}`)) {
+      if (!file.endsWith("project.json")) continue;
+      const raw = codegenFs.read(file);
+      if (raw === null) continue;
+      let project;
+      try {
+        project = JSON.parse(raw);
+      } catch {
+        continue;
+      }
+      const name = project.name;
+      if (!name) continue;
+      const kabOptions = project.targets?.kab?.options;
+      if (kabOptions?.outputPath && kabOptions?.kabName) {
+        artifacts.push({
+          id: name,
+          filename: `ui/${joinArtifactPath(kabOptions.outputPath, kabOptions.kabName)}`
+        });
+      } else if (project.targets?.splash) {
+        artifacts.push({
+          id: name,
+          filename: `ui/dist/archives/packages/${name}/${name}.kab`,
+          layer: 1
+        });
+      }
+    }
+  }
+  for (const file of codegenFs.listFiles("ui/external")) {
+    if (!file.endsWith(".kab")) continue;
+    const base = file.slice(file.lastIndexOf("/") + 1, -".kab".length);
+    artifacts.push({ id: base, filename: file });
+  }
+  return artifacts;
+}
+function discoverJavaArtifacts(codegenFs) {
+  const aggregator = codegenFs.read("java/pom.xml");
+  if (aggregator === null) return [];
+  const artifacts = [];
+  for (const match of aggregator.matchAll(/<module>([^<]+)<\/module>/g)) {
+    const moduleDir = match[1];
+    const pom = codegenFs.read(`java/${moduleDir}/pom.xml`);
+    if (pom === null || !pom.includes("kos-kab-maven-plugin")) continue;
+    const withoutParent = pom.replace(/<parent>[\s\S]*?<\/parent>/, "");
+    const artifactId = withoutParent.match(
+      /<artifactId>([^<]+)<\/artifactId>/
+    )?.[1];
+    if (!artifactId) continue;
+    artifacts.push({
+      id: moduleDir,
+      // eslint-disable-next-line no-template-curly-in-string
+      filename: `java/${moduleDir}/target/${artifactId}-\${KOS_STD_VERSION_REGEX}.kab`
+    });
+  }
+  return artifacts;
+}
+function syncManifest(codegenFs, manifestPath, discovered, prune) {
+  const raw = codegenFs.read(manifestPath);
+  if (raw === null) return null;
+  const manifest = JSON.parse(raw);
+  const existing = manifest.artifacts ?? [];
+  const byFilename = new Map(discovered.map((d) => [d.filename, d]));
+  const kept = [];
+  const stale = [];
+  const pruned = [];
+  for (const entry of existing) {
+    if (byFilename.has(entry.filename)) {
+      kept.push(entry);
+      byFilename.delete(entry.filename);
+    } else if (prune) {
+      pruned.push(entry.id ?? entry.filename);
+    } else {
+      kept.push(entry);
+      stale.push(entry.id ?? entry.filename);
+    }
+  }
+  const added = [];
+  for (const artifact of byFilename.values()) {
+    kept.push({
+      id: artifact.id,
+      filename: artifact.filename,
+      artifactstore: "kos-cdn",
+      marketplace: 1,
+      ...artifact.layer !== void 0 ? { layer: artifact.layer } : {}
+    });
+    added.push(artifact.id);
+  }
+  if (added.length > 0 || pruned.length > 0) {
+    manifest.artifacts = kept;
+    codegenFs.write(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+  }
+  return { added, stale, pruned };
+}
+function syncCiManifests(codegenFs, options = {}) {
+  const prune = options.prune ?? false;
+  const ui = discoverUiArtifacts(codegenFs);
+  const java = discoverJavaArtifacts(codegenFs);
+  const manifests = {};
+  const plan = [
+    [".github/build-ui.json", ui],
+    [".github/build-java.json", java],
+    [".github/build-release.json", [...ui, ...java]]
+  ];
+  for (const [manifestPath, discovered] of plan) {
+    const result = syncManifest(codegenFs, manifestPath, discovered, prune);
+    if (result) {
+      manifests[manifestPath] = result;
+    }
+  }
+  return { manifests, discovered: { ui, java } };
+}
+function ensureJavaAggregatorPom(codegenFs, options) {
+  const pomPath = "java/pom.xml";
+  const existing = codegenFs.read(pomPath);
+  if (existing === null) {
+    codegenFs.write(
+      pomPath,
+      `<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>${options.groupId}</groupId>
+  <artifactId>${options.artifactId}</artifactId>
+  <version>0.0.0-SNAPSHOT</version>
+  <packaging>pom</packaging>
+  <modules>
+    <module>${options.moduleName}</module>
+  </modules>
+</project>
+`
+    );
+    return;
+  }
+  if (existing.includes(`<module>${options.moduleName}</module>`)) {
+    return;
+  }
+  codegenFs.write(
+    pomPath,
+    existing.replace(
+      "</modules>",
+      `  <module>${options.moduleName}</module>
+  </modules>`
+    )
+  );
+}
+function finalizeArchetypeModule(codegenFs, options) {
+  const { moduleName, kosVersion, kabPluginVersion, apiInfoVersion } = options;
+  const notes = [];
+  const pomPath = `java/${moduleName}/pom.xml`;
+  let pom = codegenFs.read(pomPath);
+  if (pom === null) {
+    throw new Error(`Generated module pom not found: ${pomPath}`);
+  }
+  if (pom.includes("<kos.version>0.0.0-SNAPSHOT</kos.version>")) {
+    if (kosVersion) {
+      pom = pom.replace(
+        "<kos.version>0.0.0-SNAPSHOT</kos.version>",
+        `<kos.version>${kosVersion}</kos.version>`
+      );
+    } else {
+      notes.push(
+        "kos.version is 0.0.0-SNAPSHOT — set it to a released kos-bom version before building"
+      );
+    }
+  }
+  if (pom.includes("${kos-kab-maven-plugin.version}") && !pom.includes("<kos-kab-maven-plugin.version>")) {
+    if (kabPluginVersion) {
+      pom = pom.replace(
+        /(<kos\.version>[^<]*<\/kos\.version>)/,
+        `$1
+        <kos-kab-maven-plugin.version>${kabPluginVersion}</kos-kab-maven-plugin.version>`
+      );
+    } else {
+      notes.push(
+        "the ${kos-kab-maven-plugin.version} property is referenced but undefined — add it before building"
+      );
+    }
+  }
+  const unversionedApiInfo = /<artifactId>api-info<\/artifactId>(\s*)<\/dependency>/;
+  if (unversionedApiInfo.test(pom)) {
+    if (apiInfoVersion) {
+      pom = pom.replace(
+        unversionedApiInfo,
+        `<artifactId>api-info</artifactId>$1  <version>${apiInfoVersion}</version>$1</dependency>`
+      );
+    } else {
+      notes.push(
+        "api-info has no version and is not managed by the kos-bom — add one before building"
+      );
+    }
+  }
+  codegenFs.write(pomPath, pom);
+  const githubDir = `java/${moduleName}/github`;
+  if (codegenFs.exists(githubDir)) {
+    for (const file of codegenFs.listFiles(githubDir)) {
+      codegenFs.delete(file);
+    }
+  }
+  const gitignore = codegenFs.read(`java/${moduleName}/gitignore`);
+  if (gitignore !== null) {
+    codegenFs.write(`java/${moduleName}/.gitignore`, gitignore);
+    codegenFs.delete(`java/${moduleName}/gitignore`);
+  }
+  return notes;
+}
+function addJavaArtifactToManifests(codegenFs, options) {
+  const { moduleName } = options;
+  for (const manifestPath of [
+    ".github/build-java.json",
+    ".github/build-release.json"
+  ]) {
+    const raw = codegenFs.read(manifestPath);
+    if (raw === null) {
+      continue;
+    }
+    const manifest = JSON.parse(raw);
+    manifest.artifacts = manifest.artifacts ?? [];
+    if (manifest.artifacts.some(
+      (artifact) => artifact.id === moduleName
+    )) {
+      continue;
+    }
+    manifest.artifacts.push({
+      id: moduleName,
+      // eslint-disable-next-line no-template-curly-in-string
+      filename: `java/${moduleName}/target/${moduleName}-\${KOS_STD_VERSION_REGEX}.kab`,
+      artifactstore: "kos-cdn",
+      marketplace: 1
+    });
+    codegenFs.write(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+  }
+}
 function normalizeOptions(codegenFs, options, projects) {
   const toNormalize = {
     name: options.name
@@ -582,6 +870,103 @@ function normalizeOptions(codegenFs, options, projects) {
     template: ""
   };
 }
+const UPDATE_RELEASE_VERSION_SCRIPT_PATH = "tools/scripts/update-release-version.mjs";
+function buildKabTargets(options) {
+  const {
+    name,
+    archiveDir = "packages",
+    descriptorDir,
+    buildTarget = "build"
+  } = options;
+  const outputPath = `dist/archives/${archiveDir}/${name}/`;
+  const targets = {
+    kab: {
+      command: `node tools/scripts/kabtool.mjs build ${name} && node tools/scripts/kabtool.mjs list ${name} `,
+      options: {
+        outputPath,
+        zipName: "ui.zip",
+        kabName: `${name}.kab`
+      },
+      dependsOn: ["zip"]
+    },
+    zip: {
+      command: `node tools/scripts/archiver.js ${name}`,
+      options: {
+        outputPath,
+        zipName: "ui.zip"
+      },
+      dependsOn: descriptorDir ? [buildTarget, "descriptor"] : [buildTarget]
+    }
+  };
+  if (descriptorDir) {
+    targets.descriptor = {
+      command: `node tools/scripts/descriptor.mjs ${name}`,
+      options: {
+        outputPath: `dist/${descriptorDir}`,
+        fileName: "descriptor.json"
+      },
+      dependsOn: ["build"]
+    };
+  }
+  targets.version = {
+    command: `node ${UPDATE_RELEASE_VERSION_SCRIPT_PATH} ${name} {args.ver}`,
+    options: {},
+    dependsOn: []
+  };
+  return targets;
+}
+const UPDATE_RELEASE_VERSION_SCRIPT = `import devkit from "@nx/devkit";
+import { resolve } from "path";
+import { readFileSync, writeFileSync } from "fs";
+import prettier from "prettier";
+
+// KOS artifact versioning: stamps the project's .kos.json "version" field
+// (which kabtool bakes into the KAB). Never touches package.json.
+// Driven by tag-based releases:
+//   nx run-many --target=version --args=--ver=$KOSBUILD_VERSION
+
+const { readCachedProjectGraph } = devkit;
+const [, , name, versionArg] = process.argv;
+
+// "{args.ver}" arrives literally when the target runs without --args=--ver=<v>;
+// treat that (or a missing arg) as "report current version, change nothing".
+const version =
+  versionArg && !versionArg.startsWith("{args") ? versionArg : undefined;
+
+if (!name) {
+  console.error("usage: update-release-version.mjs <project> <version>");
+  process.exit(1);
+}
+
+const graph = readCachedProjectGraph();
+const project = graph.nodes[name];
+if (!project) {
+  console.error("Unknown project: " + name);
+  process.exit(1);
+}
+
+const kosJsonPath = resolve(process.cwd(), project.data.root, ".kos.json");
+let kosJson;
+try {
+  kosJson = JSON.parse(readFileSync(kosJsonPath, "utf8"));
+} catch {
+  console.error("Missing or invalid .kos.json: " + kosJsonPath);
+  process.exit(1);
+}
+
+if (!version) {
+  console.log(name + ": " + kosJson.version + " (no --ver given; unchanged)");
+  process.exit(0);
+}
+
+const prettierOptions = await prettier.resolveConfig(kosJsonPath);
+const output = await prettier.format(
+  JSON.stringify({ ...kosJson, version }, null, 2),
+  { ...prettierOptions, parser: "json" }
+);
+writeFileSync(kosJsonPath, output);
+console.log(name + ": version -> " + version);
+`;
 function appendBarrelExport(codegenFs, indexPath, exportPath) {
   const exportLine = `export * from '${exportPath}'`;
   const content = codegenFs.read(indexPath) ?? "";
@@ -3006,6 +3391,8 @@ exports.LOCALIZED_PLUGIN_TYPES = LOCALIZED_PLUGIN_TYPES;
 exports.PLUGIN_TYPES = PLUGIN_TYPES;
 exports.PluginHandlerFactory = PluginHandlerFactory;
 exports.TrackingFileSystem = TrackingFileSystem;
+exports.UPDATE_RELEASE_VERSION_SCRIPT = UPDATE_RELEASE_VERSION_SCRIPT;
+exports.UPDATE_RELEASE_VERSION_SCRIPT_PATH = UPDATE_RELEASE_VERSION_SCRIPT_PATH;
 exports.ValidationError = ValidationError;
 exports.addChildToModel = addChildToModel;
 exports.addComputedToModel = addComputedToModel;
@@ -3013,17 +3400,23 @@ exports.addConfigPropertyToModel = addConfigPropertyToModel;
 exports.addContainerSupportToModel = addContainerSupportToModel;
 exports.addDependencyToModel = addDependencyToModel;
 exports.addFutureToModel = addFutureToModel;
+exports.addJavaArtifactToManifests = addJavaArtifactToManifests;
 exports.addKosModelConfiguration = addKosModelConfiguration;
 exports.addModelEffectToModel = addModelEffectToModel;
 exports.addPropertyToModel = addPropertyToModel;
 exports.addServiceRequestToModel = addServiceRequestToModel;
 exports.addTopicHandlerToModel = addTopicHandlerToModel;
 exports.appendBarrelExport = appendBarrelExport;
+exports.buildKabTargets = buildKabTargets;
 exports.camelCase = camelCase;
 exports.constantCase = constantCase;
 exports.dashCase = dashCase;
 exports.describeModel = describeModel;
+exports.discoverJavaArtifacts = discoverJavaArtifacts;
 exports.discoverProjects = discoverProjects;
+exports.discoverUiArtifacts = discoverUiArtifacts;
+exports.ensureJavaAggregatorPom = ensureJavaAggregatorPom;
+exports.finalizeArchetypeModule = finalizeArchetypeModule;
 exports.findProjectByName = findProjectByName;
 exports.findProjectForPath = findProjectForPath;
 exports.formatFiles = formatFiles;
@@ -3035,6 +3428,7 @@ exports.generateFilesFromTemplates = generateFilesFromTemplates;
 exports.generateHook = generateHook;
 exports.generateInit = generateInit;
 exports.generateModel = generateModel;
+exports.generatePolyglotWorkspace = generatePolyglotWorkspace;
 exports.generateSplashProject = generateSplashProject;
 exports.getCodegenLogger = getCodegenLogger;
 exports.getCurrentDirectoryName = getCurrentDirectoryName;
@@ -3052,6 +3446,7 @@ exports.readJson = readJson;
 exports.readNxJson = readNxJson;
 exports.resolveModelFilePath = resolveModelFilePath;
 exports.setCodegenLogger = setCodegenLogger;
+exports.syncCiManifests = syncCiManifests;
 exports.updateJson = updateJson;
 exports.updateModelIndex = updateModelIndex;
 exports.validateModel = validateModel;