@seniorsistemas/angular-components 19.9.15 → 19.10.0-develop-ef29acb7

package/schematics/migrations/migrate-app-to-standalone/index.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STANDALONE_MODE_DESCRIPTIONS = exports.STANDALONE_MODES = exports.OFFICIAL_MIGRATION_DOC = exports.ITEM_ID = void 0;
+exports.standaloneNoticeLines = standaloneNoticeLines;
+exports.resolveModes = resolveModes;
+exports.migrateAppToStandalone = migrateAppToStandalone;
+exports.migrate = migrate;
+const schematics_1 = require("@angular-devkit/schematics");
+const rxjs_1 = require("rxjs");
+const report_1 = require("../../utils/report");
+const scope_1 = require("../../utils/scope");
+/**
+ * ATENÇÃO: este schematic é um **wrapper** do schematic oficial do Angular (`@angular/core:standalone`,
+ * documentado em https://angular.dev/reference/migrations/standalone). Quem faz a migração é o Angular;
+ * o angular-components apenas o chama com as opções escolhidas e na ordem recomendada.
+ */
+exports.ITEM_ID = 'app-standalone';
+exports.OFFICIAL_MIGRATION_DOC = 'https://angular.dev/reference/migrations/standalone';
+/** Modos do schematic oficial, na ordem em que o Angular recomenda executá-los. */
+exports.STANDALONE_MODES = ['convert-to-standalone', 'prune-ng-modules', 'standalone-bootstrap'];
+/** O que cada modo do schematic oficial do Angular faz (conforme a documentação do Angular). */
+exports.STANDALONE_MODE_DESCRIPTIONS = {
+    'convert-to-standalone': 'converte componentes, diretivas e pipes para standalone (remove `standalone: false` e adiciona as dependências ao `imports` de cada um) e atualiza os NgModules que os declaravam, que passam a importá-los em vez de declará-los.',
+    'prune-ng-modules': 'remove os NgModules que ficaram sem função depois da conversão (sem `declarations`, `providers` nem `bootstrap`, e que não são usados em testes) e as referências a eles nos `imports`/`exports` de outros módulos.',
+    'standalone-bootstrap': 'troca `platformBrowserDynamic().bootstrapModule(AppModule)` por `bootstrapApplication(AppComponent, ...)`, move os providers e imports do módulo raiz para a configuração do bootstrap (por exemplo, `app.config.ts`, usando funções como `provideRouter` e `provideHttpClient` quando há equivalente) e remove o módulo raiz.',
+};
+/**
+ * Texto exibido ao final do `migrate-v20` (que não faz mais a pergunta): avisa que existe um schematic para as
+ * migrações nativas do Angular, lista tudo o que elas fazem e deixa claro de quem é a responsabilidade.
+ */
+function standaloneNoticeLines() {
+    return [
+        '',
+        'Migrações nativas do Angular (não executadas agora)',
+        'Existe um schematic que aplica no seu app as migrações nativas do Angular para standalone.',
+        'Essas migrações são feitas pelo Angular (@angular/core:standalone). O angular-components apenas chama o schematic oficial,',
+        'como um wrapper: o resultado e eventuais problemas dessa etapa vêm do schematic do Angular, e não do angular-components.',
+        'O que o Angular faz, em 3 modos executados nesta ordem:',
+        ...exports.STANDALONE_MODES.map((mode, index) => `  ${index + 1}. ${mode}: ${exports.STANDALONE_MODE_DESCRIPTIONS[mode]}`),
+        'O Angular recomenda rodar um modo por vez, conferir o build e revisar o diff entre eles.',
+        'Para executar (use --mode=... e --path=... para limitar):',
+        '  ng generate @seniorsistemas/angular-components:migrate-app-to-standalone',
+        `Documentação do Angular: ${exports.OFFICIAL_MIGRATION_DOC}`,
+    ];
+}
+/** Normaliza `--mode`, descarta inválidos e devolve sempre na ordem recomendada pelo Angular. */
+function resolveModes(raw) {
+    if (raw === undefined || raw === null || (Array.isArray(raw) && raw.length === 0) || raw === '') {
+        return { modes: [...exports.STANDALONE_MODES], unknown: [] };
+    }
+    const requested = (Array.isArray(raw) ? raw : [raw])
+        .flatMap((entry) => String(entry).split(','))
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    const unknown = requested.filter((entry) => !exports.STANDALONE_MODES.includes(entry));
+    const modes = exports.STANDALONE_MODES.filter((mode) => requested.includes(mode));
+    return { modes, unknown };
+}
+function migrateAppToStandalone(options, report) {
+    return async (tree, context) => {
+        const { modes, unknown } = resolveModes(options.mode);
+        for (const entry of unknown) {
+            context.logger.warn(`Modo "${entry}" ignorado. Valores aceitos: ${exports.STANDALONE_MODES.join(', ')}.`);
+        }
+        if (modes.length === 0)
+            return tree;
+        const scopeDir = (0, scope_1.resolveScopeDir)(tree, options, context);
+        const path = scopeDir ? `./${scopeDir}` : './';
+        context.logger.info([
+            'Conversão para standalone: este passo é um wrapper do schematic oficial do Angular',
+            '(@angular/core:standalone). A migração é feita pelo Angular, não pelo angular-components.',
+            `Documentação: ${exports.OFFICIAL_MIGRATION_DOC}`,
+            `Modos: ${modes.join(' → ')} | pasta: ${path}`,
+        ].join('\n'));
+        let current = tree;
+        for (const mode of modes) {
+            try {
+                current = await (0, rxjs_1.lastValueFrom)((0, schematics_1.callRule)((0, schematics_1.externalSchematic)('@angular/core', 'standalone-migration', { mode, path }), current, context));
+                report.markChanged(exports.ITEM_ID, `@angular/core:standalone (${mode})`);
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                report.addManual(exports.ITEM_ID, {
+                    file: 'angular.json',
+                    message: `o schematic oficial do Angular falhou no modo "${mode}" (${reason}). ` +
+                        `Corrija o build do projeto e rode "ng generate @angular/core:standalone" manualmente ` +
+                        `(${exports.OFFICIAL_MIGRATION_DOC}).`,
+                }, context);
+                break;
+            }
+        }
+        return current;
+    };
+}
+function migrate(options = {}) {
+    return migrateAppToStandalone(options, new report_1.MigrationReport());
+}
+//# sourceMappingURL=index.js.map

package/schematics/migrations/migrate-app-to-standalone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../projects/angular-components/schematics/migrations/migrate-app-to-standalone/index.ts"],"names":[],"mappings":"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"}

package/schematics/migrations/migrate-deprecated-apis/index.d.ts

@@ -0,0 +1,49 @@
+import { Rule } from '@angular-devkit/schematics';
+import { MigrationReport } from '../../utils/report';
+import { ScopeOptions } from '../../utils/scope';
+import { TemplateTransformResult } from '../../utils/template-utils';
+/**
+ * Migra APIs depreciadas que têm substituto direto (renomeios mecânicos), sempre restritas ao elemento
+ * ou símbolo correto, e avisa (`addManual`) onde a conversão é ambígua.
+ *
+ * Templates (HTML e `template:` inline): usa o scanner de tags de `template-utils` (nunca uma regex solta sobre o arquivo),
+ * então `(onCodeChange)` só muda em `<s-code-editor>`, `[scale]` só em `<input sBignumberInput|sNumberInput>`, etc.
+ *
+ * Decisões:
+ * - `sNumberInput`/`sBignumberInput`/`sLocalizedNumberInput` (e as respectivas `*Directive`/`*Module`) -> `sNumericMask`/
+ *   `NumericMaskDirective`. Os defaults das diretivas antigas diferem da `sNumericMask`, então são gravados de forma
+ *   explícita no template para preservar o comportamento: `[precision]="15"`, `[allowNegative]="true"`,
+ *   `[blockDecimalOverflow]="false"` e `[minDecimalPlaces]`/`[maxDecimalPlaces]` (a partir de `[scale]`, ou `0`).
+ *   Na `sLocalizedNumberInput`, `precision` (casas decimais) vira `maxDecimalPlaces` e sempre há aviso de revisão,
+ *   porque o valor do `FormControl` passa a ser `string` e o erro `invalidNumber` deixa de existir.
+ * - `NumberAlignmentOption.X`/`BignumberAlignmentOption.X` -> `'left'`/`'right'` (o enum não tem mais efeito).
+ * - `localizedCurrency` -> `localizedBignumber` (mesmos defaults: scale 2 e símbolo do locale; só a chave `currencySymbol`
+ *   vira `prefix`; `emptyAsZero: true` preserva a exibição de string vazia como 0); `localizedCurrencyImpure` ->
+ *   `localizedBignumberImpure` (preserva a detecção de mudança impura).
+ *   Argumento que não seja um objeto literal com chaves conhecidas -> aviso, sem reescrever.
+ * - `localizedNumber` usava `Intl.NumberFormat` (sem prefixo, até 3 casas); vira `localizedBignumber: { prefix: '', scale: N, emptyAsZero: true, nullAsZero: true }`
+ *   (N = literal ou 0; as duas opções preservam a exibição de vazio e null como 0) e SEMPRE gera um aviso de revisão, porque o arredondamento/separadores podem divergir.
+ * - Símbolos TS (pipes e `BreadcrumbModule`) só são trocados se todos os usos forem elementos de array (`imports`, etc.).
+ *   Se algum template ainda usa o pipe antigo (não migrável), o símbolo antigo é mantido ao lado do novo.
+ */
+export declare const ITEM_ID = "apis";
+/** Migra um texto de template (HTML inteiro ou conteúdo de `template:` inline). */
+export declare function migrateTemplateText(text: string, options?: {
+    quotesSafe: boolean;
+}): TemplateTransformResult;
+export type ReadTemplate = (relativeTo: string, templateUrl: string) => string | undefined;
+interface TsResult {
+    updated: string;
+    manual: Array<{
+        line: number;
+        message: string;
+    }>;
+}
+/**
+ * Migra um arquivo. `.html` (template), `.ts` (template inline, símbolos, enums e nós do rating-scale).
+ * `readTemplate` resolve `templateUrl` para decidir se um pipe antigo ainda é usado.
+ */
+export declare function migrateApisInContent(file: string, content: string, readTemplate?: ReadTemplate): TsResult;
+export declare function migrateDeprecatedApis(options: ScopeOptions, report: MigrationReport): Rule;
+export declare function migrate(options?: ScopeOptions): Rule;
+export {};