@uipath/codedapp-convert-sdk 0.1.0-beta.1

package/LICENSE.txt

@@ -0,0 +1,3 @@
+© 2026 UiPath
+Use of this product is subject (a) to the applicable licensing agreement available: https://www.uipath.com/legal/trust-and-security/legal-terms#content-1 and, (b) for paid products listed here https://licensing.uipath.com/: the licensing agreement agreed between you and UiPath.
+(UiPath means UiPath SRL with headquarters at 4 Vasile Alecsandri Str. and 11 Constantin Daniel Str., Building A, floors 5 and 6, District 1, Bucharest 010639, Romania and UiPath Inc. with principal place of business: One Vanderbilt Avenue, 60th Floor, New York, NY 10017)

package/README.md

@@ -0,0 +1,54 @@
+# @uipath/codedapp-convert-sdk
+
+The converter behind `uip codedapp convert`: one exported UiPath Apps app in, a React +
+TypeScript coded app out. This package is the published face of
+`lowcode-to-procode-migration`; the pipeline itself lives in the sibling packages and is
+bundled here.
+
+```ts
+import { convertFile, detectAppKind, checkPrerequisites } from '@uipath/codedapp-convert-sdk';
+
+detectAppKind('Expense.uiapp');        // 'uiapp' — 'uis' for a Solution, undefined otherwise
+checkPrerequisites();                  // { ok: true } or { ok: false, message, instructions }
+const result = await convertFile({ input: 'Expense.uiapp', outDir: './expense' });
+// result.report.path, result.pages, result.expressions, result.skill, …
+```
+
+What `convertFile` writes into `outDir`:
+
+- the project (`src/`, `index.html`, `package.json`, `vite.config.ts`, `uipath.json`, …);
+- `conversion-report.json` — what converted, what did not, and whose fault each gap is
+  (`converter`, `source-app`, `by-design`); read-only;
+- `conversion-log.ndjson` — every note of the run;
+- `.uipath/agent-skills/skills/fix-converted-app/SKILL.md` — the `fix-converted-app` skill
+  as a skill source, in the layout `uip skills install` reads. From the output directory,
+  `uip skills install --repo ./.uipath/agent-skills --path .` installs it for every coding
+  agent on the machine (Claude Code, Codex, Cursor, Copilot, …); then ask the agent to run
+  it. The converter installs the skill's source and runs no agent itself.
+
+Re-converting into the same directory replaces the generated files and keeps `uipath.json`
+(the user's OAuth client id) and `node_modules`.
+
+## Requirements
+
+- Node 20+.
+- The **.NET 10 runtime** (`dotnet` on the PATH): VB expressions are bound with the Roslyn
+  compiler, which ships in this package under `dist/roslyn-bridge/`. `checkPrerequisites()`
+  says so in one line when it is missing; `UIAPP_CONVERT_BRIDGE` can name a bridge
+  elsewhere.
+
+## Building
+
+```bash
+npm run build:sdk        # dotnet build -c Release packages/roslyn-bridge && bundle
+npm run -w packages/sdk smoke
+```
+
+`dist/index.js` is an ESM bundle of every workspace package; `typescript` and `decimal.js`
+stay as dependencies. `dist/index.d.ts` is kept by hand (four exports) and checked against
+the implementation by `packages/cli/test/convert-file.test.ts`.
+
+## Not in this build
+
+A `.uis` Solution (UB apps with XAML workflows) is recognised and refused with an
+instruction; its reader arrives with the workflows package (apps-dev-tools #165).

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Hand-kept types for the published bundle: the surface is four names, and the source
+ * packages are workspace-internal, so a generated declaration would drag their paths in.
+ * `packages/sdk/test/surface.test.ts` holds this file to the implementation at the type
+ * level — a field added, removed or retyped on one side fails `tsc` there.
+ */
+
+/** What a file's extension says it is: a standalone VB app, or a Solution. */
+export type AppKind = 'uiapp' | 'uis';
+
+export interface ConvertFileOptions {
+  /** The `.uiapp` (or `.uis`) to convert. */
+  input: string;
+  /** Where the project is written. Created if missing; generated files inside are replaced. */
+  outDir: string;
+  /** For a `.uis` Solution holding several apps: which one, or `all`. */
+  app?: string;
+  /** Bind every expression afresh rather than reusing the bind cache in `outDir`. */
+  noCache?: boolean;
+  dumpRequest?: boolean;
+  /** Terminal verbosity for the run's notes; the diary and report carry everything regardless. */
+  verbose?: boolean;
+  quiet?: boolean;
+  /** Print the human summary to the terminal. */
+  print?: boolean;
+}
+
+export interface ConvertFileResult {
+  kind: AppKind;
+  input: string;
+  outDir: string;
+  files: number;
+  kept: string[];
+  media: number;
+  pages: number;
+  expressions: { referenced: number; emitted: number; unbound: number; noRule: number; exact: number; lenient: number };
+  unconverted: { expressions: number; eventHandlers: number };
+  viewGaps: number;
+  syntaxProblems: string[];
+  /** Diagnostics that stopped behaviour converting; non-zero means exit 2 is warranted. */
+  blocking: number;
+  report: {
+    path: string;
+    issues: number;
+    converter: number;
+    sourceApp: number;
+    byDesign: number;
+  };
+  diaryNotes: number;
+  /** The skill as a skill source in the output; `source` is what `uip skills install --repo` takes. */
+  skill: { path: string; source: string } | undefined;
+}
+
+/** A problem with WHAT was given to convert, as opposed to a failure while converting it. */
+export declare class ConversionInputError extends Error {
+  readonly instructions?: string;
+  constructor(message: string, instructions?: string);
+}
+
+export declare function detectAppKind(path: string): AppKind | undefined;
+export declare function checkPrerequisites(): { ok: true } | { ok: false; message: string; instructions: string };
+export declare function convertFile(options: ConvertFileOptions): Promise<ConvertFileResult>;