Enhance project metadata and refactor core classes

Updated project files for `Beam.Dynamic`, `Beam.Exports`, `Beam.Temporary.Cli`, and `Beam` to include additional metadata and specific package versions. Refactored `DataBindings` and `ResolvedBindings` to records, added a new `Text` property in `Binding.cs`, and introduced `ParseNumbers` in `OnlineCleaner`. New classes `PuppetContext` and `PuppetUnitDownloader` added for Playwright integration. Introduced `ImmutableState` struct and `UnitDownloaderBinary` class for improved download management. Updated tests in `UnitTest1.cs` for number localization. Added `Beam.Puppeteer` project to the solution.

Beam.Temporary.Cli/DownloadBuilder.cs

@@ -1,5 +1,6 @@
 using aeqw89.DataKeys;
 using Beam.Dynamic;
+using Beam;
 using Microsoft.Extensions.Logging;
 using System;
 using System.Collections.Generic;
@@ -24,17 +25,18 @@ namespace Beam.Temporary.Cli {
         public interface ILinkStage {
             ITransformStage WithLink();
             ITransformStage WithLinkGenerator();
+            ILinkStage WithRange(Range range);
         }
 
         public interface ITransformStage {
-            IContextStage WithTransformer(Func<DataBindings, HtmlTransformer<T>> factory);
+            IContextStage<U> WithTransformer<U>(Func<DataBindings, AsyncTransformer<T, U>> factory);
         }
 
-        public interface IContextStage {
-            IContextStage Configure(Action<DownloadContextBuilder<T>> configure);
-            IContextStage WithParallelism(int degree);
-            IContextStage WithTimeout(TimeSpan timeout);
-            IContextStage WithRetryReporter(IProgress<RetryReport> reporter);
+        public interface IContextStage<U> {
+            IContextStage<U> Configure(Action<DownloadContextBuilder<T>> configure);
+            IContextStage<U> WithParallelism(int degree);
+            IContextStage<U> WithTimeout(TimeSpan timeout);
+            IContextStage<U> WithRetryReporter(IProgress<RetryReport> reporter);
             DownloadEnumerable<T> Build();
         }
 
@@ -61,7 +63,7 @@ namespace Beam.Temporary.Cli {
                 initial = textRecord.Resource.MetaTemplateInitialData ?? throw new InvalidOperationException("Meta template data missing.");
             } else {
                 source = textRecord.AssociatedSource ?? throw new InvalidOperationException($"Text source missing for '{novelKey}'.");
-                initial = textRecord.Resource.TemplateInitialData ?? throw new InvalidOperationException("Template initial data missing.");
+                initial = textRecord.Resource.TemplateInitialData;
             }
 
             return (source, initial);
@@ -74,6 +76,10 @@ namespace Beam.Temporary.Cli {
             State Initial,
             BeamDataDictionary Data,
             DownloadContextBuilder<T> CtxBuilder) : ILinkStage {
+
+            private State? endState;
+            private bool linksFrozen = false;
+
             public ITransformStage WithLink() {
                 var link = Data.Templates[Source.Key].Builder.Build(Initial);
                 CtxBuilder.WithLinks(new[] { link });
@@ -85,28 +91,45 @@ namespace Beam.Temporary.Cli {
                 var generator = SourceLinkEnumerable.FromGenerator(new OrderedSourceLinkGenerator(
                     template.Builder,
                     new NumberedStateChanger(template.Factory.Behavior),
-                    Initial));
+                    Initial, endState));
                 CtxBuilder.WithLinks(generator);
+                linksFrozen = true;
                 return new TransformStage(Source, Data, CtxBuilder);
             }
+
+            public ILinkStage WithRange(Range range) {
+                if (linksFrozen)
+                    throw new InvalidOperationException($"WithRange must be called before WithLinkGenerator");
+                if (range.End.Value < range.Start.Value)
+                    throw new ArgumentOutOfRangeException(nameof(range), $" start must be < end");
+                var template = Data.Templates[Source.Key];
+                var stateChanger = new NumberedStateChanger(template.Factory.Behavior);
+                endState = Initial.Copy();
+                stateChanger.Apply(Initial, range.Start.Value - 1);
+                stateChanger.Apply(endState, range.End.Value - 1);
+                return this;
+            }
         }
 
         private sealed record TransformStage(
             WebResource Source,
             BeamDataDictionary Data,
             DownloadContextBuilder<T> CtxBuilder) : ITransformStage {
-            public IContextStage WithTransformer(Func<DataBindings, HtmlTransformer<T>> factory) {
+            public IContextStage WithTransformer<U>(Func<DataBindings, Func<object, T>> factory) {
                 var transformer = factory(Data.Bindings[Source.Bindings]);
-                CtxBuilder.WithTransformer(transformer);
-                return new ContextStage(CtxBuilder);
+                return new ContextStage<U>(CtxBuilder, transformer);
             }
         }
 
-        private sealed class ContextStage : IContextStage {
+        private sealed class ContextStage<U> : IContextStage {
             private readonly DownloadContextBuilder<T> _ctxBuilder;
+            private readonly Func<object, T> _transformer;
             private int _parallelism = 4;
 
-            public ContextStage(DownloadContextBuilder<T> ctxBuilder) => _ctxBuilder = ctxBuilder;
+            public ContextStage(DownloadContextBuilder<T> ctxBuilder, Func<object, T> transformer) {
+                _ctxBuilder = ctxBuilder;
+                _transformer = transformer;
+            }
 
             public IContextStage Configure(Action<DownloadContextBuilder<T>> configure) {
                 configure(_ctxBuilder);
@@ -134,7 +157,7 @@ namespace Beam.Temporary.Cli {
                         context,
                         ctx => new UnitFragmentDownloader<T>(
                             context.Web,
-                            context.AsyncTranformer,
+                            _transformer,
                             context.AsyncFailurePredicates,
                             _parallelism,
                             context.DownloadLogger),