docs: fix precreated transform example

docs: split transform tsdoc examples

docs: add precreated transform examples

docs: expand transform tsdoc examples

Author: radist2s

packages/tree-shaking-plugin/src/lib/transform/mutate.ts

@@ -22,11 +22,38 @@ const traverse =
  *
  * @example
  * ```ts
+ * const source = `
+ * import { createAPIClient } from './api';
+ *
+ * const api = createAPIClient();
+ *
+ * export function App() {
+ *   api.pets.getPets.useQuery();
+ * }
+ * `;
+ *
+ * const plan = await createTransformPlan(source, id, options);
+ *
+ * applyTransformPlan(plan, plan.runtimeLocalNames);
+ *
+ * // `plan.ast` now contains the rewritten named client call and imports.
+ * ```
+ *
+ * @example
+ * ```ts
+ * const source = `
+ * import { client } from './client';
+ *
+ * export function App() {
+ *   client.pets.getPets.useQuery();
+ * }
+ * `;
+ *
  * const plan = await createTransformPlan(source, id, options);
  *
  * applyTransformPlan(plan, plan.runtimeLocalNames);
  *
- * // `plan.ast` is now mutated in place and ready for code generation.
+ * // `plan.ast` now contains the rewritten precreated client call.
  * ```
  */
 export function applyTransformPlan(

packages/tree-shaking-plugin/src/lib/transform/plan.ts

@@ -93,6 +93,16 @@ type ExportedDeclarationResolution = {
  *
  * @example
  * ```ts
+ * const source = `
+ * import { createAPIClient } from './api';
+ *
+ * const api = createAPIClient();
+ *
+ * export function App() {
+ *   api.pets.getPets.useQuery();
+ * }
+ * `;
+ *
  * const plan = await createTransformPlan(source, id, options);
  *
  * plan.clients[0]
@@ -110,12 +120,33 @@ type ExportedDeclarationResolution = {
  * //   callbackName: 'useQuery',
  * //   ...
  * // }
+ * ```
+ *
+ * @example
+ * ```ts
+ * const source = `
+ * import { client } from './client';
+ *
+ * export function App() {
+ *   client.pets.getPets.useQuery();
+ * }
+ * `;
+ *
+ * const plan = await createTransformPlan(source, id, options);
  *
- * plan.inlineUsages[0]
+ * plan.clients[0]
  * // {
- * //   callbackName: 'invalidateQueries',
- * //   callbackLocalName: 'invalidateQueries',
- * //   operationImport: { importPath: './api/services/PetsService' },
+ * //   name: 'client',
+ * //   mode: { type: 'precreated' },
+ * //   ...
+ * // }
+ *
+ * plan.namedUsages[0]
+ * // {
+ * //   client: { name: 'client' },
+ * //   serviceName: 'pets',
+ * //   operationName: 'getPets',
+ * //   callbackName: 'useQuery',
  * //   ...
  * // }
  * ```