@ng-forge/dynamic-forms 0.10.0-next.3 → 1.0.0-rc.1

package/schematics/ng-add/rules/add-packages.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPackages = addPackages;
+const tasks_1 = require("@angular-devkit/schematics/tasks");
+const dependencies_1 = require("@schematics/angular/utility/dependencies");
+const versions_1 = require("../../versions");
+const CORE_PACKAGE = {
+    name: '@ng-forge/dynamic-forms',
+    version: versions_1.VERSIONS['@ng-forge/dynamic-forms'],
+};
+// provideAnimations() (wired unless providers are skipped) imports from
+// @angular/platform-browser/animations, which needs @angular/animations —
+// not present in a fresh Angular app.
+// This is installed even for the `none` (core-only) adapter, because the
+// schematic still wires provideAnimations() unconditionally on the providers
+// path. Pass --skipProviders to opt out of both the wiring and the install.
+const ANIMATIONS_PACKAGE = {
+    name: '@angular/animations',
+    version: versions_1.VERSIONS['@angular/animations'],
+};
+function addPackages(recipe, includeAnimations, state) {
+    return (tree, ctx) => {
+        const all = [CORE_PACKAGE, ...(includeAnimations ? [ANIMATIONS_PACKAGE] : []), ...recipe.packages];
+        // @angular/animations ships from the core monorepo and pins @angular/core
+        // to its EXACT patch version. So it must match the installed core exactly,
+        // otherwise npm resolves the range to a newer patch and the peer check
+        // fails (e.g. animations@21.2.15 vs core@21.2.14). Material/CDK are a
+        // separate train (peer `^21.0.0`) and keep their declared range.
+        const angularVersion = getInstalledAngularVersion(tree);
+        let added = 0;
+        for (const pkg of all) {
+            const existing = (0, dependencies_1.getPackageJsonDependency)(tree, pkg.name);
+            if (existing) {
+                ctx.logger.info(`${pkg.name} already declared (${existing.version}); leaving as-is.`);
+                continue;
+            }
+            const version = pkg.name === '@angular/animations' && angularVersion ? angularVersion : pkg.version;
+            (0, dependencies_1.addPackageJsonDependency)(tree, {
+                type: dependencies_1.NodeDependencyType.Default,
+                name: pkg.name,
+                version,
+                overwrite: false,
+            });
+            added++;
+        }
+        if (added > 0) {
+            ctx.addTask(new tasks_1.NodePackageInstallTask());
+        }
+        state.added = added;
+        return tree;
+    };
+}
+/**
+ * Exact installed @angular/core version (e.g. "21.2.14"), so @angular/*
+ * packages we add lockstep with it. Prefers the resolved version in
+ * node_modules; falls back to the spec in package.json; null if neither.
+ */
+function getInstalledAngularVersion(tree) {
+    const corePkgPath = '/node_modules/@angular/core/package.json';
+    if (tree.exists(corePkgPath)) {
+        try {
+            const json = JSON.parse(tree.read(corePkgPath).toString('utf-8'));
+            if (typeof json.version === 'string' && json.version.length > 0) {
+                return json.version;
+            }
+        }
+        catch {
+            // fall through to package.json spec
+        }
+    }
+    return (0, dependencies_1.getPackageJsonDependency)(tree, '@angular/core')?.version ?? null;
+}
+//# sourceMappingURL=add-packages.js.map

package/schematics/ng-add/rules/add-packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-packages.js","sourceRoot":"","sources":["../../../../../../packages/dynamic-forms/schematics/ng-add/rules/add-packages.ts"],"names":[],"mappings":";;AAgCA,kCAkCC;AAjED,4DAA0E;AAC1E,2EAAkI;AAGlI,6CAA0C;AAW1C,MAAM,YAAY,GAAgB;IAChC,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,mBAAQ,CAAC,yBAAyB,CAAC;CAC7C,CAAC;AAEF,wEAAwE;AACxE,0EAA0E;AAC1E,sCAAsC;AACtC,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,kBAAkB,GAAgB;IACtC,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,mBAAQ,CAAC,qBAAqB,CAAC;CACzC,CAAC;AAEF,SAAgB,WAAW,CAAC,MAAqB,EAAE,iBAA0B,EAAE,KAAmB;IAChG,OAAO,CAAC,IAAU,EAAE,GAAqB,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnG,0EAA0E;QAC1E,2EAA2E;QAC3E,uEAAuE;QACvE,sEAAsE;QACtE,iEAAiE;QACjE,MAAM,cAAc,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,IAAA,uCAAwB,EAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,QAAQ,EAAE,CAAC;gBACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,sBAAsB,QAAQ,CAAC,OAAO,mBAAmB,CAAC,CAAC;gBACtF,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,qBAAqB,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;YACpG,IAAA,uCAAwB,EAAC,IAAI,EAAE;gBAC7B,IAAI,EAAE,iCAAkB,CAAC,OAAO;gBAChC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO;gBACP,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,KAAK,EAAE,CAAC;QACV,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,GAAG,CAAC,OAAO,CAAC,IAAI,8BAAsB,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CAAC,IAAU;IAC5C,MAAM,WAAW,GAAG,0CAA0C,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0B,CAAC;YAC5F,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChE,OAAO,IAAI,CAAC,OAAO,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,IAAA,uCAAwB,EAAC,IAAI,EAAE,eAAe,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;AAC1E,CAAC"}

package/schematics/ng-add/rules/add-providers.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addProviders = addProviders;
+const schematics_1 = require("@angular-devkit/schematics");
+const ast_utils_1 = require("@schematics/angular/utility/ast-utils");
+const rules_1 = require("@schematics/angular/utility/standalone/rules");
+const app_config_1 = require("@schematics/angular/utility/standalone/app_config");
+const util_1 = require("@schematics/angular/utility/standalone/util");
+function addProviders(recipe, legacyStatusClasses, projectName) {
+    return (tree, ctx) => {
+        // No target project (workspace has no application, or the workspace file
+        // couldn't be read). Don't guess a name — addRootProvider would throw and
+        // abort the whole ng-add. Warn and skip, mirroring addStyles' behaviour.
+        if (!projectName) {
+            ctx.logger.warn('No application project found; skipping provider wiring. ' +
+                'Add provideDynamicForm(...) to your ApplicationConfig manually — see ' +
+                'https://ng-forge.com/dynamic-forms/getting-started');
+            return tree;
+        }
+        const project = projectName;
+        return (0, schematics_1.chain)([
+            maybeAddRootProvider(project, 'provideAnimations', ({ code, external }) => code `${external('provideAnimations', '@angular/platform-browser/animations')}()`),
+            ...recipe.adapterProviders.flatMap((spec) => adapterProviderRules(project, spec)),
+            maybeAddRootProvider(project, 'provideDynamicForm', ({ code, external }) => {
+                const provide = external('provideDynamicForm', '@ng-forge/dynamic-forms');
+                if (recipe.withFields === null) {
+                    return code `${provide}()`;
+                }
+                const withFields = external(recipe.withFields.symbol, recipe.withFields.from);
+                if (legacyStatusClasses) {
+                    const withLegacy = external('withLegacyStatusClasses', '@ng-forge/dynamic-forms');
+                    return code `${provide}(...${withFields}(), ${withLegacy}())`;
+                }
+                return code `${provide}(...${withFields}())`;
+            }),
+        ]);
+    };
+}
+function adapterProviderRules(project, spec) {
+    return [
+        ...spec.defaultImports.map((imp) => addDefaultImportRule(imp.symbol, imp.from, project)),
+        maybeAddRootProvider(project, spec.marker, spec.builder),
+    ];
+}
+function addDefaultImportRule(symbol, module, project) {
+    return async (tree, ctx) => {
+        let mainFilePath;
+        try {
+            mainFilePath = await (0, util_1.getMainFilePath)(tree, project);
+        }
+        catch {
+            ctx.logger.warn(`Could not locate main.ts; skipping default import for ${symbol}.`);
+            return tree;
+        }
+        let filePath = mainFilePath;
+        try {
+            const bootstrapCall = (0, util_1.findBootstrapApplicationCall)(tree, mainFilePath);
+            const appConfig = (0, app_config_1.findAppConfig)(bootstrapCall, tree, mainFilePath);
+            if (appConfig) {
+                filePath = appConfig.filePath;
+            }
+        }
+        catch {
+            // fall back to main.ts
+        }
+        // insertImport throws (rather than no-op'ing) for an already-present
+        // DEFAULT import, so guard idempotency ourselves before calling it.
+        // Strip comments first so a commented-out import doesn't suppress the
+        // real insertion.
+        const existing = stripJsComments(tree.read(filePath)?.toString('utf-8') ?? '');
+        const moduleSpecifier = new RegExp(`from\\s+['"]${escapeRegExp(module)}['"]`);
+        if (moduleSpecifier.test(existing)) {
+            ctx.logger.info(`import ${symbol} from '${module}' already present; skipping.`);
+            return tree;
+        }
+        const source = (0, util_1.getSourceFile)(tree, filePath);
+        const change = (0, ast_utils_1.insertImport)(source, filePath, symbol, module, true);
+        (0, util_1.applyChangesToFile)(tree, filePath, [change]);
+        return tree;
+    };
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Strips line and block comments from JS/TS source for token-presence
+ * checks. Naive: doesn't account for `//` or `/*` characters that appear
+ * inside string/template literals — those would be unusual and aren't a
+ * realistic concern for the call-expression markers we're scanning for.
+ */
+function stripJsComments(source) {
+    return source.replace(/\/\*[\s\S]*?\*\//g, '').replace(/\/\/[^\n]*/g, '');
+}
+function maybeAddRootProvider(project, marker, callback) {
+    return async (tree, ctx) => {
+        const present = await isProviderPresent(tree, project, marker);
+        if (present) {
+            ctx.logger.info(`${marker}(...) already present in providers; skipping.`);
+            return (0, schematics_1.noop)();
+        }
+        return (0, rules_1.addRootProvider)(project, callback);
+    };
+}
+async function isProviderPresent(tree, project, marker) {
+    let mainFilePath;
+    try {
+        mainFilePath = await (0, util_1.getMainFilePath)(tree, project);
+    }
+    catch {
+        return false;
+    }
+    let filePath = mainFilePath;
+    try {
+        const bootstrapCall = (0, util_1.findBootstrapApplicationCall)(tree, mainFilePath);
+        const appConfig = (0, app_config_1.findAppConfig)(bootstrapCall, tree, mainFilePath);
+        if (appConfig) {
+            filePath = appConfig.filePath;
+        }
+    }
+    catch {
+        return false;
+    }
+    const buffer = tree.read(filePath);
+    if (!buffer) {
+        return false;
+    }
+    // Strip comments so a commented-out reference (e.g. `// provideDynamicForm()`)
+    // doesn't cause the schematic to skip real wiring.
+    const source = stripJsComments(buffer.toString('utf-8'));
+    return new RegExp(`\\b${marker}\\s*\\(`).test(source);
+}
+//# sourceMappingURL=add-providers.js.map

package/schematics/ng-add/rules/add-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-providers.js","sourceRoot":"","sources":["../../../../../../packages/dynamic-forms/schematics/ng-add/rules/add-providers.ts"],"names":[],"mappings":"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"}

package/schematics/ng-add/rules/add-styles.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addStyles = addStyles;
+const workspace_1 = require("@schematics/angular/utility/workspace");
+const FALLBACK_STYLES_PATHS = ['src/styles.scss', 'src/styles.css'];
+function addStyles(recipe, projectName) {
+    return async (tree, ctx) => {
+        if (recipe.styles.length === 0) {
+            return tree;
+        }
+        const stylesPath = await resolveStylesPath(tree, projectName);
+        if (!stylesPath) {
+            ctx.logger.warn('Could not locate a global styles file from angular.json. Skipping style imports. ' +
+                'Add the following imports manually:\n' +
+                recipe.styles.map((p) => `  @import '${p}';`).join('\n'));
+            return tree;
+        }
+        const buffer = tree.read(stylesPath);
+        const current = buffer ? buffer.toString('utf-8') : '';
+        const additions = [];
+        for (const style of recipe.styles) {
+            if (current.includes(style)) {
+                ctx.logger.info(`${style} already imported; skipping.`);
+                continue;
+            }
+            additions.push(`@import '${style}';`);
+        }
+        if (additions.length === 0) {
+            return tree;
+        }
+        const block = additions.join('\n');
+        const updated = insertImports(current, block);
+        tree.overwrite(stylesPath, updated);
+        ctx.logger.info(`Added ${additions.length} style import(s) to ${stylesPath}.`);
+        return tree;
+    };
+}
+/**
+ * Inserts the import block near the top, but AFTER any leading `@use` /
+ * `@forward` rules. In SCSS those must precede all other statements, so blindly
+ * prepending `@import` above them is a compile error. Plain CSS has no such
+ * constraint, so for a file with no `@use`/`@forward` this just prepends.
+ */
+function insertImports(current, block) {
+    if (current.length === 0) {
+        return `${block}\n`;
+    }
+    const lines = current.split('\n');
+    let insertAt = 0;
+    let inBlockComment = false;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (inBlockComment) {
+            if (trimmed.endsWith('*/')) {
+                inBlockComment = false;
+            }
+            continue;
+        }
+        if (trimmed === '' || trimmed.startsWith('//')) {
+            continue;
+        }
+        if (trimmed.startsWith('/*')) {
+            // Single-line block comment (e.g. `/* foo */`) stays out of block mode.
+            if (!trimmed.endsWith('*/')) {
+                inBlockComment = true;
+            }
+            continue;
+        }
+        if (trimmed.startsWith('@use ') || trimmed.startsWith('@forward ')) {
+            insertAt = i + 1; // insert after the last leading @use/@forward
+            continue;
+        }
+        break; // first real rule — stop
+    }
+    if (insertAt === 0) {
+        return `${block}\n${current}`;
+    }
+    const head = lines.slice(0, insertAt);
+    const tail = lines.slice(insertAt);
+    return [...head, block, ...tail].join('\n');
+}
+async function resolveStylesPath(tree, projectName) {
+    try {
+        const workspace = await (0, workspace_1.getWorkspace)(tree);
+        const project = projectName ? workspace.projects.get(projectName) : firstApplicationProject(workspace);
+        if (!project) {
+            return firstFallback(tree);
+        }
+        const buildTarget = project.targets.get('build');
+        const stylesOption = buildTarget?.options?.['styles'];
+        if (Array.isArray(stylesOption)) {
+            for (const entry of stylesOption) {
+                if (typeof entry === 'string' && tree.exists(entry)) {
+                    return entry;
+                }
+                if (entry && typeof entry === 'object' && 'input' in entry && typeof entry.input === 'string' && tree.exists(entry.input)) {
+                    return entry.input;
+                }
+            }
+        }
+        return firstFallback(tree);
+    }
+    catch {
+        return firstFallback(tree);
+    }
+}
+function firstApplicationProject(workspace) {
+    for (const [, project] of workspace.projects) {
+        if (project.extensions['projectType'] === 'application') {
+            return project;
+        }
+    }
+    return null;
+}
+function firstFallback(tree) {
+    for (const candidate of FALLBACK_STYLES_PATHS) {
+        if (tree.exists(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=add-styles.js.map

package/schematics/ng-add/rules/add-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-styles.js","sourceRoot":"","sources":["../../../../../../packages/dynamic-forms/schematics/ng-add/rules/add-styles.ts"],"names":[],"mappings":"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"}

package/schematics/ng-add/schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "NgForgeDynamicFormsNgAdd",
+  "title": "ng-forge dynamic-forms ng-add",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "Project to target. Defaults to the workspace default project.",
+      "$default": {
+        "$source": "projectName"
+      }
+    },
+    "adapter": {
+      "type": "string",
+      "description": "Which UI adapter to wire up.",
+      "enum": ["material", "bootstrap", "primeng", "ionic", "none"],
+      "x-prompt": {
+        "message": "Which UI adapter should ng-forge use?",
+        "type": "list",
+        "items": [
+          { "value": "material", "label": "Angular Material" },
+          { "value": "bootstrap", "label": "Bootstrap" },
+          { "value": "primeng", "label": "PrimeNG" },
+          { "value": "ionic", "label": "Ionic" },
+          { "value": "none", "label": "Core only (no adapter)" }
+        ]
+      }
+    },
+    "legacyStatusClasses": {
+      "type": "boolean",
+      "default": true,
+      "description": "Add withLegacyStatusClasses() to enable legacy .ng-touched / .ng-invalid CSS classes.",
+      "x-prompt": "Enable legacy .ng-touched / .ng-invalid CSS classes? (recommended)"
+    },
+    "skipStyles": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not modify the global styles file."
+    },
+    "skipProviders": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not modify the host ApplicationConfig."
+    }
+  },
+  "required": ["adapter"]
+}

package/schematics/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/schematics/versions.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSIONS = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function readOwnManifest() {
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'package.json'), 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+const manifest = readOwnManifest();
+const NG_FORGE = manifest.version ? `~${manifest.version}` : '~0.9.0';
+const ANGULAR = manifest.peerDependencies?.['@angular/core'] ?? '~21.2.0';
+const THIRD_PARTY = manifest.ngForgeSchematicDeps ?? {};
+exports.VERSIONS = {
+    '@ng-forge/dynamic-forms': NG_FORGE,
+    '@ng-forge/dynamic-forms-material': NG_FORGE,
+    '@ng-forge/dynamic-forms-bootstrap': NG_FORGE,
+    '@ng-forge/dynamic-forms-primeng': NG_FORGE,
+    '@ng-forge/dynamic-forms-ionic': NG_FORGE,
+    '@angular/animations': ANGULAR,
+    '@angular/material': ANGULAR,
+    '@angular/cdk': ANGULAR,
+    bootstrap: THIRD_PARTY['bootstrap'] ?? '^5.3.0',
+    primeng: THIRD_PARTY['primeng'] ?? '^21.0.0',
+    '@primeuix/themes': THIRD_PARTY['@primeuix/themes'] ?? '^2.0.0',
+    primeicons: THIRD_PARTY['primeicons'] ?? '^7.0.0',
+    '@ionic/angular': THIRD_PARTY['@ionic/angular'] ?? '^8.8.0',
+};
+//# sourceMappingURL=versions.js.map

package/schematics/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../../../packages/dynamic-forms/schematics/versions.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AACvC,yCAAiC;AAQjC,SAAS,eAAe;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAa,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;AAEnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC;AAC1E,MAAM,WAAW,GAAG,QAAQ,CAAC,oBAAoB,IAAI,EAAE,CAAC;AAE3C,QAAA,QAAQ,GAAG;IACtB,yBAAyB,EAAE,QAAQ;IACnC,kCAAkC,EAAE,QAAQ;IAC5C,mCAAmC,EAAE,QAAQ;IAC7C,iCAAiC,EAAE,QAAQ;IAC3C,+BAA+B,EAAE,QAAQ;IACzC,qBAAqB,EAAE,OAAO;IAC9B,mBAAmB,EAAE,OAAO;IAC5B,cAAc,EAAE,OAAO;IACvB,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,IAAI,QAAQ;IAC/C,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,SAAS;IAC5C,kBAAkB,EAAE,WAAW,CAAC,kBAAkB,CAAC,IAAI,QAAQ;IAC/D,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,QAAQ;IACjD,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,IAAI,QAAQ;CAC3B,CAAC"}

package/types/ng-forge-dynamic-forms-integration.d.ts

@@ -1,5 +1,7 @@
-import { FormEvent, FieldDef, FormEventConstructor, StateLogicConfig, BaseCheckedField, FieldMeta, BaseValueField, FieldOption, ArrayAllowedChildren, NonFieldLogicConfig, NextPageEvent, PreviousPageEvent, FieldWithValidation, ValidationMessages, DynamicText, ArrayItemContext, AnyAddon, BaseAddon, AddonActionHandler, DynamicValue, WrapperFieldInputs, AddonActionContext, EventBus } from '@ng-forge/dynamic-forms';
-export { FieldWrapper, InferWrapperRegistry, NonFieldLogicConfig, NonFieldLogicContext, NonFieldLogicType, WrapperFieldInputs, WrapperRegistration, WrapperTypeDefinition, WrappersBundle, createWrappers, isEqual, isWrappersBundle, resolveNonFieldDisabled, resolveNonFieldHidden, wrapperProps } from '@ng-forge/dynamic-forms';
+import { FormEvent, FormEventConstructor, NextPageEvent, PreviousPageEvent, FieldWithValidation, ArrayItemContext, BaseAddon, AddonActionHandler, DynamicValue } from '@ng-forge/dynamic-forms';
+export { ADDON_ACTION_HANDLERS, ADDON_ACTION_REGISTRY, ADDON_KIND_COMPONENT_CACHE, ADDON_KIND_DEFINITIONS, ADDON_KIND_REGISTRY, AddonActionHandler, BUILT_IN_FIELDS, FieldAddonSupportEntry, FieldWrapper, InferWrapperRegistry, NonFieldLogicConfig, NonFieldLogicContext, NonFieldLogicType, PresetCollaborators, WrapperRegistration, WrapperTypeDefinition, WrappersBundle, createWrappers, injectAddonKindRegistry, injectFieldsSupportingAddons, isWrappersBundle, resolveNonFieldDisabled, resolveNonFieldHidden, runPresetAction, wrapperProps } from '@ng-forge/dynamic-forms';
+import { FieldDef, StateLogicConfig, BaseCheckedField, FieldMeta, BaseValueField, FieldOption, ArrayAllowedChildren, NonFieldLogicConfig, ValidationMessages, DynamicText, AnyAddon, WrapperFieldInputs, AddonActionContext, EventBus } from '@ng-forge/dynamic-forms/internal';
+export { ARRAY_CONTEXT, ArrayContext, ArrayFieldTree, CheckedFieldComponent, DEFAULT_PROPS, DEFAULT_VALIDATION_MESSAGES, DEFAULT_WRAPPERS, DynamicTextPipe, EventBus, FIELD_REGISTRY, FIELD_SIGNAL_CONTEXT, FORM_OPTIONS, FieldScope, FieldSignalContext, FieldStateContext, FieldStateInfo, FieldTypeDefinition, FormFieldStateMap, GROUP_CONTEXT, HttpResourceRequest, INITIALIZATION_TIMEOUT_MS, MapperFn, ReadonlyFieldTree, RootFormRegistryService, ValueFieldComponent, ValueHandlingMode, WrapperFieldInputs, applyMetaToElement, applyValidator, applyValidators, arrayFieldMapper, baseFieldMapper, buildBaseInputs, containerFieldMapper, dynamicTextToObservable, getArrayLength, groupFieldMapper, injectFieldSignalContext, interpolateParams, isEqual, pageFieldMapper, resolveDynamicValue, resolveTokens, rowFieldMapper, textFieldMapper, toReadonlyFieldTree, withPreviousValue, writeToFieldValue } from '@ng-forge/dynamic-forms/internal';
 import * as i0 from '@angular/core';
 import { Signal, Injector, ElementRef, InjectionToken, Provider, WritableSignal, Type } from '@angular/core';
 import { FieldTree, SchemaPath } from '@angular/forms/signals';