├── .editorconfig
├── .gitignore
├── CODE_OF_CONDUCT.md
├── README.md
├── RepoSharedConfig.json
├── SECURITY.md
├── docs
    ├── configure-openai-backend.md
    ├── getting-started-blazor.md
    ├── getting-started-mvc-razor-pages.md
    ├── images
    │   ├── smart-combobox-expenses.gif
    │   ├── smart-paste-address.gif
    │   └── smart-textarea-hr.gif
    ├── local-embeddings.md
    ├── smart-combobox.md
    ├── smart-paste.md
    └── smart-textarea.md
├── nuget.config
└── samples
    ├── Directory.Build.props
    ├── Directory.Packages.props
    ├── ExampleBlazorApp
        ├── .gitignore
        ├── Components
        │   ├── App.razor
        │   ├── Layout
        │   │   ├── MainLayout.razor
        │   │   ├── MainLayout.razor.css
        │   │   └── NavBar.razor
        │   ├── Pages
        │   │   ├── Error.razor
        │   │   ├── Home
        │   │   │   ├── Home.razor
        │   │   │   └── WarnIfMissingConfiguration.razor
        │   │   ├── LocalEmbeddingsExamples
        │   │   │   ├── BasicLocalEmbeddings.razor
        │   │   │   └── Examples.razor
        │   │   ├── SmartComboBoxExamples
        │   │   │   └── Examples.razor
        │   │   ├── SmartPasteExamples
        │   │   │   ├── BasicForm.razor
        │   │   │   ├── BugReport.razor
        │   │   │   ├── Examples.razor
        │   │   │   └── MailAddress.razor
        │   │   └── SmartTextAreaExamples
        │   │   │   ├── Basic.razor
        │   │   │   ├── Basic.razor.css
        │   │   │   ├── Configurable.razor
        │   │   │   └── Examples.razor
        │   ├── Routes.razor
        │   ├── TabSet
        │   │   ├── Tab.razor
        │   │   └── TabSet.razor
        │   └── _Imports.razor
        ├── ExampleBlazorApp.csproj
        ├── Program.cs
        ├── Properties
        │   └── launchSettings.json
        ├── StatefulPageBase.razor
        ├── appsettings.Development.json
        ├── appsettings.json
        ├── tailwind.config.js
        └── wwwroot
        │   ├── app.css
        │   ├── default-form.css
        │   └── fonts
        │       └── inter
        │           ├── inter-v13-latin-200.woff2
        │           ├── inter-v13-latin-500.woff2
        │           ├── inter-v13-latin-600.woff2
        │           ├── inter-v13-latin-800.woff2
        │           └── inter-v13-latin-regular.woff2
    ├── ExampleMvcRazorPagesApp
        ├── Controllers
        │   └── HomeController.cs
        ├── ExampleMvcRazorPagesApp.csproj
        ├── Models
        │   └── ErrorViewModel.cs
        ├── Pages
        │   ├── SmartComboBox
        │   │   ├── Index.cshtml
        │   │   └── Index.cshtml.cs
        │   ├── SmartPaste
        │   │   ├── Index.cshtml
        │   │   └── Index.cshtml.cs
        │   ├── SmartTextArea
        │   │   ├── Index.cshtml
        │   │   └── Index.cshtml.cs
        │   ├── _ViewImports.cshtml
        │   └── _ViewStart.cshtml
        ├── Program.cs
        ├── Properties
        │   └── launchSettings.json
        ├── Views
        │   ├── Home
        │   │   └── Index.cshtml
        │   ├── Shared
        │   │   ├── Error.cshtml
        │   │   ├── _Layout.cshtml
        │   │   ├── _Layout.cshtml.css
        │   │   └── _ValidationScriptsPartial.cshtml
        │   ├── _ViewImports.cshtml
        │   └── _ViewStart.cshtml
        ├── appsettings.Development.json
        ├── appsettings.json
        └── wwwroot
        │   ├── css
        │       └── site.css
        │   ├── favicon.ico
        │   ├── js
        │       └── site.js
        │   └── lib
        │       ├── bootstrap
        │           ├── LICENSE
        │           └── dist
        │           │   ├── css
        │           │       ├── bootstrap-grid.css
        │           │       ├── bootstrap-grid.css.map
        │           │       ├── bootstrap-grid.min.css
        │           │       ├── bootstrap-grid.min.css.map
        │           │       ├── bootstrap-grid.rtl.css
        │           │       ├── bootstrap-grid.rtl.css.map
        │           │       ├── bootstrap-grid.rtl.min.css
        │           │       ├── bootstrap-grid.rtl.min.css.map
        │           │       ├── bootstrap-reboot.css
        │           │       ├── bootstrap-reboot.css.map
        │           │       ├── bootstrap-reboot.min.css
        │           │       ├── bootstrap-reboot.min.css.map
        │           │       ├── bootstrap-reboot.rtl.css
        │           │       ├── bootstrap-reboot.rtl.css.map
        │           │       ├── bootstrap-reboot.rtl.min.css
        │           │       ├── bootstrap-reboot.rtl.min.css.map
        │           │       ├── bootstrap-utilities.css
        │           │       ├── bootstrap-utilities.css.map
        │           │       ├── bootstrap-utilities.min.css
        │           │       ├── bootstrap-utilities.min.css.map
        │           │       ├── bootstrap-utilities.rtl.css
        │           │       ├── bootstrap-utilities.rtl.css.map
        │           │       ├── bootstrap-utilities.rtl.min.css
        │           │       ├── bootstrap-utilities.rtl.min.css.map
        │           │       ├── bootstrap.css
        │           │       ├── bootstrap.css.map
        │           │       ├── bootstrap.min.css
        │           │       ├── bootstrap.min.css.map
        │           │       ├── bootstrap.rtl.css
        │           │       ├── bootstrap.rtl.css.map
        │           │       ├── bootstrap.rtl.min.css
        │           │       └── bootstrap.rtl.min.css.map
        │           │   └── js
        │           │       ├── bootstrap.bundle.js
        │           │       ├── bootstrap.bundle.js.map
        │           │       ├── bootstrap.bundle.min.js
        │           │       ├── bootstrap.bundle.min.js.map
        │           │       ├── bootstrap.esm.js
        │           │       ├── bootstrap.esm.js.map
        │           │       ├── bootstrap.esm.min.js
        │           │       ├── bootstrap.esm.min.js.map
        │           │       ├── bootstrap.js
        │           │       ├── bootstrap.js.map
        │           │       ├── bootstrap.min.js
        │           │       └── bootstrap.min.js.map
        │       ├── jquery-validation-unobtrusive
        │           ├── LICENSE.txt
        │           ├── jquery.validate.unobtrusive.js
        │           └── jquery.validate.unobtrusive.min.js
        │       ├── jquery-validation
        │           ├── LICENSE.md
        │           └── dist
        │           │   ├── additional-methods.js
        │           │   ├── additional-methods.min.js
        │           │   ├── jquery.validate.js
        │           │   └── jquery.validate.min.js
        │       └── jquery
        │           ├── LICENSE.txt
        │           └── dist
        │               ├── jquery.js
        │               ├── jquery.min.js
        │               └── jquery.min.map
    ├── SmartComponentsSamples.sln
    └── shared
        ├── RepoSharedConfigUtil.cs
        └── TailwindIntegration.targets


/.editorconfig:
--------------------------------------------------------------------------------
  1 | @ -0,0 +1,450 @@
  2 | ; Copied from dotnet/aspnetcore's .editorconfig
  3 | 
  4 | ; This is the default for the codeline.
  5 | root = true
  6 | 
  7 | [*]
  8 | indent_style = space
  9 | charset = utf-8
 10 | trim_trailing_whitespace = true
 11 | insert_final_newline = true
 12 | 
 13 | [*.cs]
 14 | indent_size = 4
 15 | dotnet_sort_system_directives_first = true
 16 | 
 17 | # Don't use this. qualifier
 18 | dotnet_style_qualification_for_field = false:suggestion
 19 | dotnet_style_qualification_for_property = false:suggestion
 20 | 
 21 | # use int x = .. over Int32
 22 | dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
 23 | 
 24 | # use int.MaxValue over Int32.MaxValue
 25 | dotnet_style_predefined_type_for_member_access = true:suggestion
 26 | 
 27 | # Require var all the time.
 28 | csharp_style_var_for_built_in_types = true:suggestion
 29 | csharp_style_var_when_type_is_apparent = true:suggestion
 30 | csharp_style_var_elsewhere = true:suggestion
 31 | 
 32 | # Disallow throw expressions.
 33 | csharp_style_throw_expression = false:suggestion
 34 | 
 35 | # Newline settings
 36 | csharp_new_line_before_open_brace = all
 37 | csharp_new_line_before_else = true
 38 | csharp_new_line_before_catch = true
 39 | csharp_new_line_before_finally = true
 40 | csharp_new_line_before_members_in_object_initializers = true
 41 | csharp_new_line_before_members_in_anonymous_types = true
 42 | 
 43 | # Namespace settings
 44 | csharp_style_namespace_declarations = file_scoped
 45 | 
 46 | # Brace settings
 47 | csharp_prefer_braces = true # Prefer curly braces even for one line of code
 48 | 
 49 | # name all constant fields using PascalCase
 50 | dotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion
 51 | dotnet_naming_rule.constant_fields_should_be_pascal_case.symbols  = constant_fields
 52 | dotnet_naming_rule.constant_fields_should_be_pascal_case.style    = pascal_case_style
 53 | dotnet_naming_symbols.constant_fields.applicable_kinds   = field
 54 | dotnet_naming_symbols.constant_fields.required_modifiers = const
 55 | dotnet_naming_style.pascal_case_style.capitalization = pascal_case
 56 | 
 57 | # internal and private fields should be _camelCase
 58 | dotnet_naming_rule.camel_case_for_private_internal_fields.severity = suggestion
 59 | dotnet_naming_rule.camel_case_for_private_internal_fields.symbols  = private_internal_fields
 60 | dotnet_naming_rule.camel_case_for_private_internal_fields.style    = camel_case_underscore_style
 61 | dotnet_naming_symbols.private_internal_fields.applicable_kinds = field
 62 | dotnet_naming_symbols.private_internal_fields.applicable_accessibilities = private, internal
 63 | dotnet_naming_style.camel_case_underscore_style.required_prefix = _
 64 | dotnet_naming_style.camel_case_underscore_style.capitalization = camel_case
 65 | 
 66 | [*.{xml,config,*proj,nuspec,props,resx,targets,yml,tasks}]
 67 | indent_size = 2
 68 | 
 69 | # Xml config files
 70 | [*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct}]
 71 | indent_size = 2
 72 | 
 73 | [*.json]
 74 | indent_size = 2
 75 | 
 76 | [*.{ps1,psm1}]
 77 | indent_size = 4
 78 | 
 79 | [*.sh]
 80 | indent_size = 4
 81 | end_of_line = lf
 82 | 
 83 | [*.{razor,cshtml}]
 84 | charset = utf-8-bom
 85 | 
 86 | [*.{cs,vb}]
 87 | 
 88 | # SYSLIB1054: Use 'LibraryImportAttribute' instead of 'DllImportAttribute' to generate P/Invoke marshalling code at compile time
 89 | dotnet_diagnostic.SYSLIB1054.severity = warning
 90 | 
 91 | # CA1018: Mark attributes with AttributeUsageAttribute
 92 | dotnet_diagnostic.CA1018.severity = warning
 93 | 
 94 | # CA1047: Do not declare protected member in sealed type
 95 | dotnet_diagnostic.CA1047.severity = warning
 96 | 
 97 | # CA1305: Specify IFormatProvider
 98 | dotnet_diagnostic.CA1305.severity = warning
 99 | 
100 | # CA1507: Use nameof to express symbol names
101 | dotnet_diagnostic.CA1507.severity = warning
102 | 
103 | # CA1510: Use ArgumentNullException throw helper
104 | dotnet_diagnostic.CA1510.severity = warning
105 | 
106 | # CA1511: Use ArgumentException throw helper
107 | dotnet_diagnostic.CA1511.severity = warning
108 | 
109 | # CA1512: Use ArgumentOutOfRangeException throw helper
110 | dotnet_diagnostic.CA1512.severity = warning
111 | 
112 | # CA1513: Use ObjectDisposedException throw helper
113 | dotnet_diagnostic.CA1513.severity = warning
114 | 
115 | # CA1725: Parameter names should match base declaration
116 | dotnet_diagnostic.CA1725.severity = suggestion
117 | 
118 | # CA1802: Use literals where appropriate
119 | dotnet_diagnostic.CA1802.severity = warning
120 | 
121 | # CA1805: Do not initialize unnecessarily
122 | dotnet_diagnostic.CA1805.severity = warning
123 | 
124 | # CA1810: Do not initialize unnecessarily
125 | dotnet_diagnostic.CA1810.severity = warning
126 | 
127 | # CA1821: Remove empty Finalizers
128 | dotnet_diagnostic.CA1821.severity = warning
129 | 
130 | # CA1822: Make member static
131 | dotnet_diagnostic.CA1822.severity = warning
132 | dotnet_code_quality.CA1822.api_surface = private, internal
133 | 
134 | # CA1823: Avoid unused private fields
135 | dotnet_diagnostic.CA1823.severity = warning
136 | 
137 | # CA1825: Avoid zero-length array allocations
138 | dotnet_diagnostic.CA1825.severity = warning
139 | 
140 | # CA1826: Do not use Enumerable methods on indexable collections. Instead use the collection directly
141 | dotnet_diagnostic.CA1826.severity = warning
142 | 
143 | # CA1827: Do not use Count() or LongCount() when Any() can be used
144 | dotnet_diagnostic.CA1827.severity = warning
145 | 
146 | # CA1828: Do not use CountAsync() or LongCountAsync() when AnyAsync() can be used
147 | dotnet_diagnostic.CA1828.severity = warning
148 | 
149 | # CA1829: Use Length/Count property instead of Count() when available
150 | dotnet_diagnostic.CA1829.severity = warning
151 | 
152 | # CA1830: Prefer strongly-typed Append and Insert method overloads on StringBuilder
153 | dotnet_diagnostic.CA1830.severity = warning
154 | 
155 | # CA1831: Use AsSpan or AsMemory instead of Range-based indexers when appropriate
156 | dotnet_diagnostic.CA1831.severity = warning
157 | 
158 | # CA1832: Use AsSpan or AsMemory instead of Range-based indexers when appropriate
159 | dotnet_diagnostic.CA1832.severity = warning
160 | 
161 | # CA1833: Use AsSpan or AsMemory instead of Range-based indexers when appropriate
162 | dotnet_diagnostic.CA1833.severity = warning
163 | 
164 | # CA1834: Consider using 'StringBuilder.Append(char)' when applicable
165 | dotnet_diagnostic.CA1834.severity = warning
166 | 
167 | # CA1835: Prefer the 'Memory'-based overloads for 'ReadAsync' and 'WriteAsync'
168 | dotnet_diagnostic.CA1835.severity = warning
169 | 
170 | # CA1836: Prefer IsEmpty over Count
171 | dotnet_diagnostic.CA1836.severity = warning
172 | 
173 | # CA1837: Use 'Environment.ProcessId'
174 | dotnet_diagnostic.CA1837.severity = warning
175 | 
176 | # CA1838: Avoid 'StringBuilder' parameters for P/Invokes
177 | dotnet_diagnostic.CA1838.severity = warning
178 | 
179 | # CA1839: Use 'Environment.ProcessPath'
180 | dotnet_diagnostic.CA1839.severity = warning
181 | 
182 | # CA1840: Use 'Environment.CurrentManagedThreadId'
183 | dotnet_diagnostic.CA1840.severity = warning
184 | 
185 | # CA1841: Prefer Dictionary.Contains methods
186 | dotnet_diagnostic.CA1841.severity = warning
187 | 
188 | # CA1842: Do not use 'WhenAll' with a single task
189 | dotnet_diagnostic.CA1842.severity = warning
190 | 
191 | # CA1843: Do not use 'WaitAll' with a single task
192 | dotnet_diagnostic.CA1843.severity = warning
193 | 
194 | # CA1844: Provide memory-based overrides of async methods when subclassing 'Stream'
195 | dotnet_diagnostic.CA1844.severity = warning
196 | 
197 | # CA1845: Use span-based 'string.Concat'
198 | dotnet_diagnostic.CA1845.severity = warning
199 | 
200 | # CA1846: Prefer AsSpan over Substring
201 | dotnet_diagnostic.CA1846.severity = warning
202 | 
203 | # CA1847: Use string.Contains(char) instead of string.Contains(string) with single characters
204 | dotnet_diagnostic.CA1847.severity = warning
205 | 
206 | # CA1852: Seal internal types
207 | dotnet_diagnostic.CA1852.severity = warning
208 | 
209 | # CA1854: Prefer the IDictionary.TryGetValue(TKey, out TValue) method
210 | dotnet_diagnostic.CA1854.severity = warning
211 | 
212 | # CA1855: Prefer 'Clear' over 'Fill'
213 | dotnet_diagnostic.CA1855.severity = warning
214 | 
215 | # CA1856: Incorrect usage of ConstantExpected attribute
216 | dotnet_diagnostic.CA1856.severity = error
217 | 
218 | # CA1857: A constant is expected for the parameter
219 | dotnet_diagnostic.CA1857.severity = warning
220 | 
221 | # CA1858: Use 'StartsWith' instead of 'IndexOf'
222 | dotnet_diagnostic.CA1858.severity = warning
223 | 
224 | # CA2007: Consider calling ConfigureAwait on the awaited task
225 | #dotnet_diagnostic.CA2007.severity = warning
226 | 
227 | # CA2008: Do not create tasks without passing a TaskScheduler
228 | dotnet_diagnostic.CA2008.severity = warning
229 | 
230 | # CA2009: Do not call ToImmutableCollection on an ImmutableCollection value
231 | dotnet_diagnostic.CA2009.severity = warning
232 | 
233 | # CA2011: Avoid infinite recursion
234 | dotnet_diagnostic.CA2011.severity = warning
235 | 
236 | # CA2012: Use ValueTask correctly
237 | dotnet_diagnostic.CA2012.severity = warning
238 | 
239 | # CA2013: Do not use ReferenceEquals with value types
240 | dotnet_diagnostic.CA2013.severity = warning
241 | 
242 | # CA2014: Do not use stackalloc in loops.
243 | dotnet_diagnostic.CA2014.severity = warning
244 | 
245 | # CA2016: Forward the 'CancellationToken' parameter to methods that take one
246 | dotnet_diagnostic.CA2016.severity = warning
247 | 
248 | # CA2200: Rethrow to preserve stack details
249 | dotnet_diagnostic.CA2200.severity = warning
250 | 
251 | # CA2201: Do not raise reserved exception types
252 | dotnet_diagnostic.CA2201.severity = warning
253 | 
254 | # CA2208: Instantiate argument exceptions correctly
255 | dotnet_diagnostic.CA2208.severity = warning
256 | 
257 | # CA2245: Do not assign a property to itself
258 | dotnet_diagnostic.CA2245.severity = warning
259 | 
260 | # CA2246: Assigning symbol and its member in the same statement
261 | dotnet_diagnostic.CA2246.severity = warning
262 | 
263 | # CA2249: Use string.Contains instead of string.IndexOf to improve readability.
264 | dotnet_diagnostic.CA2249.severity = warning
265 | 
266 | # IDE0005: Remove unnecessary usings
267 | dotnet_diagnostic.IDE0005.severity = warning
268 | 
269 | # IDE0011: Curly braces to surround blocks of code
270 | dotnet_diagnostic.IDE0011.severity = warning
271 | 
272 | # IDE0020: Use pattern matching to avoid is check followed by a cast (with variable)
273 | dotnet_diagnostic.IDE0020.severity = warning
274 | 
275 | # IDE0029: Use coalesce expression (non-nullable types)
276 | dotnet_diagnostic.IDE0029.severity = warning
277 | 
278 | # IDE0030: Use coalesce expression (nullable types)
279 | dotnet_diagnostic.IDE0030.severity = warning
280 | 
281 | # IDE0031: Use null propagation
282 | dotnet_diagnostic.IDE0031.severity = warning
283 | 
284 | # IDE0035: Remove unreachable code
285 | dotnet_diagnostic.IDE0035.severity = warning
286 | 
287 | # IDE0036: Order modifiers
288 | csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:suggestion
289 | dotnet_diagnostic.IDE0036.severity = warning
290 | 
291 | # IDE0038: Use pattern matching to avoid is check followed by a cast (without variable)
292 | dotnet_diagnostic.IDE0038.severity = warning
293 | 
294 | # IDE0043: Format string contains invalid placeholder
295 | dotnet_diagnostic.IDE0043.severity = warning
296 | 
297 | # IDE0044: Make field readonly
298 | dotnet_diagnostic.IDE0044.severity = warning
299 | 
300 | # IDE0051: Remove unused private members
301 | dotnet_diagnostic.IDE0051.severity = warning
302 | 
303 | # IDE0055: All formatting rules
304 | dotnet_diagnostic.IDE0055.severity = suggestion
305 | 
306 | # IDE0059: Unnecessary assignment to a value
307 | dotnet_diagnostic.IDE0059.severity = warning
308 | 
309 | # IDE0060: Remove unused parameter
310 | dotnet_code_quality_unused_parameters = non_public
311 | dotnet_diagnostic.IDE0060.severity = warning
312 | 
313 | # IDE0062: Make local function static
314 | dotnet_diagnostic.IDE0062.severity = warning
315 | 
316 | # IDE0073: File header
317 | dotnet_diagnostic.IDE0073.severity = warning
318 | file_header_template = Licensed to the .NET Foundation under one or more agreements.\nThe .NET Foundation licenses this file to you under the MIT license.
319 | 
320 | # IDE0161: Convert to file-scoped namespace
321 | dotnet_diagnostic.IDE0161.severity = warning
322 | 
323 | # IDE0200: Lambda expression can be removed
324 | dotnet_diagnostic.IDE0200.severity = warning
325 | 
326 | # IDE2000: Disallow multiple blank lines
327 | dotnet_style_allow_multiple_blank_lines_experimental = false
328 | dotnet_diagnostic.IDE2000.severity = warning
329 | 
330 | [{eng/tools/**.cs,**/{test,testassets,samples,Samples,perf,benchmarkapps,scripts,stress}/**.cs,src/Hosting/Server.IntegrationTesting/**.cs,src/Servers/IIS/IntegrationTesting.IIS/**.cs,src/Shared/Http2cat/**.cs,src/Testing/**.cs}]
331 | # CA1018: Mark attributes with AttributeUsageAttribute
332 | dotnet_diagnostic.CA1018.severity = suggestion
333 | # CA1507: Use nameof to express symbol names
334 | dotnet_diagnostic.CA1507.severity = suggestion
335 | # CA1510: Use ArgumentNullException throw helper
336 | dotnet_diagnostic.CA1510.severity = suggestion
337 | # CA1511: Use ArgumentException throw helper
338 | dotnet_diagnostic.CA1511.severity = suggestion
339 | # CA1512: Use ArgumentOutOfRangeException throw helper
340 | dotnet_diagnostic.CA1512.severity = suggestion
341 | # CA1513: Use ObjectDisposedException throw helper
342 | dotnet_diagnostic.CA1513.severity = suggestion
343 | # CA1802: Use literals where appropriate
344 | dotnet_diagnostic.CA1802.severity = suggestion
345 | # CA1805: Do not initialize unnecessarily
346 | dotnet_diagnostic.CA1805.severity = suggestion
347 | # CA1810: Do not initialize unnecessarily
348 | dotnet_diagnostic.CA1810.severity = suggestion
349 | # CA1822: Make member static
350 | dotnet_diagnostic.CA1822.severity = suggestion
351 | # CA1823: Avoid zero-length array allocations
352 | dotnet_diagnostic.CA1825.severity = suggestion
353 | # CA1826: Do not use Enumerable methods on indexable collections. Instead use the collection directly
354 | dotnet_diagnostic.CA1826.severity = suggestion
355 | # CA1827: Do not use Count() or LongCount() when Any() can be used
356 | dotnet_diagnostic.CA1827.severity = suggestion
357 | # CA1829: Use Length/Count property instead of Count() when available
358 | dotnet_diagnostic.CA1829.severity = suggestion
359 | # CA1831: Use AsSpan or AsMemory instead of Range-based indexers when appropriate
360 | dotnet_diagnostic.CA1831.severity = suggestion
361 | # CA1832: Use AsSpan or AsMemory instead of Range-based indexers when appropriate
362 | dotnet_diagnostic.CA1832.severity = suggestion
363 | # CA1833: Use AsSpan or AsMemory instead of Range-based indexers when appropriate
364 | dotnet_diagnostic.CA1833.severity = suggestion
365 | # CA1834: Consider using 'StringBuilder.Append(char)' when applicable
366 | dotnet_diagnostic.CA1834.severity = suggestion
367 | # CA1835: Prefer the 'Memory'-based overloads for 'ReadAsync' and 'WriteAsync'
368 | dotnet_diagnostic.CA1835.severity = suggestion
369 | # CA1837: Use 'Environment.ProcessId'
370 | dotnet_diagnostic.CA1837.severity = suggestion
371 | # CA1838: Avoid 'StringBuilder' parameters for P/Invokes
372 | dotnet_diagnostic.CA1838.severity = suggestion
373 | # CA1841: Prefer Dictionary.Contains methods
374 | dotnet_diagnostic.CA1841.severity = suggestion
375 | # CA1844: Provide memory-based overrides of async methods when subclassing 'Stream'
376 | dotnet_diagnostic.CA1844.severity = suggestion
377 | # CA1845: Use span-based 'string.Concat'
378 | dotnet_diagnostic.CA1845.severity = suggestion
379 | # CA1846: Prefer AsSpan over Substring
380 | dotnet_diagnostic.CA1846.severity = suggestion
381 | # CA1847: Use string.Contains(char) instead of string.Contains(string) with single characters
382 | dotnet_diagnostic.CA1847.severity = suggestion
383 | # CA1852: Seal internal types
384 | dotnet_diagnostic.CA1852.severity = suggestion
385 | # CA1854: Prefer the IDictionary.TryGetValue(TKey, out TValue) method
386 | dotnet_diagnostic.CA1854.severity = suggestion
387 | # CA1855: Prefer 'Clear' over 'Fill'
388 | dotnet_diagnostic.CA1855.severity = suggestion
389 | # CA1856: Incorrect usage of ConstantExpected attribute
390 | dotnet_diagnostic.CA1856.severity = suggestion
391 | # CA1857: A constant is expected for the parameter
392 | dotnet_diagnostic.CA1857.severity = suggestion
393 | # CA1858: Use 'StartsWith' instead of 'IndexOf'
394 | dotnet_diagnostic.CA1858.severity = suggestion
395 | # CA2007: Consider calling ConfigureAwait on the awaited task
396 | dotnet_diagnostic.CA2007.severity = suggestion
397 | # CA2008: Do not create tasks without passing a TaskScheduler
398 | dotnet_diagnostic.CA2008.severity = suggestion
399 | # CA2012: Use ValueTask correctly
400 | dotnet_diagnostic.CA2012.severity = suggestion
401 | # CA2201: Do not raise reserved exception types
402 | dotnet_diagnostic.CA2201.severity = suggestion
403 | # CA2249: Use string.Contains instead of string.IndexOf to improve readability.
404 | dotnet_diagnostic.CA2249.severity = suggestion
405 | # IDE0005: Remove unnecessary usings
406 | dotnet_diagnostic.IDE0005.severity = suggestion
407 | # IDE0020: Use pattern matching to avoid is check followed by a cast (with variable)
408 | dotnet_diagnostic.IDE0020.severity = suggestion
409 | # IDE0029: Use coalesce expression (non-nullable types)
410 | dotnet_diagnostic.IDE0029.severity = suggestion
411 | # IDE0030: Use coalesce expression (nullable types)
412 | dotnet_diagnostic.IDE0030.severity = suggestion
413 | # IDE0031: Use null propagation
414 | dotnet_diagnostic.IDE0031.severity = suggestion
415 | # IDE0038: Use pattern matching to avoid is check followed by a cast (without variable)
416 | dotnet_diagnostic.IDE0038.severity = suggestion
417 | # IDE0044: Make field readonly
418 | dotnet_diagnostic.IDE0044.severity = suggestion
419 | # IDE0051: Remove unused private members
420 | dotnet_diagnostic.IDE0051.severity = suggestion
421 | # IDE0059: Unnecessary assignment to a value
422 | dotnet_diagnostic.IDE0059.severity = suggestion
423 | # IDE0060: Remove unused parameters
424 | dotnet_diagnostic.IDE0060.severity = suggestion
425 | # IDE0062: Make local function static
426 | dotnet_diagnostic.IDE0062.severity = suggestion
427 | # IDE0200: Lambda expression can be removed
428 | dotnet_diagnostic.IDE0200.severity = suggestion
429 | 
430 | # CA2016: Forward the 'CancellationToken' parameter to methods that take one
431 | dotnet_diagnostic.CA2016.severity = suggestion
432 | 
433 | # Defaults for content in the shared src/ and shared runtime dir
434 | 
435 | [{**/Shared/runtime/**.{cs,vb},src/Shared/test/Shared.Tests/runtime/**.{cs,vb},**/microsoft.extensions.hostfactoryresolver.sources/**.{cs,vb}}]
436 | # CA1822: Make member static
437 | dotnet_diagnostic.CA1822.severity = silent
438 | # IDE0011: Use braces
439 | dotnet_diagnostic.IDE0011.severity = silent
440 | # IDE0055: Fix formatting
441 | dotnet_diagnostic.IDE0055.severity = silent
442 | # IDE0060: Remove unused parameters
443 | dotnet_diagnostic.IDE0060.severity = silent
444 | # IDE0062: Make local function static
445 | dotnet_diagnostic.IDE0062.severity = silent
446 | # IDE0161: Convert to file-scoped namespace
447 | dotnet_diagnostic.IDE0161.severity = silent
448 | 
449 | [{**/Shared/**.cs,**/microsoft.extensions.hostfactoryresolver.sources/**.{cs,vb}}]
450 | # IDE0005: Remove unused usings. Ignore for shared src files since imports for those depend on the projects in which they are included.
451 | dotnet_diagnostic.IDE0005.severity = silent
452 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | bin/
 2 | obj/
 3 | *.csproj.user
 4 | *.suo
 5 | *.vs
 6 | node_modules/
 7 | artifacts/
 8 | *.lib.module.js
 9 | .tailwind/
10 | 


--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
 1 | # Microsoft Open Source Code of Conduct
 2 | 
 3 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 4 | 
 5 | Resources:
 6 | 
 7 | - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
 8 | - [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
 9 | - Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
10 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Repo moved
2 | 
3 | The contents of this repository have now moved to https://github.com/dotnet/smartcomponents
4 | 
5 | As [requested](https://github.com/dotnet-smartcomponents/smartcomponents/issues/13), we've now open-sourced all the code for Smart Components.
6 | 


--------------------------------------------------------------------------------
/RepoSharedConfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "SmartComponents": {
 3 |     // TODO: Add values here to run samples in this repo
 4 |     // Do not commit your changes to source control
 5 | 
 6 |     //"SelfHosted": false,
 7 |     //"DeploymentName": "",
 8 |     //"Endpoint": "",
 9 |     //"ApiKey": ""
10 |   }
11 | }
12 | 


--------------------------------------------------------------------------------
/SECURITY.md:
--------------------------------------------------------------------------------
 1 | <!-- BEGIN MICROSOFT SECURITY.MD V0.0.9 BLOCK -->
 2 | 
 3 | ## Security
 4 | 
 5 | Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) and [Xamarin](https://github.com/xamarin).
 6 | 
 7 | If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/security.md/definition), please report it to us as described below.
 8 | 
 9 | ## Reporting Security Issues
10 | 
11 | **Please do not report security vulnerabilities through public GitHub issues.**
12 | 
13 | Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).
14 | 
15 | If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/security.md/msrc/pgp).
16 | 
17 | You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). 
18 | 
19 | Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
20 | 
21 |   * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
22 |   * Full paths of source file(s) related to the manifestation of the issue
23 |   * The location of the affected source code (tag/branch/commit or direct URL)
24 |   * Any special configuration required to reproduce the issue
25 |   * Step-by-step instructions to reproduce the issue
26 |   * Proof-of-concept or exploit code (if possible)
27 |   * Impact of the issue, including how an attacker might exploit the issue
28 | 
29 | This information will help us triage your report more quickly.
30 | 
31 | If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) page for more details about our active programs.
32 | 
33 | ## Preferred Languages
34 | 
35 | We prefer all communications to be in English.
36 | 
37 | ## Policy
38 | 
39 | Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/security.md/cvd).
40 | 
41 | <!-- END MICROSOFT SECURITY.MD BLOCK -->
42 | 


--------------------------------------------------------------------------------
/docs/configure-openai-backend.md:
--------------------------------------------------------------------------------
 1 | # Configure the OpenAI backend
 2 | 
 3 | Do the following in your **server** project:
 4 | 
 5 | * Install the package `SmartComponents.Inference.OpenAI`
 6 | * In `Program.cs`, update your call to `AddSmartComponents` as follows:
 7 | 
 8 |     ```cs
 9 |     builder.Services.AddSmartComponents()
10 |         .WithInferenceBackend<OpenAIInferenceBackend>();
11 |     ```
12 | 
13 | * Configure API keys by adding a block similar to the following at the top level inside `appsettings.Development.json`:
14 | 
15 |     ```json
16 |     "SmartComponents": {
17 |       "ApiKey": "your key here",
18 |       "DeploymentName": "gpt-3.5-turbo",
19 | 
20 |       // Required for Azure OpenAI only. If you're using OpenAI, remove the following line.
21 |       "Endpoint": "https://YOUR_ACCOUNT.openai.azure.com/"
22 |     }
23 |     ```
24 | 
25 |     * To use Azure OpenAI, first [deploy an Azure OpenAI Service](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource), then values for `ApiKey`, `DeploymentName`, and `Endpoint` will all be provided to you.
26 | 
27 |     * Or, to use OpenAI, [create an API key](https://platform.openai.com/api-keys). The value for `DeploymentName` is the model you wish to use (e.g., `gpt-3.5-turbo`, `gpt-4`, etc.). Remove the `Endpoint` line from configuration entirely.
28 | 
29 | ## Using Ollama or another self-hosted endpoint
30 | 
31 | If you prefer, you can use [Ollama](https://ollama.com/) or any other endpoint that is compatible with the OpenAI API schema.
32 | 
33 | To do this, add a config value `SelfHosted` with value `true`, and give the URL to your endpoint. For example, to use Ollama locally:
34 | 
35 | ```json
36 | "SmartComponents": {
37 |   "SelfHosted": true,
38 |   "DeploymentName": "mistral:7b", // Or "llama2:13b" etc.
39 |   "Endpoint": "http://localhost:11434/"
40 | }
41 | ```
42 | 
43 | For Ollama, the `DeploymentName` specifies which model to invoke. See [Ollama's list of available models](https://ollama.com/library), and install them by running `ollama pull <modelname>`.
44 | 
45 | ### Model quality
46 | 
47 | Quality and speed varies dramaticaly from one model to another. **For best results, use GPT 3.5 Turbo or better** - this will respond quickly and at good quality.
48 | 
49 | Based on experimentation:
50 | 
51 |  * **GPT 3.5 Turbo** (hosted service) produces good quality results and is fast.
52 |  * **Mistral 7B** produces good output for Smart TextArea, but is inconsistent for Smart Paste (filling some forms, but leaving others blank or introducing strange characters). Output speed is good for a local model, but on most workstations is still way slower than a hosted service.
53 |  * **Llama2 7B** output quality is insufficient (with Smart Paste, it puts strange or hallucinated text into form fields, and with Smart TextArea, it writes generic text that doesn't well account for the configured phrases).
54 |  * **Mixtral 47B** produced good output for Smart TextArea, but wouldn't follow the instructions properly for Smart Paste and hence left forms blank. Additionally it's too big to run on most workstation GPUs so can be impractically slow.
55 | 
56 | It's possible that specific models or customized prompts (see docs) may behave better, so please let us know if you find ways to improve compatibility or performance with local models!
57 | 


--------------------------------------------------------------------------------
/docs/getting-started-blazor.md:
--------------------------------------------------------------------------------
 1 | # Getting started with Smart Components in Blazor
 2 | 
 3 | 1. **Create a new Blazor project or use an existing one (.NET 6 or later).**
 4 | 
 5 |    * Command line: Run `dotnet new blazor`
 6 |    * Visual Studio: Select *File*->*New*->*Project...* then choose *Blazor Web App*
 7 | 
 8 |    **Note**: Smart Components work equally in any render mode (e.g., Static SSR, Server, or WebAssembly) but you do need to have an ASP.NET Core server, so you cannot use a Blazor WebAssembly Standalone App hosted on a static file server. This is purely because you need a server to hold your API keys securely.
 9 | 
10 | 1. **Install packages**
11 | 
12 |    * In your **server** project, install the NuGet package `SmartComponents.AspNetCore`.
13 | 
14 |      * Command line: `dotnet add package --prerelease SmartComponents.AspNetCore`
15 |      * Visual Studio: Right-click your project name, choose *Manage NuGet packages...*, and then search for and install `SmartComponents.AspNetCore`.
16 |        * Note: Check the *Include prerelease* option if needed.
17 | 
18 |    * If you also have a **WebAssembly** project, install the NuGet package `SmartComponents.AspNetCore.Components` into it. This is not required if you only have a server project.
19 | 
20 | 1. **Register SmartComponents in your application**
21 | 
22 |    In your server's `Program.cs`, under the comment `// Add services to the container`, add:
23 | 
24 |    ```cs
25 |    builder.Services.AddSmartComponents();
26 |    ```
27 | 
28 | 1. **Configure the OpenAI backend** (if needed)
29 | 
30 |    If you will be using either `SmartPaste` or `SmartTextArea`, you need to provide access to a language model backend. See: [Configure the OpenAI backend](configure-openai-backend.md).
31 |    
32 |    If you will only use `SmartComboBox`, you don't need any language model backend and can skip this step.
33 | 
34 | 1. **Add components to your pages**
35 | 
36 |    You can now add the following inside your Blazor pages/components:
37 | 
38 |    * [SmartPaste](smart-paste.md)
39 |    * [SmartTextArea](smart-textarea.md)
40 |    * [SmartComboBox](smart-combobox.md)
41 | 


--------------------------------------------------------------------------------
/docs/getting-started-mvc-razor-pages.md:
--------------------------------------------------------------------------------
 1 | # Getting started with Smart Components in MVC / Razor Pages
 2 | 
 3 | 1. **Create a new ASP.NET Core Web App project or use an existing one (.NET 6 or later).**
 4 | 
 5 |    * Command line: Run `dotnet new mvc` or `dotnet new razor`
 6 |    * Visual Studio: Select *File*->*New*->*Project...* then choose *ASP.NET Core Web App (Model-View-Controller or Razor pages)*
 7 | 
 8 | 1. **Install packages**
 9 | 
10 |    * Install the NuGet package `SmartComponents.AspNetCore`.
11 | 
12 |      * Command line: `dotnet add package --prerelease SmartComponents.AspNetCore`
13 |      * Visual Studio: Right-click your project name, choose *Manage NuGet packages...*, and then search for and install `SmartComponents.AspNetCore`. Check the *Include prerelease* option if needed.
14 |        * Note: Check the *Include prerelease* option if needed.
15 | 
16 | 1. **Register SmartComponents in your application**
17 | 
18 |    a. In `Program.cs`, under the comment `// Add services to the container`, add:
19 | 
20 |    ```cs
21 |    builder.Services.AddSmartComponents();
22 |    ```
23 | 
24 |    b. In your `_ViewImports.cshtml` file (in the `Pages` or `Views` folder), reference the tag helpers:
25 | 
26 |    ```cshtml
27 |    @addTagHelper *, SmartComponents.AspNetCore
28 |    ```
29 | 
30 | 1. **Configure the OpenAI backend** (if needed)
31 | 
32 |    If you will be using either `smart-paste-button` or `smart-textarea`, you need to provide access to a language model backend. See: [Configure the OpenAI backend](configure-openai-backend.md).
33 |    
34 |    If you will only use `smart-combobox`, you don't need any language model backend and can skip this step.
35 | 
36 | 1. **Add smart components to your pages**
37 | 
38 |    You can now add the following inside your views/pages:
39 | 
40 |    * [smart-paste-button](smart-paste.md)
41 |    * [smart-textarea](smart-textarea.md)
42 |    * [smart-combobox](smart-combobox.md)
43 | 


--------------------------------------------------------------------------------
/docs/images/smart-combobox-expenses.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/docs/images/smart-combobox-expenses.gif


--------------------------------------------------------------------------------
/docs/images/smart-paste-address.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/docs/images/smart-paste-address.gif


--------------------------------------------------------------------------------
/docs/images/smart-textarea-hr.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/docs/images/smart-textarea-hr.gif


--------------------------------------------------------------------------------
/docs/local-embeddings.md:
--------------------------------------------------------------------------------
  1 | # Local Embeddings
  2 | 
  3 | *Embeddings* are used for semantic similarity search. Natural-language strings are converted into numerical vectors called *embeddings*. The more conceptually related are two strings, the closer their vectors.
  4 | 
  5 | While you can use an external AI service to compute embeddings, in many cases you can simply compute them locally on your server (no need for a GPU - the CPU will work fine). `SmartComponents.LocalEmbeddings` is a package to simplify doing this.
  6 | 
  7 | With `SmartComponents.LocalEmbeddings`, you can compute embeddings in under a millisecond, and perform semantic search over hundreds of thousands of candidates in single-digit milliseconds. However, there are limits. To understand the performance characteristics and when you might benefit from moving to an external vector database, see *Performance* below.
  8 | 
  9 | ## Getting started
 10 | 
 11 | Reference the package `SmartComponents.LocalEmbeddings`:
 12 | 
 13 |  * Command line: `dotnet add package --prerelease SmartComponents.LocalEmbeddings`
 14 |  * Visual Studio: Right-click your project name, choose *Manage NuGet packages...*, and then search for and install `SmartComponents.LocalEmbeddings`.
 15 |    * Note: Check the *Include prerelease* option if needed.
 16 | 
 17 | You can now compute embeddings of strings:
 18 | 
 19 | ```cs
 20 | using var embedder = new LocalEmbedder();
 21 | var cat = embedder.Embed("Cats can be blue");
 22 | var dog = embedder.Embed("Dogs can be red");
 23 | var snooker = embedder.Embed("Snooker world champion Stephen Hendry");
 24 | ```
 25 | 
 26 | ... and assess their semantic similarity:
 27 | 
 28 | ```cs
 29 | var kitten = embedder.Embed("Kittens!!!");
 30 | Console.WriteLine(kitten.Similarity(kitten));  // 1.00
 31 | Console.WriteLine(kitten.Similarity(cat));     // 0.65
 32 | Console.WriteLine(kitten.Similarity(dog));     // 0.53
 33 | Console.WriteLine(kitten.Similarity(snooker)); // 0.37
 34 | ```
 35 | 
 36 | As you can see, `"Kittens!!!"` is:
 37 | 
 38 |  * ... perfectly related to itself
 39 |  * ... fairly related to the statement about cats
 40 |  * ... less related to the statement about dogs
 41 |  * ... very unrelated to the statement about snooker
 42 | 
 43 | ## Peforming similarity search
 44 | 
 45 | If you want, you can find the closest matches from a set of candidate embeddings simply using `candidates.OrderByDescending(x => x.Similarity(target)).Take(count)`.
 46 | 
 47 | However, it's a little more efficient to use `LocalEmbedder.FindClosest`, because it only sorts the best N matches, instead of sorting *all* the candidates. `FindClosest` accepts the following parameters:
 48 | 
 49 |  * `target`: An embedding previously returned by `embedder.Embed` or `embedder.EmbedRange`
 50 |  * `candidates`: An enumerable of tuples of the form `(item, embedding)`. The `item` can be the `string` that you embedded, or it can be any other object of generic type `T`.
 51 |  * `maxResults`: The maximum number of results
 52 |  * `minSimilarity`: Optional. If set, candidates with a similarity below this threshold won't be included.
 53 | 
 54 | The return value is an array of `T` values, ordered most-similar-first. If you want the similarity scores too, use `LocalEmbedder.FindClosestWithScore` instead, which returns an array of `SimilarityScore<T>` giving both the `T` and its score.
 55 | 
 56 | For example, given this class:
 57 | 
 58 | ```cs
 59 | class Sport
 60 | {
 61 |     public string Name { get; init; }
 62 |     public EmbeddingF32 Embedding { get; init; }
 63 | }
 64 | ```
 65 | 
 66 | ... and this data:
 67 | 
 68 | ```cs
 69 | var sportNames = new[] { "Soccer", "Tennis", "Swimming", "Horse riding", "Golf", "Gymnastics" };
 70 | 
 71 | var sports = sportNames.Select(name => new Sport
 72 | {
 73 |     Name = name,
 74 |     Embedding = embedder.Embed(name)
 75 | }).ToArray();
 76 | ```
 77 | 
 78 | You can find the closest 3 `Sport` instances for the string `"ball game"`:
 79 | 
 80 | ```cs
 81 | var candidates = sports.Select(a => (a, a.Embedding));
 82 | var target = embedder.Embed("ball game");
 83 | Sport[] closest = LocalEmbedder.FindClosest(target, candidates, maxResults: 3);
 84 | 
 85 | // Displays: Soccer, Golf, Tennis
 86 | Console.WriteLine(string.Join(", ", closest.Select(x => x.Name)));
 87 | ```
 88 | 
 89 | While at first it might feel cumbersome to pass an enumerable of tuples for `candidates`, this allows you to get back any data type (e.g., the strings that were embedded, or entity objects holding those embeddings, or just their `int` ID values), and allows you to prefilter by applying a `.Where(...)` clause, all without any extra memory allocations.
 90 | 
 91 | Alternatively, as shorthand, you can use `EmbedRange` to produce the tuples over many inputs at once:
 92 | 
 93 | ```cs
 94 | var candidates = embedder.EmbedRange(sports, x => x.Name);
 95 | Sport[] closest = LocalEmbedder.FindClosest(
 96 |   embedder.Embed("ball game"),
 97 |   candidates,
 98 |   maxResults: 3);
 99 | ```
100 | 
101 | ## Reusing `LocalEmbedder` instances
102 | 
103 | `LocalEmbedder` instances are:
104 | 
105 |  * **Thread-safe**. You can share a singleton instance across many threads.
106 |  * **Disposable**. It holds unmanaged resources since it uses the [ONNX runtime](https://onnxruntime.ai/docs/get-started/with-csharp.html) internally to run the embeddings ML model. Remember to dispose it.
107 |  * **Expensive to create**. Each instance has to load the ML model and set up a session with ONNX.
108 |    * Where possible, retain an instance as a singleton and reuse it. For example, register it as a DI service using `builder.Services.AddSingleton<LocalEmbedder>()`. In that case, you won't dispose it because the DI container will take care of that.
109 | 
110 | ## Shrinking embeddings (quantization)
111 | 
112 | By default, `SmartComponents.LocalEmbeddings` uses an embeddings model that returns 384-dimensional embedding vectors. Each component is represented by a single-precision `float` value (4 bytes), so the memory required for a raw, unquantized embedding is 384*4 = 1536 bytes.
113 | 
114 | In many scenarios this is too much memory. For a million embeddings, it would be 1.5 GiB, which is a lot to hold in memory, and a lot to add to your database.
115 | 
116 | A common technique for reducing the space needed to store vector data is *quantization*. There are many forms of quantization. `LocalEmbeddings` has three built-in storage formats for embeddings, offering different quantizations:
117 | 
118 | | Type | Size (bytes) | Similarity | Info |
119 | | --- | --- | --- | --- |
120 | | `EmbeddingF32` | 1536 | Cosine | Raw, unquantized data. Each component is stored as a `float`. Maximum accuracy. |
121 | | `EmbeddingI8` | 388 | Cosine | Each component is stored as a `sbyte` (signed byte), plus there's 4 bytes to hold a scale factor. This cuts storage significantly, while retaining good accuracy. It's similar to SQ8 quantization in Faiss. |
122 | | `EmbeddingI1` | 48 | Hamming | Each component is stored as a single bit, equivalent to LSH quantization in Faiss. This is a massive reduction in storage, at the cost of moderate reduction in accuracy. |
123 | 
124 | When evaluating similarity, the scores are computed directly from the quantized representations, *without* expanding back to a 1536-byte representation. As such, similarity search works faster on the smaller quantizations, because the CPU is processing far fewer bytes.
125 | 
126 | You can only compute similarity within a type. That is, an `EmbeddingI1` can be compared to another `EmbeddingI1`, but not to an `EmbeddingF32`.
127 | 
128 | To get an embedding in a chosen format, pass it as a generic parameter to `Embed` or `EmbedRange`. Examples:
129 | 
130 | ```cs
131 | // To produce a single embedding:
132 | var embedding = embedder.Embed<EmbeddingI1>(someString);
133 | 
134 | // Or to produce a set of (item, embedding) pairs:
135 | var candidates = embedder.EmbedRange<Sport, EmbeddingI1>(sports, x => x.Name);
136 | ```
137 | 
138 | ## Persisting embeddings
139 | 
140 | When you want to save embeddings to a file or database, you can use the `Buffer` property to access the raw memory as a `ReadOnlyMemory<byte>`. This property is available on any embedding type. Example:
141 | 
142 | ```cs
143 | // Normally you'd store embeddings in a database, not a file on disk,
144 | // but for simplicity let's use a file
145 | var originalEmbedding = embedder.Embed<EmbeddingF32>("The chickens are here to see you");
146 | using (var file = File.OpenWrite("somefile"))
147 | {
148 |     await file.WriteAsync(originalEmbedding.Buffer);
149 | }
150 | 
151 | // Now load it back from disk. Be sure to use the same embedding type.
152 | var loadedBuffer = File.ReadAllBytes("somefile");
153 | var loadedEmbedding = new EmbeddingF32(loadedBuffer);
154 | 
155 | // Displays "1" (the embeddings are identical)
156 | Console.WriteLine(originalEmbedding.Similarity(loadedEmbedding));
157 | ```
158 | 
159 | If you want to access the numerical values of the vector components (e.g., to store them in an external vector database), you can use the following properties:
160 | 
161 | | Embedding type | Values properties | Values type |
162 | | --- | --- | --- |
163 | | `EmbeddingF32` | `Values` | `ReadOnlyMemory<float>` |
164 | | `EmbeddingI8` | `Values` and `Magnitude` | `ReadOnlyMemory<sbyte>` and `float` |
165 | | `EmbeddingI1` | Not available... | ... because the packed bits are simply what you find in `Buffer` |
166 | 
167 | ## Storing and querying using Entity Framework
168 | 
169 | With Entity Framework, you can add a `byte[]` property onto an entity class to hold the raw data for an embedding. For example:
170 | 
171 | ```cs
172 | public class Document
173 | {
174 |     public int DocumentId { get; set; }
175 |     public int OwnerId { get; set; }
176 |     public required string Title { get; set; }
177 |     public required string Body { get; set; }
178 | 
179 |     // It's helpful to use the property name to keep track of which
180 |     // format of embedding is being used
181 |     public required byte[] EmbeddingI8Buffer { get; set; }
182 | }
183 | ```
184 | 
185 | You can populate the `byte[]` property using `ToArray()`:
186 | 
187 | ```cs
188 | var doc = new Document
189 | {
190 |    // ... set other properties here ...
191 |    EmbeddingI8Buffer = embedder.Embed<EmbeddingI8>(title).Buffer.ToArray()
192 | };
193 | ```
194 | 
195 | You might want to recompute this embedding each time the user edits whatever text is used to compute it.
196 | 
197 | Next, if you need to search over a small number of entities (e.g., just the records created by the current user), it may be sufficient to load the data on demand and then run a similarity search:
198 | 
199 | ```cs
200 | using var dbContext = new MyDbContext();
201 | 
202 | // Load whatever subset of the data you want to consider
203 | // No need to fetch all the columns - only need ID/embedding pairs
204 | var currentUserDocs = await dbContext.Documents
205 |     .Where(x => x.OwnerId == currentUserId)
206 |     .Select(x => new { x.DocumentId, x.EmbeddingI8Buffer })
207 |     .ToListAsync();
208 | 
209 | // Perform the similarity search
210 | int[] matchingDocIds = LocalEmbedder.FindClosest(
211 |     embedder.Embed<EmbeddingI8>(searchText),
212 |     currentUserDocs.Select(x => (x.DocumentId, new EmbeddingI8(x.EmbeddingI8Buffer))),
213 |     maxResults: 5);
214 | 
215 | // Load the complete entities for the matching documents
216 | var matchingDocs = await dbContext.Documents
217 |     .Where(x => matchingDocIds.Contains(x.DocumentId))
218 |     .ToDictionaryAsync(x => x.DocumentId);
219 | var matchingDocsInOrder = matchingDocIds.Select(x => matchingDocs[x]);
220 | ```
221 | 
222 | In many cases you'll want to search over a large number of entities, e.g., tens of thousands of entities shared across all users. You would not want to retrieve them all from the database for every search (especially for each keystroke in a Smart ComboBox). Instead, it would make sense to have the server cache the list of ID/embedding pairs in memory. An `(int Id, EmbeddingI1 Embedding)` pair would be only 52 bytes, so holding a million of them would not be problematic (52 MiB). You could cache them in a [MemoryCache](https://learn.microsoft.com/en-us/aspnet/core/performance/caching/memory?view=aspnetcore-8.0) that will expire at regular intervals, offering a tradeoff between database load and freshness of results.
223 | 
224 | ## Customizing the underlying embeddings model
225 | 
226 | `LocalEmbedder` works by using the [ONNX runtime](https://onnxruntime.ai/docs/get-started/with-csharp.html), which can execute many different embeddings models on CPU or GPU (and often, CPU works faster for such small models).
227 | 
228 | The `SmartComponents.LocalEmbeddings` NuGet package does not actually contain any ML model, but it is configured to download a model when you first build your application. You can configure which model is downloaded.
229 | 
230 | The default model that gets downloaded on build is [bge-micro-v2](https://huggingface.co/TaylorAI/bge-micro-v2), an MIT-licensed BERT embedding model, which has been quantized down to just 22.9 MiB, runs efficiently on CPU, and [scores well on benchmarks](https://huggingface.co/spaces/mteb/leaderboard) - outperforming many gigabyte-sized models.
231 | 
232 | If you want to use a different model, specify the URL to its `.onnx` file and the vocabulary that should be used for tokenization. For example, to use [gte-tiny](https://huggingface.co/TaylorAI/gte-tiny), set the following in your `.csproj`:
233 | 
234 | ```xml
235 | <PropertyGroup>
236 |   <LocalEmbeddingsModelUrl>https://huggingface.co/TaylorAI/gte-tiny/resolve/main/onnx/model_quantized.onnx</LocalEmbeddingsModelUrl>
237 |   <LocalEmbeddingsVocabUrl>https://huggingface.co/TaylorAI/gte-tiny/resolve/main/vocab.txt</LocalEmbeddingsVocabUrl>
238 | </PropertyGroup>
239 | ```
240 | 
241 | **Requirements:** The model must be in ONNX format, accept BERT-tokenized text, accept inputs labelled `input_ids`, `attention_mask`, `token_type_ids`, and return an output tensor suitable for mean pooling. Many [sentence transformer](https://www.sbert.net/) models on Hugging Face follow these patterns. These are often 384-dimensional embeddings.
242 | 
243 | ## Performance
244 | 
245 | As a rough approximation, based on an Intel i9-11950H CPU:
246 | 
247 |  * Using `embedder.Embed` for a 50-character string may take around 0.5ms of CPU time (shorter text is quicker).
248 |    * So, if you're computing embeddings over many thousands of strings (or very long strings), it's worth storing the computed embeddings in your existing database (e.g., each time a user saves changes to the corresponding text) instead of recomputing them all from scratch each time the app restarts.
249 |  * An in-memory, single-threaded similarity search using `LocalEmbedder.FindClosest` with `EmbeddingF32` can search through 1,000 candidates in around 0.06ms, or 100,000 candidates in around 6ms (it's linear in the number of candidates, independent of the text length). This goes down to ~2.8ms if you use `EmbeddingI1`.
250 |    * So, if you need to search through tens of millions of candidates, you should consider more advanced similarity search options such as using [Faiss](https://github.com/facebookresearch/faiss) or an external vector database.
251 |    * From benchmarks, `LocalEmbedder.FindClosest` performance is equivalent to [Faiss using its `Flat` index type](https://github.com/facebookresearch/faiss/wiki/Faiss-indexes). You'll only get better speeds from Faiss using its more powerful indexes such as HNSW or IVF, which requires training on your data.
252 | 
253 | #### Recommendations for scaling up
254 | 
255 | The overall goal for `SmartComponents.LocalEmbeddings` is to make semantic search easy to get started with. It may be sufficient for many applications. But if you outgrow it:
256 | 
257 |  * You can use an external service to compute embeddings, e.g., [OpenAI embeddings](https://platform.openai.com/docs/guides/embeddings) or [Azure OpenAI embeddings](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/embeddings)
258 |  * You can perform similarity search using [Faiss](https://github.com/facebookresearch/faiss) on your server (e.g., in .NET via [FaissSharp](https://gitlab.com/josetruyol/faisssharp), [faissmask](https://github.com/andyalm/faissmask), or [FaissNet](https://github.com/fwaris/FaissNet)). This allows you to set up much more powerful indexes that can be trained on your own data. It's a lot more to learn.
259 |  * Or instead of Faiss, you can use an external vector database such as [pgvector](https://github.com/pgvector/pgvector) or cloud-based vector database services.
260 | 
261 | ## Usage with Semantic Kernel
262 | 
263 | If you want to use this ONNX-based local embeddings generator with [Semantic Kernel](https://learn.microsoft.com/en-us/semantic-kernel/overview/), the only package you need to reference is `SmartComponents.LocalEmbeddings.SemanticKernel`.
264 | 
265 | Once you've referenced that package, you can use `AddLocalTextEmbeddingGeneration` to add a local embeddings generator to your `Kernel`:
266 | 
267 | ```cs
268 | var builder = Kernel.CreateBuilder();
269 | builder.AddLocalTextEmbeddingGeneration();
270 | ```
271 | 
272 | ... and then you can generate embeddings in the usual way for Semantic Kernel:
273 | 
274 | ```cs
275 | var kernel = builder.Build();
276 | var embeddingGenerator = kernel.Services.GetRequiredService<ITextEmbeddingGenerationService>();
277 | 
278 | var embedding = await embeddingGenerator.GenerateEmbeddingAsync("Some text here");
279 | ```
280 | 


--------------------------------------------------------------------------------
/docs/smart-combobox.md:
--------------------------------------------------------------------------------
  1 | # Smart ComboBox
  2 | 
  3 | A *combo box* is a UI input element that allows users to type a value *and* to select a predefined value from an autocompleting dropdown.
  4 | 
  5 | Traditional combo boxes suggest values only based on exact substring matches. Smart ComboBox upgrades this by suggesting semantic matches (i.e., options with the most closely related meanings). This is much more helpful for users who don't know/remember the exact predefined string they are looking for.
  6 | 
  7 | ![Screen capture of Smart ComboBox feature](images/smart-combobox-expenses.gif)
  8 | 
  9 | ### Example use cases
 10 | 
 11 |  * **Accounting category**
 12 | 
 13 |    In an expense tracking app, a user may wish to submit a claim for a plane ticket. In the "Category" field, the user starts typing "**plane tic**", then notices that the Smart ComboBox is offering the suggestion "**Transport: Airfare**", since that's the correct accounting category name in this system.
 14 | 
 15 |    Without semantic matching, it would have been difficult for the user to look through potentially hundreds of accounting category names to find the correct one for a plane ticket.
 16 | 
 17 |  * **Tags and labels**
 18 | 
 19 |    A bug tracking system might allow users to attach labels/tags to issues, selecting either an existing label or creating a new label. In the "Label" field, a user types "**slow**", then notices that the Smart ComboBox is offering the suggestions "**Performance**" and "**Usability**", since those labels already exist.
 20 |    
 21 |    This fixes a common problem of people creating multiple labels for the same concept because they don't realize a suitable label already exists.
 22 | 
 23 | ## Adding Smart ComboBox in Blazor
 24 | 
 25 | First, make sure you've followed the [Smart Component installation steps for Blazor](getting-started-blazor.md). For Smart ComboBox, you do *not* need to configure the OpenAI backend, since it runs entirely locally.
 26 | 
 27 | Then, in a `.razor` file (and usually inside a `<form>` or `<EditForm>`), add the `<SmartComboBox>` component. Example:
 28 | 
 29 | ```razor
 30 | <SmartComboBox Url="api/accounting-categories" @bind-Value="@text" />
 31 | 
 32 | @code {
 33 |     string? text; // Optionally, set a default value here
 34 | }
 35 | ```
 36 | 
 37 | The `Url` and `@bind-Value` attributes are both required. You **must** also set up an API endpoint matching this `Url` - see below for steps.
 38 | 
 39 | `SmartComboBox` integrates with Blazor's binding, forms, and validation features in exactly the same way as an `InputText`.
 40 | 
 41 | ## Adding Smart ComboBox in MVC/Razor Pages
 42 | 
 43 | First, make sure you've followed the [Smart Component installation steps for MVC/Razor Pages](getting-started-mvc-razor-pages.md). For Smart ComboBox, you do *not* need to configure the OpenAI backend, since it runs entirely locally.
 44 | 
 45 | Then, in a `.cshtml` file (and usually inside a `<form>`), add the `<smart-combobox>` tag. Example:
 46 | 
 47 | ```cshtml
 48 | <smart-combobox url="~/api/accounting-categories" />
 49 | ```
 50 | 
 51 | The `url` attribute is required. You **must** also set up an API endpoint matching this `url` - see below for steps.
 52 | 
 53 | ## Setting up the API endpoint
 54 | 
 55 | Whether you're using Blazor or MVC/Razor Pages, you also need to set up an API endpoint that Smart ComboBox will call to get suggestions.
 56 | 
 57 | To do this, go to your server's `Program.cs`, and add the following alongside other calls to `app.Map*` APIs:
 58 | 
 59 | ```cs
 60 | var candidates = new[] { "Transport", "Rent", "Payroll", "Party" };
 61 | 
 62 | app.MapSmartComboBox("api/accounting-categories",
 63 |     request => candidates);
 64 | ```
 65 | 
 66 | If you run this now, you'll see the Smart ComboBox is not yet very smart, since it will always use those 4 fixed suggestions, regardless of what the user types.
 67 | 
 68 | ### Adding semantic matching
 69 | 
 70 | Semantic matching is achieved using *embeddings*, a way of converting natural-language strings into numerical vectors. The more conceptually related are two strings, the closer their vectors. You can use external AI services to compute embeddings, but you can also compute them quite cheaply and easily on your server (no need for a GPU - the CPU will work fine).
 71 | 
 72 | #### Reference and register the embedder service
 73 | 
 74 | In your **server** project, add a reference to the package `SmartComponents.LocalEmbeddings`:
 75 | 
 76 |  * Command line: `dotnet add package --prerelease SmartComponents.LocalEmbeddings`
 77 |  * Visual Studio: Right-click your project name, choose *Manage NuGet packages...*, and then search for and install `SmartComponents.LocalEmbeddings`.
 78 |    * Note: Check the *Include prerelease* option if needed.
 79 | 
 80 | Next, in `Program.cs` under the comment `// Add services to the container`, register it:
 81 | 
 82 | ```cs
 83 | builder.Services.AddSingleton<LocalEmbedder>();
 84 | ```
 85 | 
 86 | #### Perform semantic matching
 87 | 
 88 | Replace your existing call to `app.MapSmartComboBox` with the following:
 89 | 
 90 | ```cs
 91 | // Compute the embeddings once up front
 92 | var embedder = app.Services.GetRequiredService<LocalEmbedder>();
 93 | var categories = embedder.EmbedRange(new[] { "Groceries", "Utilities", "Rent", "Mortgage", "Car Payment", "Car Insurance", "Health Insurance", "Life Insurance", "Home Insurance", "Gas", "Public Transportation", "Dining Out", "Entertainment", "Travel", "Clothing", "Electronics", "Home Improvement", "Gifts", "Charity", "Education", "Childcare", "Pet Care", "Other" });
 94 | 
 95 | app.MapSmartComboBox("api/accounting-categories",
 96 |     request => embedder.FindClosest(request.Query, categories));
 97 | ```
 98 | 
 99 | If you run the application, you'll see it now *does* suggest semantic matches. For example, if you type "**cat**" it will suggest "**Pet Care**", whereas if you type "**plane**" it will suggest "**Travel**".
100 | 
101 | In most cases you won't want to have a fixed, hardcoded list of candidate suggestions like the code above does. You will likely want to store embeddings in your existing data store (e.g., as a field called `Embedding` on some entity type in a relational DB). To learn more about computing, storing, and querying embeddings, see [Local Embeddings](local-embeddings.md).
102 | 
103 | Note that the `request` parameter supplied to your `MapSmartComboBox` also contains an `HttpContext` property. You can use that to access other DI services, perform access control, or return user-specific results.
104 | 
105 | ### Implementing the API endpoint manually
106 | 
107 | If you don't want to use `MapSmartComboBox`, you can implement an API endpoint manually in any way you like as long as:
108 | 
109 |  * It responds to POST requests at the URL you specified with `Url` or `url`
110 |  * It accepts the parameters `inputValue`, `maxResults`, and `similarityThreshold` in the POST body (`application/x-www-form-urlencoded`)
111 |  * It responds with a JSON-formatted array of strings
112 | 
113 | ## Styling the combobox
114 | 
115 | Smart ComboBox renders as an HTML `<input>` element. You can style it by adding any CSS class names or other HTML attributes that apply to `<input>`.
116 | 
117 | The suggestions dropdown is rendered as an HTML custom element with tag name `smart-combobox`, which starts hidden but becomes visible when suggestions are to be shown.
118 | 
119 | So at runtime, rendered HTML structure looks as follows (plus many other attributes, including `role` and `aria-*` ones, omitted for clarity):
120 | 
121 | ```html
122 | <input value="Some value">
123 | <smart-combobox class="smartcombobox-suggestions">
124 |     <div class="smartcombobox-suggestion">Suggestion 1/div>
125 |     <div class="smartcombobox-suggestion selected">Suggestion 2 (selected)</div>
126 |     <div class="smartcombobox-suggestion">Suggestion 3</div>
127 | </smart-combobox>
128 | ```
129 | 
130 | You can target these CSS class names from your own `.css` files in order to customize the appearance.
131 | 
132 | ### Using scoped CSS
133 | 
134 | If you are using scoped CSS (i.e., a `.razor.css` or `.cshtml.css` file), remember to use the `::deep` pseudoselector to match these class names, since they are being rendered in a child context. For example:
135 | 
136 | ```css
137 | ::deep .smartcombobox-suggestions { /* ... */ }
138 | ```
139 | 
140 | ## Customizing the suggestions
141 | 
142 | Smart ComboBox also accepts the following parameters:
143 | 
144 |  * **Maximum number of suggestions** (default: 10)
145 |    * Blazor: `<SmartComboBox MaxSuggestions="3" ... />`
146 |    * MVC/Razor Pages: `<smart-combobox max-suggestions="3" ... />`
147 |  * **Similarity threshold** (default: 0.5, range: 0 - 1). Matches with a lower similarity won't be shown. If you set this too high, you won't get any matches unless the text is an exact match.
148 |    * Blazor: `<SmartComboBox SimilarityThreshold="0.6f" ... />`
149 |    * MVC/Razor Pages: `<smart-combobox similarity-threshold="0.6f" ... />`
150 | 
151 | Note that these parameters are simply instructions to the API endpoint. By default, `MapSmartComboBox` does honor these instructions, but if you implement an API endpoint manually, your code is free to honor or ignore them.
152 | 


--------------------------------------------------------------------------------
/docs/smart-paste.md:
--------------------------------------------------------------------------------
  1 | # Smart Paste
  2 | 
  3 | Smart Paste is an intelligent app feature that fills out forms automatically using data from the user's clipboard. You can use this with any existing form in your web app.
  4 | 
  5 | ![Screen capture of Smart Paste feature](images/smart-paste-address.gif)
  6 | 
  7 | ### Example use cases
  8 | 
  9 |  * **Mailing address form**
 10 |  
 11 |    A user could copy a whole mailing address from an email or Word document, and then click "Smart Paste" in your application to populate all the address-related fields in a form (name, line 1, line 2, city, state, etc.).
 12 |  
 13 |    This reduces the workload on your user, because they don't have to type out each field manually, or separately copy-and-paste each field.
 14 | 
 15 |  * **Bug tracking form**
 16 |  
 17 |    A user could copy a short natural-language description of a problem (perhaps sent to them via IM/Teams), and then click "Smart Paste" inside your "Create New Issue" page. This would populate fields like "Title", "Severity", "Repro steps", etc., based on the clipboard text.
 18 | 
 19 |    The language model will automatically rephrase the source text as needed. For example, it would convert phrases like "I just clicked X on screen Y" to repro steps like "1. Go to screen Y, 2. Click X.".
 20 | 
 21 | Smart Paste is designed to work with any form. You don't have to configure or annotate your forms, since the system will infer the meanings of the fields from your HTML. You can optionally provide annotations if it helps to produce better results.
 22 | 
 23 | ## Adding Smart Paste in Blazor
 24 | 
 25 | First, make sure you've followed the [Smart Component installation steps for Blazor](getting-started-blazor.md). This includes [configuring an OpenAI backend](configure-openai-backend.md), which is a prerequisite for Smart Paste.
 26 | 
 27 | Then, in a `.razor` file, inside any `<form>` or `<EditForm>`, add the `<SmartPasteButton>` component. Example:
 28 | 
 29 | ```razor
 30 | @page "/"
 31 | @using SmartComponents
 32 | 
 33 | <form>
 34 |     <p>Name: <InputText @bind-Value="@name" /></p>
 35 |     <p>Address line 1: <InputText @bind-Value="@addr1" /></p>
 36 |     <p>City: <InputText @bind-Value="@city" /></p>
 37 |     <p>Zip/postal code: <InputText @bind-Value="@zip" /></p>
 38 | 
 39 |     <button type="submit">Submit</button>
 40 |     <SmartPasteButton DefaultIcon />
 41 | </form>
 42 | 
 43 | @code {
 44 |     string? name, addr1, city, zip;
 45 | }
 46 | ```
 47 | 
 48 | Now when this app is run, you can copy a mailing address to your clipboard from some other application, and then click the "Smart Paste" button to fill out all the corresponding form fields.
 49 | 
 50 | Note: this example is only intended to show `SmartPasteButton`. This form won't do anything useful if submitted - see [Blazor docs for more about form submissions](https://learn.microsoft.com/en-us/aspnet/core/blazor/forms).
 51 | 
 52 | ## Adding Smart Paste in MVC / Razor Pages
 53 | 
 54 | First, make sure you've followed the [Smart Component installation steps for MVC/Razor Pages](getting-started-mvc-razor-pages.md). This includes [configuring an OpenAI backend](configure-openai-backend.md), which is a prerequisite for Smart Paste.
 55 | 
 56 | Then, in a page/view `.cshtml` file, inside any `<form>`, add a `<smart-paste-button>` tag. Example:
 57 | 
 58 | ```cshtml
 59 | <form>
 60 |     <p>Name: <input name="name" /></p>
 61 |     <p>Address line 1: <input name="addr1" /></p>
 62 |     <p>City: <input name="city" /></p>
 63 |     <p>Zip/postal code: <input name="zip" /></p>
 64 | 
 65 |     <button type="submit">Submit</button>
 66 |     <smart-paste-button default-icon />
 67 | </form>
 68 | ```
 69 | 
 70 | Now when this app is run, you can copy a mailing address to your clipboard from some other application, and then click the "Smart Paste" button to fill out all the corresponding form fields.
 71 | 
 72 | ## Customizing the text label
 73 | 
 74 | To customize the text label, pass arbitrary child content, e.g.:
 75 | 
 76 |  * Blazor:
 77 |    ```razor
 78 |    <SmartPasteButton>Smart paste, baby!</SmartPasteButton>
 79 |    ```
 80 |  * MVC/Razor Pages:
 81 |    ```cshtml
 82 |    <smart-paste-button>Smart paste, baby!</smart-paste-button>
 83 |    ```
 84 | 
 85 | You can use this to specify localized text, or any other button content such as a custom icon.
 86 | 
 87 | ## Styling the button
 88 | 
 89 | The smart paste button renders as a simple HTML `<button>` element. You can style it by adding any CSS class names or other HTML attributes that apply to `<button>`.
 90 | 
 91 | By default, the smart paste button gives itself the CSS class name `smart-paste-button`. During the period when smart paste is in progress (waiting for a server response), the button will apply the `disabled` attribute to itself. So, you can apply styles in CSS as follows:
 92 | 
 93 | ```css
 94 | /* Applies to all smart paste buttons all the time */
 95 | .smart-paste-button { /* your styles here */ }
 96 | 
 97 | /* Applies to smart paste buttons while they are waiting for a server response */
 98 | .smart-paste-button:disabled { /* your styles here */ }
 99 | ```
100 | 
101 | You can override the default CSS class name `smart-paste-button` by setting an explicit `class` attribute on the `<SmartPasteButton>` or `<smart-paste-button>` tag.
102 | 
103 | ### Using scoped CSS
104 | 
105 | If you are using scoped CSS (i.e., a `.razor.css` or `.cshtml.css` file), remember to use the `::deep` pseudoselector to match the button, since it is being rendered in a child context. For example:
106 | 
107 | ```css
108 | ::deep .smart-paste-button { /* ... */ }
109 | ::deep .smart-paste-button:disabled { /* ... */ }
110 | ```
111 | 
112 | ## Rendering an icon
113 | 
114 | You can optionally have the button render a default "smart paste" icon inside itself:
115 | 
116 |  * Blazor: `<SmartPasteButton DefaultIcon />`
117 |  * MVC/Razor Pages: `<smart-paste-button default-icon />`
118 | 
119 | This will render as an inline `<svg class='smart-paste-icon'>` element within the button. You can use the `smart-paste-icon` CSS class name to apply additional styling rules to the icon.
120 | 
121 | If you want to use a custom icon, then instead of setting `DefaultIcon` or `default-icon`, simply supply your icon as child content:
122 | 
123 |  * Blazor:
124 |    ```razor
125 |    <SmartPasteButton>
126 |        <svg>...</svg> <!-- Can be inline or use a 'src' attribute -->
127 |        Click me now!
128 |    </SmartPasteButton>
129 |    ```
130 |  * MVC/Razor Pages:
131 |    ```html
132 |    <smart-paste-button>
133 |        <svg>...</svg> <!-- Can be inline or use a 'src' attribute -->
134 |        Click me now!
135 |    </smart-paste-button>
136 |    ```
137 | 
138 | You can supply any child content that can be rendered inside a `<button>`, as well as any other attributes that make sense on a `<button>`.
139 | 
140 | ## Customizing the AI inference
141 | 
142 | By default, Smart Paste infers the meanings of your form fields automatically, and has a built-in prompt that instructs the language model. You can customize either of these.
143 | 
144 | ### Annotating your form fields
145 | 
146 | By default, Smart Paste finds all the fields in your `<form>` (i.e., `<input>`, `<select>`, and `<textarea>` elements), and generates a description for them based on their associated `<label>`, or their `name` attribute, or nearby text content. This whole form descriptor is then supplied to the backend language model and is used to build a prompt.
147 | 
148 | You can optionally override this on specific form fields. To do so, add a `data-smartpaste-description` attribute that sets a field description to supply to the language model. Examples:
149 | 
150 | ```html
151 | <input data-smartpaste-description="The user's vehicle registration number which must be in the form XYZ-123" />
152 | 
153 | <textarea data-smartpaste-description="The job description which must start with JOB TITLE in all caps, and then contain one paragraph"></textarea>
154 | 
155 | <input type="checkbox" data-smartpaste-description="True if the product description indicates this is for children, otherwise False" />
156 | ```
157 | 
158 | Language models outputs vary, and prompt engineering is a skill in its own right. You may have to experiment to get the best results in your scenario.
159 | 
160 | ### Customizing the prompt
161 | 
162 | You can customize the prompt by registering your own subclass of `SmartPasteInference` as a DI service. For example, define this class:
163 | 
164 | ```cs
165 | class MySmartPasteInference : SmartPasteInference
166 | {
167 |     public override ChatParameters BuildPrompt(SmartPasteRequestData data)
168 |     {
169 |         var prompt = base.BuildPrompt(data);
170 |         prompt.Messages!.Add(new ChatMessage(ChatMessageRole.System,
171 |             "All form field values must be in ALL CAPS"));
172 | 
173 |         prompt.Temperature = 0.5f; // Less deterministic, more creative
174 |         return prompt;
175 |     }
176 | }
177 | ```
178 | 
179 | ... and then in `Program.cs`, *before* the call to `builder.Services.AddSmartComponents`, register it:
180 | 
181 | ```cs
182 | builder.Services.AddSingleton<SmartPasteInference, MySmartPasteInference>();
183 | ```
184 | 
185 | Using the debugger and a breakpoint inside your `BuildPrompt` method, you can inspect the default prompt and parameters, and write code that modifies it in any way.
186 | 
187 | ### Customizing the language model backend
188 | 
189 | If you want to use a backend other than OpenAI or Azure OpenAI, you can implement `IInferenceBackend` and use your custom type in `Program.cs`:
190 | 
191 | ```cs
192 | builder.Services.AddSmartComponents()
193 |     .WithInferenceBackend<MyCustomInferenceBackend>();
194 | 
195 | class MyCustomInferenceBackend : IInferenceBackend { ... }
196 | ```
197 | 


--------------------------------------------------------------------------------
/docs/smart-textarea.md:
--------------------------------------------------------------------------------
  1 | # Smart TextArea
  2 | 
  3 | Smart TextArea is an AI upgrade to the traditional textarea. It provides suggested autocompletions to whole sentences based on its configuration and what the user is currently typing.
  4 | 
  5 | ![Screen capture of Smart TextArea feature](images/smart-textarea-hr.gif)
  6 | 
  7 | ### Example use cases
  8 | 
  9 |  * **Customer service**
 10 | 
 11 |    Your app might allow agents to respond to customer/staff/user messages by typing free text, e.g., in a live chat system, support ticket system, CRM, bug tracker, etc. You can use Smart TextArea to help those agents be more productive, writing better-phrased responses with fewer keystrokes.
 12 | 
 13 |    The key benefit of Smart TextArea (compared with an OS's built-in autocomplete) is that you can configure a house style and a set of predefined phrases, rules, policies, URLs, etc. This sets the tone, level of formality, greetings, etc. that you prefer agents to use, while not forcing them to do so.
 14 |    
 15 |    For example if an HR agent types "**Your vacation allowance is**", the system might suggest a completion like "**28 days as detailed in our policy at https://.../policies/vacation**". Or, if configured for a Wild West-themed restaurant's booking enquiries chat, a staff member typing "**Thanks for**" might be offered the completion "**chattin' to us, Sherrif!**"
 16 | 
 17 |  * **Business process tracking**
 18 | 
 19 |    Many processes require tracking events and status using free text. Smart TextArea can reduce the number of keystrokes needed to refer to industry or business-specific terms and events.
 20 | 
 21 |    For example, a car servicing log system might offer to complete "**Tyre pre**" as "**Tyre pressure checked and is**", or to complete "**Next s**" as "**Next service due at**", if any variation of these is configured as a preferred phrase.
 22 | 
 23 | ## Adding Smart TextArea in Blazor
 24 | 
 25 | First, make sure you've followed the [Smart Component installation steps for Blazor](getting-started-blazor.md). This includes [configuring an OpenAI backend](configure-openai-backend.md), which is a prerequisite for Smart TextArea.
 26 | 
 27 | Then, in a `.razor` file, add the `<SmartTextArea>` component. Example:
 28 | 
 29 | ```razor
 30 | @page "/"
 31 | @using SmartComponents
 32 | 
 33 | <SmartTextArea @bind-Value="@text" UserRole="Generic professional" />
 34 | 
 35 | @code {
 36 |     string? text; // Optionally, set an initial value here
 37 | }
 38 | ```
 39 | 
 40 | The `UserRole` and `@bind-Value` attributes are both required. See below for how to customize the suggestions.
 41 | 
 42 | `SmartTextArea` integrates with Blazor's binding, forms, and validation systems in exactly the same way as `InputTextArea`.
 43 | 
 44 | ## Adding Smart TextArea in MVC / Razor Pages
 45 | 
 46 | First, make sure you've followed the [Smart Component installation steps for MVC/Razor Pages](getting-started-mvc-razor-pages.md). This includes [configuring an OpenAI backend](configure-openai-backend.md), which is a prerequisite for Smart TextArea.
 47 | 
 48 | Then, in a `.cshtml` file, add the `<smart-text-area>` tag. Example:
 49 | 
 50 | ```cshtml
 51 | <smart-textarea user-role="Generic professional" />
 52 | ```
 53 | 
 54 | The `user-role` attribute is required. See below for how to customize the suggestions.
 55 | 
 56 | ## Styling the textarea
 57 | 
 58 | Smart Textarea renders as a simple HTML `<textarea>` element. You can style it by adding any CSS class names or other HTML attributes that apply to `<textarea>`.
 59 | 
 60 | Examples:
 61 | 
 62 |  * Blazor:
 63 |    ```razor
 64 |    <SmartTextArea class="my-textarea" placeholder="Type here..."
 65 |                   rows="10" cols="80" ... />
 66 |    ```
 67 |  * MVC/Razor Pages:
 68 |    ```cshtml
 69 |    <smart-textarea class="my-textarea" placeholder="Type here..."
 70 |                    rows="10" cols="80" ... />
 71 |    ```
 72 | 
 73 | ### Using scoped CSS
 74 | 
 75 | If you are using scoped CSS (i.e., a `.razor.css` or `.cshtml.css` file), remember to use the `::deep` pseudoselector to match the textarea, since it is being rendered in a child context. For example:
 76 | 
 77 | ```css
 78 | ::deep .my-textarea { /* ... */ }
 79 | ```
 80 | 
 81 | ## Customizing the suggestions
 82 | 
 83 | Under the default prompt, the language model will suggest completions based on:
 84 | 
 85 |  * The existing text before and after the cursor
 86 |  * The `UserRole`/`user-role` value
 87 |  * The `UserPhrases`/`user-phrases` value
 88 | 
 89 | You should set a **user role** to be a `string` that describes who is typing and for what reason, optionally giving other contextual information. Examples:
 90 | 
 91 |  * `"An HR agent replying to enquiries from staff"`
 92 |  * `"An open-source project owner replying to a GitHub issue"`
 93 |  * `"An open-source project owner replying to a GitHub issue posted by @SomeUser with the title 'Build fails after upgrading to v3'"`
 94 | 
 95 | You should set **user phrases** to be a `string[]` (array) that helps the language model reply using your preferred tone/voice, common phrases, and give any information you wish about policies, URLs, or anything else that may be relevant to incorporate into the suggested completions.
 96 | 
 97 | #### Reducing invented information
 98 | 
 99 | Don't configure user phrases like `"Tyre pressure is 35psi"`, because then the system will suggest 35psi for all tyre pressure-related completions. Instead, use the special token `NEED_INFO`, e.g., `"Tyre pressure is NEED_INFO"`. The language model will terminate the completion whenever it hits that special token, so the completion will appear as `"Tyre pressure is "`, allowing the user to fill in the value.
100 | 
101 | Language models are innately unpredictable, so you may have to experiment to find the most useful phrases. Even when you use `NEED_INFO`, it may still sometimes invent unwanted information. If needed, you can customize the underlying prompt to tune it more to your scenarios - see below.
102 | 
103 | #### Blazor example
104 | 
105 | ```razor
106 | <SmartTextArea @bind-Value="@text" UserRole="@userRole" UserPhrases="@userPhrases" />
107 | 
108 | @code {
109 |     string? text;
110 | 
111 |     string userRole = "Staff at a wild-west themed restaurant called 'The Wild Brunch', replying to a booking enquiry";
112 | 
113 |     string[] userPhrases = [
114 |         "Yee-haw!",
115 |         "So you wanna mosey on down for a bite?",
116 |         "Why sure, we can cook you up somethin' special",
117 |         "We're open everyday except Tuesdays (that's when we're at the rodeo)",
118 |         "Sorry pardner, even if you're the sherrif, we gotta stick to our policy!",
119 |         "Can I book you in for NEED_INFO",
120 |         "How can I help you, kind stranger?",
121 |         "Our website is at https://wildbrunch.example.com/"
122 |     ];
123 | }
124 | ```
125 | 
126 | #### MVC/Razor Pages example
127 | 
128 | ```cshtml
129 | @{
130 |     ViewData["Title"] = "Home Page";
131 | 
132 |     string userRole = "Maintainer of this open-source project replying to GitHub issues";
133 |     string[] userPhrases = [
134 |         "Thankyou for contacting us.",
135 |         "To investigate, we'll need a repro as a public Git repo.",
136 |         "Could you please post a screenshot of NEED_INFO",
137 |         "This sounds like a usage question. This issue tracker is intended for bugs and feature proposals. Unfortunately we don't have capacity to answer general usage questions and would recommend StackOverflow for a faster response.",
138 |         "We don't accept ZIP files as repros.",
139 |     ];
140 | }
141 | 
142 | <smart-textarea user-role="@userRole" user-phrases="@userPhrases" />
143 | ```
144 | 
145 | ## Controlling the suggestion UX
146 | 
147 | Suggestions appear when the textarea is focused, after the user has paused typing.
148 | 
149 |  * **On non-touch devices (desktop)**, by default the suggestion appears inline inside the textarea, in grey text ahead of the cursor. The user may accept the suggestion by pressing "tab".
150 |  * **On touch devices (mobile)**, by default the suggestion appears in a floating overlay below the cursor. The user may accept the suggestion by tapping the suggestion overlay (or by pressing "tab" if they have such a key, though most mobile users do not).
151 | 
152 | If you want to override the default UI style, you can pass the attribute `data-inline-suggestions`.
153 | 
154 |  * Blazor: `<SmartTextArea data-inline-suggestions="true" ... />`
155 |  * MVC/Razor Pages: `<smart-text-area data-inline-suggestions="true" ... />`
156 | 
157 | | Attribute value | Behavior |
158 | | --- | --- |
159 | | `true` | Suggestions are always shown inline, and can be accepted by pressing "tab". |
160 | | `false` | Suggestions are always shown as a floating overlay that can be tapped or clicked. |
161 | | Not set | Touch devices use overlay; non-touch devices use inline. |
162 | 
163 | ## Customizing the AI inference
164 | 
165 | Smart Textarea contains logic that generates a prompt for the language model, but you can customize it.
166 | 
167 | ### Customizing the prompt
168 | 
169 | You can customize the prompt by registering your own subclass of `SmartTextAreaInference` as a DI service. For example, define this class:
170 | 
171 | ```cs
172 | class MySmartTextAreaInference : SmartTextAreaInference
173 | {
174 |     public override ChatParameters BuildPrompt(
175 |         SmartTextAreaConfig config, string textBefore, string textAfter)
176 |     {
177 |         var prompt = base.BuildPrompt(config, textBefore, textAfter);
178 | 
179 |         prompt.Messages!.Add(new(ChatMessageRole.System,
180 |             "The suggestions must ALWAYS BE IN ALL CAPS."));
181 | 
182 |         prompt.Temperature = 0.5f; // Less deterministic, more creative (default = 0)
183 | 
184 |         return prompt;
185 |     }
186 | }
187 | ```
188 | 
189 | ... and then in `Program.cs`, *before* the call to `builder.Services.AddSmartComponents`, register it:
190 | 
191 | ```cs
192 | builder.Services.AddSingleton<SmartTextAreaInference, MySmartTextAreaInference>();
193 | ```
194 | 
195 | Using the debugger and a breakpoint inside your `BuildPrompt` method, you can inspect the default prompt and parameters, and write code that modifies it in any way.
196 | 
197 | ### Customizing the language model backend
198 | 
199 | If you want to use a backend other than OpenAI or Azure OpenAI, you can implement `IInferenceBackend` and use your custom type in `Program.cs`:
200 | 
201 | ```cs
202 | builder.Services.AddSmartComponents()
203 |     .WithInferenceBackend<MyCustomInferenceBackend>();
204 | 
205 | class MyCustomInferenceBackend : IInferenceBackend { ... }
206 | ```
207 | 


--------------------------------------------------------------------------------
/nuget.config:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="utf-8"?>
2 | <configuration>
3 |   <packageSources>
4 |     <!--To inherit the global NuGet package sources remove the <clear/> line below -->
5 |     <clear />
6 |     <add key="nuget" value="https://api.nuget.org/v3/index.json" />
7 |   </packageSources>
8 | </configuration>
9 | 


--------------------------------------------------------------------------------
/samples/Directory.Build.props:
--------------------------------------------------------------------------------
 1 | <Project>
 2 |     <PropertyGroup>
 3 |         <SuppressNETCoreSdkPreviewMessage>true</SuppressNETCoreSdkPreviewMessage>
 4 |         <RepoRoot>$(MSBuildThisFileDirectory)..\</RepoRoot>
 5 |         <SharedSrcRoot>$(MSBuildThisFileDirectory)shared\</SharedSrcRoot>
 6 |         <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
 7 |         <SmartComponentsPackageVersion>0.1.0-preview10146</SmartComponentsPackageVersion>
 8 |     </PropertyGroup>
 9 | </Project>
10 | 


--------------------------------------------------------------------------------
/samples/Directory.Packages.props:
--------------------------------------------------------------------------------
 1 | <Project>
 2 |   <PropertyGroup>
 3 |     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
 4 |   </PropertyGroup>
 5 |   <ItemGroup>
 6 |   </ItemGroup>
 7 |   <ItemGroup>
 8 |     <PackageVersion Include="SmartComponents.AspNetCore" Version="$(SmartComponentsPackageVersion)" />
 9 |     <PackageVersion Include="SmartComponents.Inference.OpenAI" Version="$(SmartComponentsPackageVersion)" />
10 |     <PackageVersion Include="SmartComponents.LocalEmbeddings" Version="$(SmartComponentsPackageVersion)" />
11 |   </ItemGroup>
12 | </Project>
13 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/.gitignore:
--------------------------------------------------------------------------------
1 | wwwroot/*.out.css
2 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/App.razor:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en" class="overflow-y-scroll">
 3 | 
 4 | <head>
 5 |     <meta charset="utf-8" />
 6 |     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 7 |     <base href="/" />
 8 |     <link rel="stylesheet" href="app.out.css" />
 9 |     <link rel="stylesheet" href="ExampleBlazorApp.styles.css" />
10 |     <HeadOutlet />
11 | </head>
12 | 
13 | <body>
14 |     <Routes />
15 |     <script src="_framework/blazor.web.js"></script>
16 | </body>
17 | 
18 | </html>
19 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Layout/MainLayout.razor:
--------------------------------------------------------------------------------
 1 | @inherits LayoutComponentBase
 2 | 
 3 | <nav class="bg-gray-900 fixed w-full z-20 top-0 start-0 border-b border-gray-600">
 4 |     <NavBar />
 5 | </nav>
 6 | 
 7 | <main class="mt-16 max-w-screen-xl mx-auto p-4 pb-12">
 8 |     @Body
 9 | </main>
10 | 
11 | <div id="blazor-error-ui">
12 |     An unhandled error has occurred.
13 |     <a href="" class="reload">Reload</a>
14 |     <a class="dismiss">🗙</a>
15 | </div>
16 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Layout/MainLayout.razor.css:
--------------------------------------------------------------------------------
 1 | #blazor-error-ui {
 2 |     background: lightyellow;
 3 |     bottom: 0;
 4 |     box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
 5 |     display: none;
 6 |     left: 0;
 7 |     padding: 0.6rem 1.25rem 0.7rem 1.25rem;
 8 |     position: fixed;
 9 |     width: 100%;
10 |     z-index: 1000;
11 | }
12 | 
13 |     #blazor-error-ui .dismiss {
14 |         cursor: pointer;
15 |         position: absolute;
16 |         right: 0.75rem;
17 |         top: 0.5rem;
18 |     }
19 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Layout/NavBar.razor:
--------------------------------------------------------------------------------
 1 | @inject NavigationManager Nav
 2 | 
 3 | <div class="max-w-screen-xl flex flex-wrap items-center justify-between mx-auto p-4">
 4 |     <a href="" class="flex items-center">
 5 |         <span class="self-center text-lg sm:text-xl font-semibold whitespace-nowrap text-white">Smart Components (Blazor)</span>
 6 |     </a>
 7 |     <div class="flex xl:order-2 space-x-3 xl:space-x-0 rtl:space-x-reverse">
 8 |         <button onclick="document.getElementById('navbar-sticky').classList.toggle('hidden')" type="button" class="inline-flex items-center px-2 w-8 h-8 justify-center text-sm rounded-lg xl:hidden focus:outline-none focus:ring-2 text-gray-400 hover:bg-gray-700 focus:ring-gray-600" aria-controls="navbar-sticky" aria-expanded="false">
 9 |             <span class="sr-only">Open main menu</span>
10 |             <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 17 14">
11 |                 <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M1 1h15M1 7h15M1 13h15" />
12 |             </svg>
13 |         </button>
14 |     </div>
15 |     <div class="items-center justify-between hidden w-full xl:flex xl:w-auto xl:ml-auto xl:order-1" id="navbar-sticky">
16 |         <ul class="flex flex-col p-4 xl:p-0 mt-4 font-medium border rounded-lg xl:space-x-8 rtl:space-x-reverse xl:flex-row xl:mt-0 xl:border-0 bg-gray-800 xl:bg-gray-900 border-gray-700">
17 |             <NavLink href="" class="@LinkClass" ActiveClass="@LinkActiveClass" Match="@NavLinkMatch.All">Home</NavLink>
18 |             <NavLink href="smartpaste" class="@LinkClass" ActiveClass="@LinkActiveClass">Smart Paste</NavLink>
19 |             <NavLink href="smarttextarea" class="@LinkClass" ActiveClass="@LinkActiveClass">Smart TextArea</NavLink>
20 |             <NavLink href="smartcombobox" class="@LinkClass" ActiveClass="@LinkActiveClass">Smart ComboBox</NavLink>
21 |             <NavLink href="localembeddings" class="@LinkClass" ActiveClass="@LinkActiveClass">Local Embeddings</NavLink>
22 |         </ul>
23 |     </div>
24 | </div>
25 | 
26 | @code {
27 |     const string LinkClass = "block py-2 px-3 rounded md:p-0 md:hover:bg-transparent md:border-0 text-white md:hover:text-blue-500 hover:bg-gray-700 hover:text-white";
28 |     const string LinkActiveClass = "text-white bg-blue-700 md:bg-transparent md:text-blue-500";
29 | }
30 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/Error.razor:
--------------------------------------------------------------------------------
 1 | @page "/Error"
 2 | @using System.Diagnostics
 3 | 
 4 | <PageTitle>Error</PageTitle>
 5 | 
 6 | <h1 class="text-danger">Error.</h1>
 7 | <h2 class="text-danger">An error occurred while processing your request.</h2>
 8 | 
 9 | @if (ShowRequestId)
10 | {
11 |     <p>
12 |         <strong>Request ID:</strong> <code>@RequestId</code>
13 |     </p>
14 | }
15 | 
16 | <h3>Development Mode</h3>
17 | <p>
18 |     Swapping to <strong>Development</strong> environment will display more detailed information about the error that occurred.
19 | </p>
20 | <p>
21 |     <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
22 |     It can result in displaying sensitive information from exceptions to end users.
23 |     For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
24 |     and restarting the app.
25 | </p>
26 | 
27 | @code{
28 |     [CascadingParameter]
29 |     private HttpContext? HttpContext { get; set; }
30 | 
31 |     private string? RequestId { get; set; }
32 |     private bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
33 | 
34 |     protected override void OnInitialized() =>
35 |         RequestId = Activity.Current?.Id ?? HttpContext?.TraceIdentifier;
36 | }
37 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/Home/Home.razor:
--------------------------------------------------------------------------------
 1 | @page "/"
 2 | 
 3 | <PageTitle>Home</PageTitle>
 4 | 
 5 | <WarnIfMissingConfiguration />
 6 | 
 7 | <p class="mt-4">
 8 |     Smart Components lets you
 9 |     <strong class="font-semibold">add genuinely useful AI-powered features to your .NET apps quickly and easily</strong>.
10 | </p>
11 | 
12 | <p class="mt-4">
13 |     It's an experiment from the .NET team, and is initially available for ASP.NET Core 6.0 and later.
14 | </p>
15 | 
16 | <h3 class="font-semibold mt-8">Learn more</h3>
17 | 
18 | <ul class="list-disc m-5">
19 |     <li class="mb-2">
20 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents">Readme and documentation</a></p>
21 |     </li>
22 |     <li class="mb-2">
23 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents/blob/main/docs/getting-started-blazor.md">Getting started with Smart Components and Blazor</a></p>
24 |     </li>
25 |     <li class="mb-2">
26 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents/blob/main/docs/getting-started-mvc-razor-pages.md">Getting started with Smart Components and MVC/Razor Pages</a></p>
27 |     </li>
28 |     <li class="mb-2">
29 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents/issues">Submit feedback / questions</a></p>
30 |     </li>
31 | </ul>
32 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/Home/WarnIfMissingConfiguration.razor:
--------------------------------------------------------------------------------
 1 | @inject IConfiguration Config
 2 | 
 3 | @if (RepoSharedConfigUtil.GetConfigError(Config) is { } invalidConfigException)
 4 | {
 5 |     <div class="border-2 border-rose-500 p-5 bg-rose-200 rounded-lg shadow-lg mb-8">
 6 |         <h4 class="font-semibold">Missing or invalid configuration</h4>
 7 |         <p class="mt-4 text-sm">
 8 |             Reason: <span class="font-semibold">@invalidConfigException.Message</span>
 9 |         </p>
10 |         <p class="mt-4 text-sm">
11 |             To run the samples that use OpenAI inference, you need to configure an API key, either in
12 |             <code>appsettings.Development.json</code> or in <code>RepoSharedConfig.json</code> at the
13 |             root of this repo. For instructions, see
14 |             <a href="https://github.com/dotnet-smartcomponents/smartcomponents/blob/main/docs/configure-openai-backend.md">Configure the OpenAI backend</a>.
15 |         </p>
16 |         <p class="mt-4 text-sm">
17 |             Without an API key, you can still run <a href="smartcombobox">Smart ComboBox</a>
18 |             and <a href="localembeddings">Local Embeddings</a> samples since they do not require any external language model backend.
19 |         </p>
20 |     </div>
21 | }
22 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/LocalEmbeddingsExamples/BasicLocalEmbeddings.razor:
--------------------------------------------------------------------------------
 1 | @using SmartComponents.LocalEmbeddings
 2 | @inherits StatefulPageBase<BasicLocalEmbeddings.State>
 3 | @inject LocalEmbedder Embedder
 4 | 
 5 | <form class="default-form rounded-md bg-gray-200 p-6 shadow-xl mb-10" method="post" @formname="embedding" @onsubmit="@ComputeEmbedding">
 6 |     <AntiforgeryToken />
 7 |     @HiddenPageState
 8 |     <div class="flex gap-6 items-center">
 9 |         <input autofocus class="flex-grow" name="@(nameof(TextToEmbed))" placeholder="Enter any string here" required />
10 |         <button class="default-button" type="submit">Embed</button>
11 |     </div>
12 | </form>
13 | 
14 | @if (PageState.TextsWithEmbeddings.Any())
15 | {
16 |     <h2 class="font-semibold mb-4">Similarity to "@PageState.LatestText":</h2>
17 | 
18 |     <ul class="pl-3">
19 |         @foreach (var text in GetRankedTexts())
20 |         {
21 |             <li>
22 |                 <span class="font-semibold text-blue-600 inline-block w-12 mr-2 text-right">@MathF.Round(text.Similarity * 100)%</span>
23 |                 @text.Text
24 |             </li>
25 |         }
26 |     </ul>
27 | }
28 | 
29 | @code {
30 |     [SupplyParameterFromForm]
31 |     public string? TextToEmbed { get; set; }
32 | 
33 |     private void ComputeEmbedding()
34 |     {
35 |         if (string.IsNullOrEmpty(TextToEmbed))
36 |         {
37 |             return;
38 |         }
39 | 
40 |         var result = Embedder.Embed<EmbeddingI8>(TextToEmbed);
41 |         PageState.LatestText = TextToEmbed;
42 |         PageState.TextsWithEmbeddings[TextToEmbed] = result;
43 |     }
44 | 
45 |     private IEnumerable<(string Text, float Similarity)> GetRankedTexts()
46 |     {
47 |         var latestEmbedding = PageState.TextsWithEmbeddings[PageState.LatestText!];
48 |         return PageState.TextsWithEmbeddings
49 |             .Select(item => (Text: item.Key, Similarity: LocalEmbedder.Similarity(latestEmbedding, item.Value)))
50 |             .OrderByDescending(x => x.Similarity)
51 |             .ToArray();
52 |     }
53 | 
54 |     public class State
55 |     {
56 |         public string? LatestText { get; set; }
57 |         public Dictionary<string, EmbeddingI8> TextsWithEmbeddings { get; set; } = new();
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/LocalEmbeddingsExamples/Examples.razor:
--------------------------------------------------------------------------------
 1 | @page "/localembeddings/{*Path}"
 2 | @using ExampleBlazorApp.Components.TabSet
 3 | 
 4 | <PageTitle>Local Embedding</PageTitle>
 5 | 
 6 | <TabSet>
 7 |     <Tab TComponent="BasicLocalEmbeddings" Url="localembeddings" Text="Basics" />
 8 | </TabSet>
 9 | 
10 | @code {
11 |     [Parameter] public string? Path { get; set; }
12 | }
13 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartComboBoxExamples/Examples.razor:
--------------------------------------------------------------------------------
 1 | @page "/smartcombobox"
 2 | 
 3 | <PageTitle>Smart ComboBox</PageTitle>
 4 | 
 5 | <form class="default-form rounded-md bg-gray-200 p-6 shadow-xl mb-12 grid gap-12 md:grid-cols-2">
 6 |     <div class="floating-placeholder" data-permanent="combo-box-example">
 7 |         <SmartComboBox Url="api/suggestions/expense-category"
 8 |             id="expense-category" @bind-Value="@expenseCategory" placeholder=" " />
 9 |         <label for="expense-category">Expense category</label>
10 |     </div>
11 |     <div class="floating-placeholder" data-permanent="combo-box-example">
12 |         <SmartComboBox Url="api/suggestions/issue-label"
13 |                        id="issue-label" @bind-Value="@issueLabel" placeholder=" " />
14 |         <label for="issue-label">Issue label</label>
15 |     </div>
16 | </form>
17 | 
18 | @code {
19 |     string? expenseCategory;
20 |     string? issueLabel;
21 | }
22 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartPasteExamples/BasicForm.razor:
--------------------------------------------------------------------------------
 1 | <form class="default-form rounded-md bg-gray-200 p-6 shadow-xl mb-12">
 2 |     <div class="grid gap-6 mb-5 md:grid-cols-2">
 3 |         <div>
 4 |             <label for="name">Name</label>
 5 |             <input type="text" id="name" placeholder="Your name" required />
 6 |         </div>
 7 |         <div>
 8 |             <label for="age">Age</label>
 9 |             <input type="number" id="age" placeholder="Your age" required />
10 |         </div>
11 |     </div>
12 | 
13 |     <div class="flex gap-4">
14 |         <button class="default-button" type="submit">Save</button>
15 |         <button class="default-button secondary mr-auto" type="reset">Reset</button>
16 |         <SmartPasteButton DefaultIcon class="default-button secondary" />
17 |     </div>
18 | </form>
19 | 
20 | <h3 class="mb-4">Sample content</h3>
21 | 
22 | <div class="grid gap-6 md:grid-cols-3">
23 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Verónica Ortíz</div>
24 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>From: Elio E Marchello
25 | Date: January 9th, 1998</div>
26 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Ravi Pawar, born 19 September 2003</div>
27 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>6 Maple Street</div>
28 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Polish inventor Jan Szczepanik patented a color television system in 1897</div>
29 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Name: D C Magoo
30 | Age: 106</div>
31 | </div>
32 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartPasteExamples/BugReport.razor:
--------------------------------------------------------------------------------
 1 | @using System.ComponentModel.DataAnnotations
 2 | 
 3 | <form class="default-form rounded-md bg-gray-200 p-6 shadow-xl mb-12">
 4 |     <div class="grid gap-6 md:grid-cols-4">
 5 |         <div>
 6 |             <label for="project">Project</label>
 7 |             <select id="project" required>
 8 |                 <option value=""></option>
 9 |                 @for (var i = 0; i < projects.Length; i++)
10 |                 {
11 |                     <option value="project_@i">@projects[i]</option>
12 |                 }
13 |             </select>
14 |         </div>
15 |         <div>
16 |             <label for="item_type">Item type</label>
17 |             <select id="item_type" required>
18 |                 <option value="">(select)</option>
19 |                 <option value="bug">🐞 Bug</option>
20 |                 <option value="feature_request">💡 Feature request</option>
21 |             </select>
22 |         </div>
23 |         <div>
24 |             <label>Severity/importance</label>
25 |             <div class="flex">
26 |                 <label class="inline-radio">
27 |                     <input type="radio" name="severity" value="low" /> Low
28 |                 </label>
29 |                 <label class="inline-radio">
30 |                     <input type="radio" name="severity" value="medium" /> Medium
31 |                 </label>
32 |                 <label class="inline-radio">
33 |                     <input type="radio" name="severity" value="high" /> High
34 |                 </label>
35 |                 <label class="inline-radio">
36 |                     <input type="radio" name="severity" value="critical" /> Critical
37 |                 </label>
38 |             </div>
39 |         </div>
40 |     </div>
41 | 
42 |     <label for="title" class="mt-4">Title</label>
43 |     <input type="text" id="title" placeholder="Name for the bug" required />
44 | 
45 |     <label for="summary" class="mt-4">Summary</label>
46 |     <textarea id="summary" placeholder="A short summary of the issue and why it is important" required></textarea>
47 | 
48 |     <label for="repro_steps" class="mt-4">Steps to reproduce (if bug)</label>
49 |     <textarea id="repro_steps" placeholder="Describe how to cause the bug" required></textarea>
50 | 
51 |     <div class="flex gap-4 mt-8">
52 |         <button class="default-button" type="submit">Save</button>
53 |         <button class="default-button secondary mr-auto" type="reset">Reset</button>
54 |         <SmartPasteButton DefaultIcon class="default-button secondary" />
55 |     </div>
56 | </form>
57 | 
58 | <h3 class="mb-4">Sample content</h3>
59 | 
60 | <div class="grid gap-6 md:grid-cols-2">
61 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line h-48 overflow-y-auto" spellcheck="false" contenteditable>I found a small problem with the UI in the new v2 mobile app.
62 | 
63 |         If you keep switching between the home and calendar tabs really fast, the UI can get out of sync. For example the "calendar" tab might be highlighted while the "home" content is still displayed.
64 |     </div>
65 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line h-48 overflow-y-auto" spellcheck="false" contenteditable>Hey, can you add a new "current CMS provider" feature to the customer data on the sales intranet? This has to be your top priority because we need it done by end of week.
66 |     </div>
67 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line h-48 overflow-y-auto" spellcheck="false" contenteditable>Customers using PowerEye Security v3.22 are advised to upgrade to v3.3 urgently due to a critical vulnerability in input parsing.
68 |     </div>
69 | </div>
70 | 
71 | @code {
72 |     string[] projects =
73 |     [
74 |         "Sales intranet",
75 |         "Customer portal",
76 |         "Mobile app",
77 |         "Mobile app (v2 beta)",
78 |         "PowerEye Security",
79 |     ];
80 | 
81 |     Component[] components =
82 |     [
83 |         new("backup", "Backup/restore"),
84 |         new("ui", "User interface"),
85 |         new("webhooks", "Web hooks"),
86 |         new("llm", "Language models"),
87 |         new("offline", "Offline support"),
88 |         new("windows", "Windows"),
89 |         new("mac", "Mac"),
90 |         new("linux", "Linux"),
91 |         new("build", "Build system"),
92 |         new("perf", "Performance"),
93 |         new("security", "Security"),
94 |     ];
95 | 
96 |     record Component(string Id, string Name);
97 | }
98 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartPasteExamples/Examples.razor:
--------------------------------------------------------------------------------
 1 | @page "/smartpaste/{*Path}"
 2 | @using ExampleBlazorApp.Components.TabSet
 3 | 
 4 | <PageTitle>Smart Paste</PageTitle>
 5 | 
 6 | <TabSet>
 7 |     <Tab TComponent="BasicForm" Url="smartpaste" Text="Basic form" />
 8 |     <Tab TComponent="MailAddress" Url="smartpaste/mail" Text="Mail address" />
 9 |     <Tab TComponent="BugReport" Url="smartpaste/bug" Text="Bug report" />
10 | </TabSet>
11 | 
12 | @code {
13 |     [Parameter] public string? Path { get; set; }
14 | }
15 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartPasteExamples/MailAddress.razor:
--------------------------------------------------------------------------------
  1 | @using System.ComponentModel.DataAnnotations
  2 | @rendermode InteractiveServer
  3 | 
  4 | <EditForm Model="@Address" class="default-form rounded-md bg-gray-200 py-8 px-10 border shadow-xl mb-12">
  5 |     <DataAnnotationsValidator />
  6 | 
  7 |     <div class="grid gap-12 md:grid-cols-2 mb-12">
  8 |         <div>
  9 |             <label>Recipient</label>
 10 | 
 11 |             <div class="grid gap-6">
 12 |                 <div class="floating-placeholder">
 13 |                     <InputText @bind-Value="Address.FirstName" placeholder=" " />
 14 |                     <label>First name</label>
 15 |                 </div>
 16 |                 <div class="floating-placeholder">
 17 |                     <InputText @bind-Value="Address.LastName" placeholder=" " />
 18 |                     <label>Last name</label>
 19 |                 </div>
 20 |                 <div class="floating-placeholder">
 21 |                     <input name="phone_number" placeholder=" " />
 22 |                     <label>Phone number</label>
 23 |                 </div>
 24 |             </div>
 25 |         </div>
 26 |         <div>
 27 |             <label>Address</label>
 28 | 
 29 |             <div class="grid gap-6 md:grid-cols-2">
 30 |                 <div class="floating-placeholder col-span-full">
 31 |                     <InputText @bind-Value="Address.Line1" placeholder=" " />
 32 |                     <label>Line 1</label>
 33 |                 </div>
 34 |                 <div class="floating-placeholder col-span-full">
 35 |                     <InputText @bind-Value="Address.Line2" placeholder=" " />
 36 |                     <label>Line 2</label>
 37 |                 </div>
 38 |                 <div class="floating-placeholder">
 39 |                     <InputText @bind-Value="Address.City" placeholder=" " />
 40 |                     <label>City</label>
 41 |                 </div>
 42 |                 <div class="floating-placeholder">
 43 |                     <InputText @bind-Value="Address.State" placeholder=" " />
 44 |                     <label>State</label>
 45 |                 </div>
 46 |                 <div class="floating-placeholder">
 47 |                     <InputText @bind-Value="Address.Zip" placeholder=" " />
 48 |                     <label>Zip</label>
 49 |                 </div>
 50 |                 <div class="floating-placeholder">
 51 |                     <InputText @bind-Value="Address.Country" placeholder=" " />
 52 |                     <label>Country</label>
 53 |                 </div>
 54 |             </div>
 55 |         </div>
 56 |     </div>
 57 | 
 58 |     <div class="flex gap-4 justify-center">
 59 |         <button class="default-button" type="submit">Submit</button>
 60 |         <SmartPasteButton DefaultIcon class="default-button secondary" />
 61 |     </div>
 62 | </EditForm>
 63 | 
 64 | <h3 class="mb-4">Sample content</h3>
 65 | 
 66 | <div class="grid gap-6 md:grid-cols-3">
 67 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Verónica Ortíz
 68 | PROLONGACION 3A NO109
 69 | EJIDO 20 DE NOVIEMBRE
 70 | Tamaulipas
 71 | Matamoros
 72 | 87394
 73 | México
 74 | 
 75 | Phone 768.312-5495
 76 |     </div>
 77 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Write to us at:
 78 |         Kidwelly Town Council
 79 |         Council Offices
 80 |         Hillfield Villas
 81 |         Kidwelly
 82 |         Carmarthenshire
 83 |         SA17 4UL
 84 | 
 85 |         Telephone: 01554 890203
 86 |         E-mail: towncouncil@kidwelly.gov.uk
 87 |     </div>
 88 |     <div class="sample bg-blue-50 p-4 rounded-md whitespace-pre-line" spellcheck="false" contenteditable>Dr. Akio Yamamoto works for Microsoft at Building 92, which is located at 15010 NE 36th St, Redmond, WA 98052.</div>
 89 | </div>
 90 | 
 91 | @code {
 92 |     public AddressData Address { get; set; } = new();
 93 | 
 94 |     public class AddressData
 95 |     {
 96 |         [Required]
 97 |         public string? FirstName { get; set; }
 98 | 
 99 |         [Required]
100 |         public string? LastName { get; set; }
101 | 
102 |         public string? Phone { get; set; }
103 | 
104 |         [Required]
105 |         public string? Line1 { get; set; }
106 | 
107 |         public string? Line2 { get; set; }
108 |         
109 |         [Required]
110 |         public string? City { get; set; }
111 | 
112 |         [Required]
113 |         public string? State { get; set; }
114 | 
115 |         public string? Country { get; set; }
116 |         
117 |         [Required]
118 |         public string? Zip { get; set; }
119 |     }
120 | }
121 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartTextAreaExamples/Basic.razor:
--------------------------------------------------------------------------------
 1 | <PageTitle>Smart TextArea</PageTitle>
 2 | 
 3 | <form class="default-form rounded-md bg-gray-200 p-6 shadow-xl mb-12">
 4 |     <div class="grid mb-5">
 5 |         <h4 class="font-semibold mb-2">Employee enquiry</h4>
 6 | 
 7 |         <label for="comment">Response:</label>
 8 | 
 9 |         <SmartTextArea UserRole="@userRole" UserPhrases="@userPhrases" @bind-Value="@comment"
10 |                        placeholder="Type your response here..." autofocus />
11 |     </div>
12 | </form>
13 | 
14 | @code {
15 |     private string? comment;
16 |     private readonly string userRole = "HR administrator replying to an employee enquiry";
17 |     private readonly string[] userPhrases =
18 |     [
19 |         "Thankyou for your message.",
20 |         "Full-time employees have 28 days paid vacation per year.",
21 |         "We have no further information about the company sale at this time.",
22 |         "We always welcome your feedback about this system. Please fill out our survey at https://example.com/hrsurvey",
23 |         "Full details about the vacation policy can be found at https://example.com/policies/vacation",
24 |         "Information about the company car scheme is at https://example.com/benefits/car",
25 |         "Pets are not allowed in the office, as detailed at https://example.com/policies/pets.",
26 |         "If you have further questions, you can always email us at hr@example.com or ask your manager.",
27 |         "Could you provide further details about NEED_INFO",
28 |     ];
29 | }
30 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartTextAreaExamples/Basic.razor.css:
--------------------------------------------------------------------------------
1 | ::deep textarea { height: 100px; }
2 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartTextAreaExamples/Configurable.razor:
--------------------------------------------------------------------------------
 1 | @rendermode InteractiveServer
 2 | 
 3 | <PageTitle>Smart TextArea</PageTitle>
 4 | 
 5 | <form class="default-form rounded-md bg-gray-200 p-6 shadow-xl mb-12">
 6 |     <div class="grid mb-5">
 7 |         <label for="name">Comment</label>
 8 |         <SmartTextArea UserRole="@currentPreset.Role" UserPhrases="@currentPreset.Phrases" @bind-Value="@currentText"
 9 |                        style="height: 100px;" placeholder="Type your comment here..." autofocus />
10 |     </div>
11 | 
12 |     <label class="mt-8">Preset</label>
13 |     <select @bind:get="@currentPreset.Name" @bind:set="SelectPreset">
14 |         @foreach (var preset in presets)
15 |         {
16 |             <option value="@preset.Name">@preset.Name</option>
17 |         }
18 |     </select>
19 | 
20 |     <label class="mt-8">Role</label>
21 |     <input @bind="@currentPreset.Role" />
22 | 
23 |     <label class="mt-8">Phrases</label>
24 |     <textarea rows="6"
25 |               @bind:get="@string.Join(Environment.NewLine, currentPreset.Phrases)"
26 |               @bind:set="@(value => { currentPreset.Phrases = value.Split(Environment.NewLine); })"></textarea>
27 | </form>
28 | 
29 | @code {
30 |     private string? currentText;
31 |     private Preset currentPreset;
32 | 
33 |     private Preset[] presets = [
34 |         new Preset {
35 |             Name = "OSS project maintainer",
36 |             Role = "Maintainer of this open-source project replying to GitHub issues",
37 |             Phrases = [
38 |                 "Thankyou for contacting us.",
39 |                 "To investigate, we'll need a repro as a public Git repo.",
40 |                 "Could you please post a screenshot of NEED_INFO",
41 |                 "This sounds like a usage question. This issue tracker is intended for bugs and feature proposals. Unfortunately we don't have capacity to answer general usage questions and would recommend StackOverflow for a faster response.",
42 |                 "We don't accept ZIP files as repros.",
43 |                 "The issue may be that NEED_INFO"
44 |             ]
45 |         },
46 |         new Preset {
47 |             Name = "Car mechanic notes",
48 |             Role = "Mechanic tracking vehicle servicing notes for use by other mechanics",
49 |             Phrases = [
50 |                 "Tyre tread depth measured at NEED_INFO",
51 |                 "Oil filters replaced",
52 |                 "Next service due at NEED_INFO",
53 |                 "Confirmed with customer that NEED_INFO"
54 |             ]
55 |         },
56 |         new Preset {
57 |             Name = "C# code completion",
58 |             Role = "Code completion AI assitant who responds exclusively using C# source code",
59 |             Phrases = []
60 |         },
61 |         new Preset {
62 |             Name = "Wild-west themed restaurant bookings",
63 |             Role = "Bookings manager at wild-west themed restaurant The Wild Brunch, responding to customers in cowboy style",
64 |             Phrases = [
65 |                 "Yee-haw!",
66 |                 "So you wanna mosey on down for a bite?",
67 |                 "Why sure, we can cook you up somethin' special",
68 |                 "We're open everyday except Tuesdays (that's when we're at the rodeo)",
69 |                 "Sorry pardner, even if you're the sherrif, we gotta stick to our policy!",
70 |                 "Can I book you in for NEED_INFO",
71 |                 "How can I help you, kind stranger?",
72 |                 "Our website is at https://wildbrunch.example.com/"
73 |             ]
74 |         },
75 |     ];
76 | 
77 |     public Configurable()
78 |     {
79 |         currentPreset = presets[0];
80 |     }
81 | 
82 |     private void SelectPreset(string? name)
83 |     {
84 |         currentPreset = presets.Single(p => p.Name == name);
85 |     }
86 | 
87 |     class Preset
88 |     {
89 |         public required string Name { get; set; }
90 |         public required string Role { get; set; }
91 |         public required string[] Phrases { get; set; }
92 |     }
93 | }
94 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Pages/SmartTextAreaExamples/Examples.razor:
--------------------------------------------------------------------------------
 1 | @page "/smarttextarea"
 2 | @page "/smarttextarea/{*Path}"
 3 | @using ExampleBlazorApp.Components.TabSet
 4 | 
 5 | <PageTitle>Smart TextArea</PageTitle>
 6 | 
 7 | <TabSet>
 8 |     <Tab TComponent="Basic" Url="smarttextarea" Text="Basic" />
 9 |     <Tab TComponent="Configurable" Url="smarttextarea/configurable" Text="Configurable" />
10 | </TabSet>
11 | 
12 | @code {
13 |     [Parameter] public string? Path { get; set; }
14 | }
15 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/Routes.razor:
--------------------------------------------------------------------------------
1 | <Router AppAssembly="typeof(Program).Assembly">
2 |     <Found Context="routeData">
3 |         <RouteView RouteData="routeData" DefaultLayout="typeof(Layout.MainLayout)" />
4 |         <FocusOnNavigate RouteData="routeData" Selector="h1" />
5 |     </Found>
6 | </Router>
7 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/TabSet/Tab.razor:
--------------------------------------------------------------------------------
 1 | @inject NavigationManager Nav
 2 | @typeparam TComponent
 3 | @implements IDisposable
 4 | 
 5 | <li class="me-2">
 6 |     <a href="@Url" class="transition-colors inline-block p-4 border-b-2 @CssClasses" aria-current="@AriaCurrent">@Text</a>
 7 | </li>
 8 | 
 9 | @code {
10 |     bool isCurrent;
11 | 
12 |     [Parameter, EditorRequired] public string Url { get; set; } = default!;
13 |     [Parameter, EditorRequired] public string Text { get; set; } = default!;
14 | 
15 |     [CascadingParameter] public TabSet? Owner { get; set; }
16 | 
17 |     string CssClasses => isCurrent
18 |         ? "font-semibold text-blue-600 border-blue-600 active"
19 |         : "border-transparent hover:text-gray-700 hover:border-gray-500";
20 | 
21 |     string? AriaCurrent => isCurrent ? "page" : null;
22 | 
23 |     protected override void OnInitialized()
24 |         => Nav.LocationChanged += RefreshContentVisibility;
25 | 
26 |     protected override void OnParametersSet()
27 |         => RefreshContentVisibility(this, new LocationChangedEventArgs(Nav.Uri, false));
28 | 
29 |     public void Dispose()
30 |         => Nav.LocationChanged -= RefreshContentVisibility;
31 | 
32 |     private void RefreshContentVisibility(object? sender, LocationChangedEventArgs args)
33 |     {
34 |         if (Owner is null)
35 |         {
36 |             throw new InvalidOperationException($"{nameof(Tab<TComponent>)} must be placed inside a {nameof(TabSet)}");
37 |         }
38 | 
39 |         var wasCurrent = isCurrent;
40 |         isCurrent = Url == Nav.ToBaseRelativePath(args.Location);
41 |         if (isCurrent != wasCurrent)
42 |         {
43 |             if (isCurrent)
44 |             {
45 |                 Owner.SetCurrentTabContent(typeof(TComponent));
46 |             }
47 | 
48 |             if (sender == Nav) // False when triggered from OnParametersSet, when we don't need to call StateHasChanged manually anyway
49 |             {
50 |                 StateHasChanged();
51 |             }
52 |         }
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/TabSet/TabSet.razor:
--------------------------------------------------------------------------------
 1 | <div class="text-sm font-medium text-center text-gray-500 border-b border-gray-200 mb-6">
 2 |     <ul class="flex flex-wrap -mb-px">
 3 |         <CascadingValue Value="@this" IsFixed="@true">
 4 |             @ChildContent
 5 |         </CascadingValue>
 6 |     </ul>
 7 | </div>
 8 | 
 9 | @if (currentContentType is not null)
10 | {
11 |     <DynamicComponent Type="@currentContentType" />
12 | }
13 | 
14 | @code {
15 |     private Type? currentContentType;
16 | 
17 |     [Parameter] public RenderFragment? ChildContent { get; set; }
18 | 
19 |     internal void SetCurrentTabContent(Type componentType)
20 |     {
21 |         if (currentContentType != componentType)
22 |         {
23 |             currentContentType = componentType;
24 |             StateHasChanged();
25 |         }
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Components/_Imports.razor:
--------------------------------------------------------------------------------
 1 | @using System.Net.Http
 2 | @using System.Net.Http.Json
 3 | @using Microsoft.AspNetCore.Components.Forms
 4 | @using Microsoft.AspNetCore.Components.Routing
 5 | @using Microsoft.AspNetCore.Components.Web
 6 | @using static Microsoft.AspNetCore.Components.Web.RenderMode
 7 | @using Microsoft.AspNetCore.Components.Web.Virtualization
 8 | @using Microsoft.JSInterop
 9 | @using ExampleBlazorApp
10 | @using ExampleBlazorApp.Components
11 | @using SmartComponents
12 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/ExampleBlazorApp.csproj:
--------------------------------------------------------------------------------
 1 | <Project Sdk="Microsoft.NET.Sdk.Web">
 2 |   <Import Project="$(SharedSrcRoot)TailwindIntegration.targets" />
 3 | 
 4 |   <PropertyGroup>
 5 |     <TargetFramework>net8.0</TargetFramework>
 6 |     <Nullable>enable</Nullable>
 7 |     <ImplicitUsings>enable</ImplicitUsings>
 8 | 
 9 |     <TailwindCssInput>wwwroot\app.css</TailwindCssInput>
10 |     <TailwindCssOutput>wwwroot\app.out.css</TailwindCssOutput>
11 |   </PropertyGroup>
12 | 
13 |   <ItemGroup>
14 |     <Compile Include="$(SharedSrcRoot)RepoSharedConfigUtil.cs" />
15 |   </ItemGroup>
16 | 
17 |   <ItemGroup>
18 |     <PackageReference Include="SmartComponents.AspNetCore" />
19 |     <PackageReference Include="SmartComponents.Inference.OpenAI" />
20 |     <PackageReference Include="SmartComponents.LocalEmbeddings" />
21 |   </ItemGroup>
22 | </Project>
23 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Program.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using ExampleBlazorApp.Components;
 5 | using SmartComponents.Inference.OpenAI;
 6 | using SmartComponents.LocalEmbeddings;
 7 | 
 8 | var builder = WebApplication.CreateBuilder(args);
 9 | builder.Configuration.AddRepoSharedConfig();
10 | 
11 | // Add services to the container.
12 | builder.Services.AddRazorComponents()
13 |     .AddInteractiveServerComponents();
14 | builder.Services.AddSmartComponents()
15 |     .WithInferenceBackend<OpenAIInferenceBackend>();
16 | 
17 | builder.Services.AddSingleton<LocalEmbedder>();
18 | 
19 | var app = builder.Build();
20 | 
21 | // Configure the HTTP request pipeline.
22 | if (!app.Environment.IsDevelopment())
23 | {
24 |     app.UseExceptionHandler("/Error", createScopeForErrors: true);
25 |     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
26 |     app.UseHsts();
27 | }
28 | 
29 | app.UseHttpsRedirection();
30 | 
31 | app.UseStaticFiles();
32 | app.UseAntiforgery();
33 | 
34 | app.MapRazorComponents<App>()
35 |     .AddInteractiveServerRenderMode();
36 | 
37 | var embedder = app.Services.GetRequiredService<LocalEmbedder>();
38 | var expenseCategories = embedder.EmbedRange(
39 |     ["Groceries", "Utilities", "Rent", "Mortgage", "Car Payment", "Car Insurance", "Health Insurance", "Life Insurance", "Home Insurance", "Gas", "Public Transportation", "Dining Out", "Entertainment", "Travel", "Clothing", "Electronics", "Home Improvement", "Gifts", "Charity", "Education", "Childcare", "Pet Care", "Other"]);
40 | var issueLabels = embedder.EmbedRange(
41 |     ["Bug", "Docs", "Enhancement", "Question", "UI (Android)", "UI (iOS)", "UI (Windows)", "UI (Mac)", "Performance", "Security", "Authentication", "Accessibility"]);
42 | 
43 | app.MapSmartComboBox("/api/suggestions/expense-category",
44 |     request => embedder.FindClosest(request.Query, expenseCategories));
45 | 
46 | app.MapSmartComboBox("/api/suggestions/issue-label",
47 |     request => embedder.FindClosest(request.Query, issueLabels));
48 | 
49 | app.Run();
50 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/Properties/launchSettings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "$schema": "http://json.schemastore.org/launchsettings.json",
 3 |     "iisSettings": {
 4 |       "windowsAuthentication": false,
 5 |       "anonymousAuthentication": true,
 6 |       "iisExpress": {
 7 |         "applicationUrl": "http://localhost:11008",
 8 |         "sslPort": 44365
 9 |       }
10 |     },
11 |     "profiles": {
12 |       "http": {
13 |         "commandName": "Project",
14 |         "dotnetRunMessages": true,
15 |         "launchBrowser": true,
16 |         "applicationUrl": "http://localhost:5187",
17 |         "environmentVariables": {
18 |           "ASPNETCORE_ENVIRONMENT": "Development"
19 |         }
20 |       },
21 |       "https": {
22 |         "commandName": "Project",
23 |         "dotnetRunMessages": true,
24 |         "launchBrowser": true,
25 |         "applicationUrl": "https://localhost:7117;http://localhost:5187",
26 |         "environmentVariables": {
27 |           "ASPNETCORE_ENVIRONMENT": "Development"
28 |         }
29 |       },
30 |       "IIS Express": {
31 |         "commandName": "IISExpress",
32 |         "launchBrowser": true,
33 |         "environmentVariables": {
34 |           "ASPNETCORE_ENVIRONMENT": "Development"
35 |         }
36 |       }
37 |     }
38 |   }
39 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/StatefulPageBase.razor:
--------------------------------------------------------------------------------
 1 | @typeparam TPageState where TPageState : new()
 2 | @using System.Text.Json
 3 | @using Microsoft.AspNetCore.DataProtection
 4 | @inject IDataProtectionProvider DataProtectionProvider
 5 | @code {
 6 |     // A base class for components that round-trip arbitrary state though form posts.
 7 |     // The state is JSON-serialized and data protected.
 8 |     // And yes, this is basically ViewState, so be careful how much you put into it.
 9 | 
10 |     IDataProtector? pageStateProtector;
11 | 
12 |     [SupplyParameterFromForm]
13 |     public string? PageStateProtectedJson { get; set; }
14 | 
15 |     protected TPageState PageState { get; private set; } = default!;
16 | 
17 |     protected override void OnInitialized()
18 |     {
19 |         pageStateProtector = DataProtectionProvider!.CreateProtector(GetType().AssemblyQualifiedName!);
20 |         PageState = string.IsNullOrEmpty(PageStateProtectedJson)
21 |             ? new()
22 |             : JsonSerializer.Deserialize<TPageState>(pageStateProtector.Unprotect(PageStateProtectedJson))!;
23 |     }
24 | 
25 |     protected RenderFragment HiddenPageState =>
26 |         @<input type="hidden"
27 |                 name="@(nameof(PageStateProtectedJson))"
28 |                 value="@(pageStateProtector!.Protect(JsonSerializer.Serialize(PageState)))" />;
29 | }
30 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/appsettings.Development.json:
--------------------------------------------------------------------------------
1 | {
2 |   "Logging": {
3 |     "LogLevel": {
4 |       "Default": "Information",
5 |       "Microsoft.AspNetCore": "Warning"
6 |     }
7 |   }
8 | }
9 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/appsettings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "Logging": {
 3 |     "LogLevel": {
 4 |       "Default": "Information",
 5 |       "Microsoft.AspNetCore": "Warning"
 6 |     }
 7 |   },
 8 |   "AllowedHosts": "*"
 9 | }
10 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/tailwind.config.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 |     content: ["./**/*.{razor,html,cshtml}"],
3 |     theme: {
4 |         extend: {},
5 |     },
6 |     plugins: [],
7 | }
8 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/app.css:
--------------------------------------------------------------------------------
 1 | @import url(default-form.css);
 2 | 
 3 | @tailwind base;
 4 | @tailwind components;
 5 | @tailwind utilities;
 6 | 
 7 | /* inter-200 - latin */
 8 | @font-face {
 9 |     font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
10 |     font-family: 'Inter';
11 |     font-style: normal;
12 |     font-weight: 200;
13 |     src: url('./fonts/inter/inter-v13-latin-200.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
14 | }
15 | /* inter-regular - latin */
16 | @font-face {
17 |     font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
18 |     font-family: 'Inter';
19 |     font-style: normal;
20 |     font-weight: 400;
21 |     src: url('./fonts/inter/inter-v13-latin-regular.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
22 | }
23 | /* inter-500 - latin */
24 | @font-face {
25 |     font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
26 |     font-family: 'Inter';
27 |     font-style: normal;
28 |     font-weight: 500;
29 |     src: url('./fonts/inter/inter-v13-latin-500.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
30 | }
31 | /* inter-600 - latin */
32 | @font-face {
33 |     font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
34 |     font-family: 'Inter';
35 |     font-style: normal;
36 |     font-weight: 600;
37 |     src: url('./fonts/inter/inter-v13-latin-600.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
38 | }
39 | /* inter-800 - latin */
40 | @font-face {
41 |     font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
42 |     font-family: 'Inter';
43 |     font-style: normal;
44 |     font-weight: 800;
45 |     src: url('./fonts/inter/inter-v13-latin-800.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
46 | }
47 | 
48 | html {
49 |     font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !important;
50 |     font-weight: 400;
51 |     font-size: 18px;
52 | }
53 | 
54 | h1:focus {
55 |     outline: none;
56 | }
57 | 
58 | .valid.modified:not([type=checkbox]) {
59 |     outline: 1px solid #26b050;
60 | }
61 | 
62 | .invalid {
63 |     outline: 1px solid #e50000;
64 | }
65 | 
66 | .validation-message {
67 |     color: #e50000;
68 | }
69 | 
70 | .blazor-error-boundary {
71 |     background: url(data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTYiIGhlaWdodD0iNDkiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIG92ZXJmbG93PSJoaWRkZW4iPjxkZWZzPjxjbGlwUGF0aCBpZD0iY2xpcDAiPjxyZWN0IHg9IjIzNSIgeT0iNTEiIHdpZHRoPSI1NiIgaGVpZ2h0PSI0OSIvPjwvY2xpcFBhdGg+PC9kZWZzPjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMCkiIHRyYW5zZm9ybT0idHJhbnNsYXRlKC0yMzUgLTUxKSI+PHBhdGggZD0iTTI2My41MDYgNTFDMjY0LjcxNyA1MSAyNjUuODEzIDUxLjQ4MzcgMjY2LjYwNiA1Mi4yNjU4TDI2Ny4wNTIgNTIuNzk4NyAyNjcuNTM5IDUzLjYyODMgMjkwLjE4NSA5Mi4xODMxIDI5MC41NDUgOTIuNzk1IDI5MC42NTYgOTIuOTk2QzI5MC44NzcgOTMuNTEzIDI5MSA5NC4wODE1IDI5MSA5NC42NzgyIDI5MSA5Ny4wNjUxIDI4OS4wMzggOTkgMjg2LjYxNyA5OUwyNDAuMzgzIDk5QzIzNy45NjMgOTkgMjM2IDk3LjA2NTEgMjM2IDk0LjY3ODIgMjM2IDk0LjM3OTkgMjM2LjAzMSA5NC4wODg2IDIzNi4wODkgOTMuODA3MkwyMzYuMzM4IDkzLjAxNjIgMjM2Ljg1OCA5Mi4xMzE0IDI1OS40NzMgNTMuNjI5NCAyNTkuOTYxIDUyLjc5ODUgMjYwLjQwNyA1Mi4yNjU4QzI2MS4yIDUxLjQ4MzcgMjYyLjI5NiA1MSAyNjMuNTA2IDUxWk0yNjMuNTg2IDY2LjAxODNDMjYwLjczNyA2Ni4wMTgzIDI1OS4zMTMgNjcuMTI0NSAyNTkuMzEzIDY5LjMzNyAyNTkuMzEzIDY5LjYxMDIgMjU5LjMzMiA2OS44NjA4IDI1OS4zNzEgNzAuMDg4N0wyNjEuNzk1IDg0LjAxNjEgMjY1LjM4IDg0LjAxNjEgMjY3LjgyMSA2OS43NDc1QzI2Ny44NiA2OS43MzA5IDI2Ny44NzkgNjkuNTg3NyAyNjcuODc5IDY5LjMxNzkgMjY3Ljg3OSA2Ny4xMTgyIDI2Ni40NDggNjYuMDE4MyAyNjMuNTg2IDY2LjAxODNaTTI2My41NzYgODYuMDU0N0MyNjEuMDQ5IDg2LjA1NDcgMjU5Ljc4NiA4Ny4zMDA1IDI1OS43ODYgODkuNzkyMSAyNTkuNzg2IDkyLjI4MzcgMjYxLjA0OSA5My41Mjk1IDI2My41NzYgOTMuNTI5NSAyNjYuMTE2IDkzLjUyOTUgMjY3LjM4NyA5Mi4yODM3IDI2Ny4zODcgODkuNzkyMSAyNjcuMzg3IDg3LjMwMDUgMjY2LjExNiA4Ni4wNTQ3IDI2My41NzYgODYuMDU0N1oiIGZpbGw9IiNGRkU1MDAiIGZpbGwtcnVsZT0iZXZlbm9kZCIvPjwvZz48L3N2Zz4=) no-repeat 1rem/1.8rem, #b32121;
72 |     padding: 1rem 1rem 1rem 3.7rem;
73 |     color: white;
74 | }
75 | 
76 |     .blazor-error-boundary::after {
77 |         content: "An error has occurred."
78 |     }
79 | 
80 | main p a {
81 |     color: rgb(37 99 235);
82 |     text-decoration: underline;
83 | }
84 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/default-form.css:
--------------------------------------------------------------------------------
  1 | form.default-form label {
  2 |     display: block;
  3 |     margin-bottom: 0.5rem;
  4 |     font-size: 0.875rem;
  5 |     line-height: 1.25rem;
  6 |     font-weight: 500;
  7 |     color: rgb(17 24 39);
  8 | }
  9 | 
 10 |     form.default-form label.inline-checkbox {
 11 |         display: flex;
 12 |         align-items: center;
 13 |     }
 14 | 
 15 | form.default-form input, form.default-form textarea, form.default-form input, form.default-form select {
 16 |     color: rgb(17 24 39);
 17 |     padding: 0.625rem;
 18 |     background-color: rgb(249 250 251);
 19 |     border: 1px solid rgb(209 213 219);
 20 |     border-radius: 0.5rem;
 21 |     width: 100%;
 22 |     display: block;
 23 |     font-size: .925rem;
 24 | }
 25 | 
 26 |     form.default-form input:focus-visible, form.default-form textarea:focus-visible, form.default-form select:focus-visible {
 27 |         outline: 2px solid #3b82f6;
 28 |     }
 29 | 
 30 | button.default-button {
 31 |     border-radius: 0.5rem;
 32 |     background-color: rgb(28 100 242);
 33 |     color: white;
 34 |     padding: 0.625rem 1.25rem;
 35 |     font-weight: 500;
 36 |     font-size: .875rem;
 37 |     line-height: 1.25rem;
 38 |     transition: background-color ease-out 0.15s, transform cubic-bezier(.19,.62,.15,.83) 0.1s, opacity ease-out 0.2s;
 39 |     display: inline-flex;
 40 |     gap: 0.4rem;
 41 |     align-items: center;
 42 | }
 43 | 
 44 |     button.default-button:hover {
 45 |         filter: brightness(1.2);
 46 |     }
 47 | 
 48 |     button.default-button:active {
 49 |         filter: brightness(0.8);
 50 |         transform: translateY(1px) scale(0.99);
 51 |     }
 52 | 
 53 |     button.default-button:disabled {
 54 |         opacity: 0.5;
 55 |     }
 56 | 
 57 | button.secondary {
 58 |     background-color: #555555;
 59 | }
 60 | 
 61 | form.default-form .floating-placeholder {
 62 |     position: relative;
 63 | }
 64 | 
 65 | form.default-form .floating-placeholder input {
 66 |     background: none;
 67 |     padding: 1.5rem 0 0.5rem 0;
 68 |     border: none;
 69 |     border-radius: 0;
 70 |     border-bottom: 2px solid rgb(180, 180, 180);
 71 |     font-size: .875rem;
 72 |     line-height: 1.25rem;
 73 | }
 74 | 
 75 |     form.default-form .floating-placeholder input:focus-visible {
 76 |         outline: none;
 77 |         border-color: #3b82f6;
 78 |     }
 79 | 
 80 |     form.default-form .floating-placeholder label {
 81 |         position: absolute;
 82 |         bottom: 0.625rem;
 83 |         font-size: .875rem;
 84 |         line-height: 1.25rem;
 85 |         margin: 0;
 86 |         padding: 0;
 87 |         font-weight: 400;
 88 |         color: rgb(0 0 0 / 60%);
 89 |         transform-origin: bottom left;
 90 |         transition: all 0.1s ease-out;
 91 |         pointer-events: none;
 92 |     }
 93 | 
 94 |     form.default-form .floating-placeholder:focus-visible label {
 95 |         color: rgb(37 99 235);
 96 |     }
 97 | 
 98 |     form.default-form .floating-placeholder:focus-visible label, form.default-form .floating-placeholder:not(:has(input:placeholder-shown)) label {
 99 |         transform: translateY(-1.5rem) scale(0.8);
100 |         font-weight: 500;
101 |     }
102 | 
103 | 
104 |     form.default-form .floating-placeholder input.valid.modified {
105 |         outline: none;
106 |         border-color: green;
107 |     }
108 | 
109 |         form.default-form .floating-placeholder:has(input.valid.modified) label {
110 |             color: green;
111 |         }
112 | 
113 |     form.default-form .floating-placeholder input.invalid {
114 |         outline: none;
115 |         border-color: red;
116 |     }
117 | 
118 |         form.default-form .floating-placeholder:has(input.invalid) label {
119 |             color: red;
120 |         }
121 | 
122 | form.default-form .inline-radio {
123 |     flex-grow: 1;
124 |     padding: 0.625rem;
125 |     background-color: rgb(249 250 251);
126 |     border: 1px solid rgb(209 213 219);
127 |     font-size: .925rem;
128 |     text-align: center;
129 |     cursor: pointer;
130 |     position: relative;
131 | }
132 | 
133 |     form.default-form .inline-radio:first-of-type {
134 |         border-top-left-radius: 0.625rem;
135 |         border-bottom-left-radius: 0.625rem;
136 |     }
137 | 
138 |     form.default-form .inline-radio:last-of-type {
139 |         border-top-right-radius: 0.625rem;
140 |         border-bottom-right-radius: 0.625rem;
141 |     }
142 | 
143 |     form.default-form .inline-radio:not(:first-of-type) {
144 |         margin-left: -1px;
145 |     }
146 | 
147 |     form.default-form .inline-radio input[type=radio] {
148 |         opacity: 0;
149 |         position: absolute;
150 |         z-index: 1;
151 |         inset: 0;
152 |         pointer-events: none;
153 |     }
154 | 
155 |     form.default-form .inline-radio:focus-within {
156 |         outline: 2px solid #3b82f6;
157 |         z-index: 1;
158 |     }
159 | 
160 |     form.default-form .inline-radio:hover:not(:focus-within) {
161 |         color: #3b82f6;
162 |         background-color: #eee;
163 |     }
164 | 
165 |     form.default-form .inline-radio:has(input[type=radio]:checked) {
166 |         background-color: #777;
167 |         color: white;
168 |     }
169 | 
170 | form.default-form .bool-list label:has(input[type=checkbox]:checked) {
171 |     background-color: #777;
172 |     color: white;
173 | }
174 | 
175 | form.default-form .bool-list input[type=checkbox] {
176 |     accent-color: white;
177 | }
178 | 
179 | form.default-form .smartcombobox-suggestions {
180 |     border-radius: 0.3rem;
181 |     box-shadow: 0 2px 11px rgba(0,0,0,0.2);
182 |     margin-top: 1px;
183 | }
184 | 


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-200.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-200.woff2


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-500.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-500.woff2


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-600.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-600.woff2


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-800.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-800.woff2


--------------------------------------------------------------------------------
/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-regular.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/samples/ExampleBlazorApp/wwwroot/fonts/inter/inter-v13-latin-regular.woff2


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Controllers/HomeController.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using System.Diagnostics;
 5 | using ExampleMvcRazorPagesApp.Models;
 6 | using Microsoft.AspNetCore.Mvc;
 7 | 
 8 | namespace ExampleMvcRazorPagesApp.Controllers;
 9 | 
10 | public class HomeController : Controller
11 | {
12 |     private readonly ILogger<HomeController> _logger;
13 |     private readonly IConfiguration _config;
14 | 
15 |     public HomeController(ILogger<HomeController> logger, IConfiguration config)
16 |     {
17 |         _logger = logger;
18 |         _config = config;
19 |     }
20 | 
21 |     public IActionResult Index()
22 |     {
23 |         var configError = RepoSharedConfigUtil.GetConfigError(_config);
24 |         return View(configError);
25 |     }
26 | 
27 |     [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
28 |     public IActionResult Error()
29 |     {
30 |         return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/ExampleMvcRazorPagesApp.csproj:
--------------------------------------------------------------------------------
 1 | <Project Sdk="Microsoft.NET.Sdk.Web">
 2 | 
 3 |   <PropertyGroup>
 4 |     <TargetFramework>net8.0</TargetFramework>
 5 |     <Nullable>enable</Nullable>
 6 |     <ImplicitUsings>enable</ImplicitUsings>
 7 |     <LangVersion>latest</LangVersion>
 8 |   </PropertyGroup>
 9 | 
10 |   <ItemGroup>
11 |     <PackageReference Include="SmartComponents.AspNetCore" />
12 |     <PackageReference Include="SmartComponents.Inference.OpenAI" />
13 |     <PackageReference Include="SmartComponents.LocalEmbeddings" />
14 |   </ItemGroup>
15 | 
16 |   <ItemGroup>
17 |     <Compile Include="$(SharedSrcRoot)RepoSharedConfigUtil.cs" />
18 |   </ItemGroup>
19 | 
20 | </Project>
21 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Models/ErrorViewModel.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | namespace ExampleMvcRazorPagesApp.Models;
 5 | 
 6 | public class ErrorViewModel
 7 | {
 8 |     public string? RequestId { get; set; }
 9 | 
10 |     public bool ShowRequestId => !string.IsNullOrEmpty(RequestId);
11 | }
12 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/SmartComboBox/Index.cshtml:
--------------------------------------------------------------------------------
 1 | @page
 2 | @model ExampleMvcRazorPagesApp.Pages.SmartPaste.IndexModel
 3 | 
 4 | <h1>Smart ComboBox</h1>
 5 | 
 6 | <form method="post">
 7 |     <div>
 8 |         <div>
 9 |             <label for="accounting-category">Accounting Category</label>
10 |             <smart-combobox url="~/api/suggestions/accounting-categories" id="accounting-category" placeholder="Type a category name..." required />
11 |         </div>
12 |     </div>
13 | 
14 |     <div>
15 |         <button type="submit">Save</button>
16 |         <button type="reset">Reset</button>
17 |     </div>
18 | </form>
19 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/SmartComboBox/Index.cshtml.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using Microsoft.AspNetCore.Mvc.RazorPages;
 5 | 
 6 | namespace ExampleMvcRazorPagesApp.Pages.SmartComboBox
 7 | {
 8 |     public class IndexModel : PageModel
 9 |     {
10 |         public void OnGet()
11 |         {
12 |             ViewData["Title"] = "Smart ComboBox";
13 |         }
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/SmartPaste/Index.cshtml:
--------------------------------------------------------------------------------
 1 | @page
 2 | @model ExampleMvcRazorPagesApp.Pages.SmartPaste.IndexModel
 3 | 
 4 | <h1>Smart Paste</h1>
 5 | 
 6 | <form method="post">
 7 |     <div>
 8 |         <div>
 9 |             <label for="name">Name</label>
10 |             <input type="text" id="name" placeholder="Your name" required />
11 |         </div>
12 |         <div>
13 |             <label for="age">Age</label>
14 |             <input type="number" id="age" placeholder="Your age" required />
15 |         </div>
16 |     </div>
17 | 
18 |     <div>
19 |         <button type="submit">Save</button>
20 |         <button type="reset">Reset</button>
21 |         <smart-paste-button default-icon />
22 |     </div>
23 | </form>
24 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/SmartPaste/Index.cshtml.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using Microsoft.AspNetCore.Mvc.RazorPages;
 5 | 
 6 | namespace ExampleMvcRazorPagesApp.Pages.SmartPaste
 7 | {
 8 |     public class IndexModel : PageModel
 9 |     {
10 |         public void OnGet()
11 |         {
12 |             ViewData["Title"] = "Smart Paste";
13 |         }
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/SmartTextArea/Index.cshtml:
--------------------------------------------------------------------------------
1 | @page
2 | @model ExampleMvcRazorPagesApp.Pages.SmartTextArea.IndexModel
3 | 
4 | <h1>Smart TextArea</h1>
5 | 
6 | <form method="post">
7 |     <smart-textarea user-role="HR assistant" placeholder="Type a message..." style="width: 300px; height: 100px; padding: 10px;" />
8 | </form>
9 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/SmartTextArea/Index.cshtml.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using Microsoft.AspNetCore.Mvc.RazorPages;
 5 | 
 6 | namespace ExampleMvcRazorPagesApp.Pages.SmartTextArea
 7 | {
 8 |     public class IndexModel : PageModel
 9 |     {
10 |         public void OnGet()
11 |         {
12 |             ViewData["Title"] = "Smart TextArea";
13 |         }
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/_ViewImports.cshtml:
--------------------------------------------------------------------------------
1 | @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
2 | @addTagHelper *, SmartComponents.AspNetCore
3 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Pages/_ViewStart.cshtml:
--------------------------------------------------------------------------------
1 | @{
2 |     Layout = "_Layout";
3 | }
4 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Program.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using SmartComponents.Inference.OpenAI;
 5 | using SmartComponents.LocalEmbeddings;
 6 | 
 7 | var builder = WebApplication.CreateBuilder(args);
 8 | builder.Configuration.AddRepoSharedConfig();
 9 | 
10 | // Add services to the container.
11 | builder.Services.AddControllersWithViews();
12 | builder.Services.AddRazorPages();
13 | builder.Services.AddSmartComponents()
14 |     .WithInferenceBackend<OpenAIInferenceBackend>();
15 | 
16 | builder.Services.AddSingleton<LocalEmbedder>();
17 | 
18 | var app = builder.Build();
19 | 
20 | // Configure the HTTP request pipeline.
21 | if (!app.Environment.IsDevelopment())
22 | {
23 |     app.UseExceptionHandler("/Home/Error");
24 |     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
25 |     app.UseHsts();
26 | }
27 | 
28 | app.UseHttpsRedirection();
29 | app.UseStaticFiles();
30 | 
31 | app.UseRouting();
32 | 
33 | app.UseAuthorization();
34 | 
35 | app.MapControllerRoute(
36 |     name: "default",
37 |     pattern: "{controller=Home}/{action=Index}/{id?}");
38 | 
39 | app.MapRazorPages();
40 | 
41 | // Prepare a list of expense categories and corresponding embeddings
42 | var embedder = app.Services.GetRequiredService<LocalEmbedder>();
43 | var expenseCategories = embedder.EmbedRange(
44 |     ["Groceries", "Utilities", "Rent", "Mortgage", "Car Payment", "Car Insurance", "Health Insurance", "Life Insurance", "Home Insurance", "Gas", "Public Transportation", "Dining Out", "Entertainment", "Travel", "Clothing", "Electronics", "Home Improvement", "Gifts", "Charity", "Education", "Childcare", "Pet Care", "Other"]);
45 | 
46 | app.MapSmartComboBox("/api/suggestions/accounting-categories",
47 |     request => embedder.FindClosest(request.Query, expenseCategories));
48 | 
49 | app.Run();
50 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Properties/launchSettings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "$schema": "http://json.schemastore.org/launchsettings.json",
 3 |   "iisSettings": {
 4 |     "windowsAuthentication": false,
 5 |     "anonymousAuthentication": true,
 6 |     "iisExpress": {
 7 |       "applicationUrl": "http://localhost:7495",
 8 |       "sslPort": 44304
 9 |     }
10 |   },
11 |   "profiles": {
12 |     "http": {
13 |       "commandName": "Project",
14 |       "dotnetRunMessages": true,
15 |       "launchBrowser": true,
16 |       "applicationUrl": "http://localhost:5035",
17 |       "environmentVariables": {
18 |         "ASPNETCORE_ENVIRONMENT": "Development"
19 |       }
20 |     },
21 |     "https": {
22 |       "commandName": "Project",
23 |       "dotnetRunMessages": true,
24 |       "launchBrowser": true,
25 |       "applicationUrl": "https://localhost:7227;http://localhost:5035",
26 |       "environmentVariables": {
27 |         "ASPNETCORE_ENVIRONMENT": "Development"
28 |       }
29 |     },
30 |     "IIS Express": {
31 |       "commandName": "IISExpress",
32 |       "launchBrowser": true,
33 |       "environmentVariables": {
34 |         "ASPNETCORE_ENVIRONMENT": "Development"
35 |       }
36 |     }
37 |   }
38 | }
39 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/Home/Index.cshtml:
--------------------------------------------------------------------------------
 1 | @model Exception?
 2 | @{
 3 |     ViewData["Title"] = "Home Page";
 4 | }
 5 | 
 6 | @if (Model is { } invalidConfigException)
 7 | {
 8 |     <div class="p-4 rounded-3 border border-2 border-danger shadow-lg" style="background: #ffdbdb">
 9 |         <h4>Missing or invalid configuration</h4>
10 |         <p class="mt-4" style="font-weight: 600">
11 |             Reason: <span class="font-semibold">@invalidConfigException.Message</span>
12 |         </p>
13 |         <p>
14 |             To run the samples that use OpenAI inference, you need to configure an API key, either in
15 |             <code>appsettings.Development.json</code> or in <code>RepoSharedConfig.json</code> at the
16 |             root of this repo. For instructions, see
17 |             <a href="https://github.com/dotnet-smartcomponents/smartcomponents/blob/main/docs/configure-openai-backend.md">Configure the OpenAI backend</a>.
18 |         </p>
19 |         <p>
20 |             Without an API key, you can still run <a href="smartcombobox">Smart ComboBox</a>
21 |             sample since it does not require any external language model backend.
22 |         </p>
23 |     </div>
24 | }
25 | 
26 | <p class="mt-4">
27 |     Smart Components lets you
28 |     <strong class="font-semibold">add genuinely useful AI-powered features to your .NET apps quickly and easily</strong>.
29 | </p>
30 | 
31 | <p>
32 |     It's an experiment from the .NET team, and is initially available for ASP.NET Core 6.0 and later.
33 | </p>
34 | 
35 | <h4 class="mt-4">Learn more</h4>
36 | 
37 | <ul class="mt-4">
38 |     <li>
39 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents">Readme and documentation</a></p>
40 |     </li>
41 |     <li>
42 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents/blob/main/docs/getting-started-blazor.md">Getting started with Smart Components and Blazor</a></p>
43 |     </li>
44 |     <li>
45 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents/blob/main/docs/getting-started-mvc-razor-pages.md">Getting started with Smart Components and MVC/Razor Pages</a></p>
46 |     </li>
47 |     <li>
48 |         <p><a href="https://github.com/dotnet-smartcomponents/smartcomponents/issues">Submit feedback / questions</a></p>
49 |     </li>
50 | </ul>
51 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/Shared/Error.cshtml:
--------------------------------------------------------------------------------
 1 | @model ErrorViewModel
 2 | @{
 3 |     ViewData["Title"] = "Error";
 4 | }
 5 | 
 6 | <h1 class="text-danger">Error.</h1>
 7 | <h2 class="text-danger">An error occurred while processing your request.</h2>
 8 | 
 9 | @if (Model.ShowRequestId)
10 | {
11 |     <p>
12 |         <strong>Request ID:</strong> <code>@Model.RequestId</code>
13 |     </p>
14 | }
15 | 
16 | <h3>Development Mode</h3>
17 | <p>
18 |     Swapping to <strong>Development</strong> environment will display more detailed information about the error that occurred.
19 | </p>
20 | <p>
21 |     <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
22 |     It can result in displaying sensitive information from exceptions to end users.
23 |     For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
24 |     and restarting the app.
25 | </p>
26 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/Shared/_Layout.cshtml:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 | <head>
 4 |     <meta charset="utf-8" />
 5 |     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 6 |     <title>@ViewData["Title"] - Smart Components</title>
 7 |     <link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.min.css" />
 8 |     <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
 9 |     <link rel="stylesheet" href="~/ExampleMvcRazorPagesApp.styles.css" asp-append-version="true" />
10 | </head>
11 | <body>
12 |     <header>
13 |         <nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
14 |             <div class="container-fluid">
15 |                 <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">Smart Components (MVC/Razor)</a>
16 |                 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target=".navbar-collapse" aria-controls="navbarSupportedContent"
17 |                         aria-expanded="false" aria-label="Toggle navigation">
18 |                     <span class="navbar-toggler-icon"></span>
19 |                 </button>
20 |                 <div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
21 |                     <ul class="navbar-nav flex-grow-1">
22 |                         <li class="nav-item">
23 |                             <a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Index">Home</a>
24 |                         </li>
25 |                         <li class="nav-item">
26 |                             <a class="nav-link text-dark" href="~/SmartPaste">Smart Paste</a>
27 |                         </li>
28 |                         <li class="nav-item">
29 |                             <a class="nav-link text-dark" href="~/SmartComboBox">Smart ComboBox</a>
30 |                         </li>
31 |                         <li class="nav-item">
32 |                             <a class="nav-link text-dark" href="~/SmartTextArea">Smart TextArea</a>
33 |                         </li>
34 |                     </ul>
35 |                 </div>
36 |             </div>
37 |         </nav>
38 |     </header>
39 |     <div class="container">
40 |         <main role="main" class="pb-3">
41 |             @RenderBody()
42 |         </main>
43 |     </div>
44 | 
45 |     <footer class="border-top footer text-muted">
46 |         <div class="container">
47 |             &copy; 2024 - ExampleMvcRazorPagesApp - <a asp-area="" asp-controller="Home" asp-action="Privacy">Privacy</a>
48 |         </div>
49 |     </footer>
50 |     <script src="~/lib/jquery/dist/jquery.min.js"></script>
51 |     <script src="~/lib/bootstrap/dist/js/bootstrap.bundle.min.js"></script>
52 |     <script src="~/js/site.js" asp-append-version="true"></script>
53 |     @await RenderSectionAsync("Scripts", required: false)
54 | </body>
55 | </html>
56 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/Shared/_Layout.cshtml.css:
--------------------------------------------------------------------------------
 1 | /* Please see documentation at https://learn.microsoft.com/aspnet/core/client-side/bundling-and-minification
 2 | for details on configuring this project to bundle and minify static web assets. */
 3 | 
 4 | a.navbar-brand {
 5 |   white-space: normal;
 6 |   text-align: center;
 7 |   word-break: break-all;
 8 | }
 9 | 
10 | a {
11 |   color: #0077cc;
12 | }
13 | 
14 | .btn-primary {
15 |   color: #fff;
16 |   background-color: #1b6ec2;
17 |   border-color: #1861ac;
18 | }
19 | 
20 | .nav-pills .nav-link.active, .nav-pills .show > .nav-link {
21 |   color: #fff;
22 |   background-color: #1b6ec2;
23 |   border-color: #1861ac;
24 | }
25 | 
26 | .border-top {
27 |   border-top: 1px solid #e5e5e5;
28 | }
29 | .border-bottom {
30 |   border-bottom: 1px solid #e5e5e5;
31 | }
32 | 
33 | .box-shadow {
34 |   box-shadow: 0 .25rem .75rem rgba(0, 0, 0, .05);
35 | }
36 | 
37 | button.accept-policy {
38 |   font-size: 1rem;
39 |   line-height: inherit;
40 | }
41 | 
42 | .footer {
43 |   position: absolute;
44 |   bottom: 0;
45 |   width: 100%;
46 |   white-space: nowrap;
47 |   line-height: 60px;
48 | }
49 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/Shared/_ValidationScriptsPartial.cshtml:
--------------------------------------------------------------------------------
1 | <script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
2 | <script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>
3 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/_ViewImports.cshtml:
--------------------------------------------------------------------------------
1 | @using ExampleMvcRazorPagesApp
2 | @using ExampleMvcRazorPagesApp.Models
3 | @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
4 | @addTagHelper *, SmartComponents.AspNetCore
5 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/Views/_ViewStart.cshtml:
--------------------------------------------------------------------------------
1 | @{
2 |     Layout = "_Layout";
3 | }
4 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/appsettings.Development.json:
--------------------------------------------------------------------------------
1 | {
2 |   "Logging": {
3 |     "LogLevel": {
4 |       "Default": "Information",
5 |       "Microsoft.AspNetCore": "Warning"
6 |     }
7 |   }
8 | }
9 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/appsettings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "Logging": {
 3 |     "LogLevel": {
 4 |       "Default": "Information",
 5 |       "Microsoft.AspNetCore": "Warning"
 6 |     }
 7 |   },
 8 |   "AllowedHosts": "*"
 9 | }
10 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/css/site.css:
--------------------------------------------------------------------------------
 1 | html {
 2 |   font-size: 14px;
 3 | }
 4 | 
 5 | @media (min-width: 768px) {
 6 |   html {
 7 |     font-size: 16px;
 8 |   }
 9 | }
10 | 
11 | .btn:focus, .btn:active:focus, .btn-link.nav-link:focus, .form-control:focus, .form-check-input:focus {
12 |   box-shadow: 0 0 0 0.1rem white, 0 0 0 0.25rem #258cfb;
13 | }
14 | 
15 | html {
16 |   position: relative;
17 |   min-height: 100%;
18 | }
19 | 
20 | body {
21 |   margin-bottom: 60px;
22 | }


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dotnet-smartcomponents/smartcomponents/8692b1f77554a16f59fe90acc1cd72370e701022/samples/ExampleMvcRazorPagesApp/wwwroot/favicon.ico


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/js/site.js:
--------------------------------------------------------------------------------
1 | // Please see documentation at https://learn.microsoft.com/aspnet/core/client-side/bundling-and-minification
2 | // for details on configuring this project to bundle and minify static web assets.
3 | 
4 | // Write your JavaScript code.
5 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/bootstrap/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2011-2021 Twitter, Inc.
 4 | Copyright (c) 2011-2021 The Bootstrap Authors
 5 | 
 6 | Permission is hereby granted, free of charge, to any person obtaining a copy
 7 | of this software and associated documentation files (the "Software"), to deal
 8 | in the Software without restriction, including without limitation the rights
 9 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | copies of the Software, and to permit persons to whom the Software is
11 | furnished to do so, subject to the following conditions:
12 | 
13 | The above copyright notice and this permission notice shall be included in
14 | all copies or substantial portions of the Software.
15 | 
16 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 | THE SOFTWARE.
23 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.css:
--------------------------------------------------------------------------------
  1 | /*!
  2 |  * Bootstrap Reboot v5.1.0 (https://getbootstrap.com/)
  3 |  * Copyright 2011-2021 The Bootstrap Authors
  4 |  * Copyright 2011-2021 Twitter, Inc.
  5 |  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
  6 |  * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md)
  7 |  */
  8 | *,
  9 | *::before,
 10 | *::after {
 11 |   box-sizing: border-box;
 12 | }
 13 | 
 14 | @media (prefers-reduced-motion: no-preference) {
 15 |   :root {
 16 |     scroll-behavior: smooth;
 17 |   }
 18 | }
 19 | 
 20 | body {
 21 |   margin: 0;
 22 |   font-family: var(--bs-body-font-family);
 23 |   font-size: var(--bs-body-font-size);
 24 |   font-weight: var(--bs-body-font-weight);
 25 |   line-height: var(--bs-body-line-height);
 26 |   color: var(--bs-body-color);
 27 |   text-align: var(--bs-body-text-align);
 28 |   background-color: var(--bs-body-bg);
 29 |   -webkit-text-size-adjust: 100%;
 30 |   -webkit-tap-highlight-color: rgba(0, 0, 0, 0);
 31 | }
 32 | 
 33 | hr {
 34 |   margin: 1rem 0;
 35 |   color: inherit;
 36 |   background-color: currentColor;
 37 |   border: 0;
 38 |   opacity: 0.25;
 39 | }
 40 | 
 41 | hr:not([size]) {
 42 |   height: 1px;
 43 | }
 44 | 
 45 | h6, h5, h4, h3, h2, h1 {
 46 |   margin-top: 0;
 47 |   margin-bottom: 0.5rem;
 48 |   font-weight: 500;
 49 |   line-height: 1.2;
 50 | }
 51 | 
 52 | h1 {
 53 |   font-size: calc(1.375rem + 1.5vw);
 54 | }
 55 | @media (min-width: 1200px) {
 56 |   h1 {
 57 |     font-size: 2.5rem;
 58 |   }
 59 | }
 60 | 
 61 | h2 {
 62 |   font-size: calc(1.325rem + 0.9vw);
 63 | }
 64 | @media (min-width: 1200px) {
 65 |   h2 {
 66 |     font-size: 2rem;
 67 |   }
 68 | }
 69 | 
 70 | h3 {
 71 |   font-size: calc(1.3rem + 0.6vw);
 72 | }
 73 | @media (min-width: 1200px) {
 74 |   h3 {
 75 |     font-size: 1.75rem;
 76 |   }
 77 | }
 78 | 
 79 | h4 {
 80 |   font-size: calc(1.275rem + 0.3vw);
 81 | }
 82 | @media (min-width: 1200px) {
 83 |   h4 {
 84 |     font-size: 1.5rem;
 85 |   }
 86 | }
 87 | 
 88 | h5 {
 89 |   font-size: 1.25rem;
 90 | }
 91 | 
 92 | h6 {
 93 |   font-size: 1rem;
 94 | }
 95 | 
 96 | p {
 97 |   margin-top: 0;
 98 |   margin-bottom: 1rem;
 99 | }
100 | 
101 | abbr[title],
102 | abbr[data-bs-original-title] {
103 |   -webkit-text-decoration: underline dotted;
104 |   text-decoration: underline dotted;
105 |   cursor: help;
106 |   -webkit-text-decoration-skip-ink: none;
107 |   text-decoration-skip-ink: none;
108 | }
109 | 
110 | address {
111 |   margin-bottom: 1rem;
112 |   font-style: normal;
113 |   line-height: inherit;
114 | }
115 | 
116 | ol,
117 | ul {
118 |   padding-left: 2rem;
119 | }
120 | 
121 | ol,
122 | ul,
123 | dl {
124 |   margin-top: 0;
125 |   margin-bottom: 1rem;
126 | }
127 | 
128 | ol ol,
129 | ul ul,
130 | ol ul,
131 | ul ol {
132 |   margin-bottom: 0;
133 | }
134 | 
135 | dt {
136 |   font-weight: 700;
137 | }
138 | 
139 | dd {
140 |   margin-bottom: 0.5rem;
141 |   margin-left: 0;
142 | }
143 | 
144 | blockquote {
145 |   margin: 0 0 1rem;
146 | }
147 | 
148 | b,
149 | strong {
150 |   font-weight: bolder;
151 | }
152 | 
153 | small {
154 |   font-size: 0.875em;
155 | }
156 | 
157 | mark {
158 |   padding: 0.2em;
159 |   background-color: #fcf8e3;
160 | }
161 | 
162 | sub,
163 | sup {
164 |   position: relative;
165 |   font-size: 0.75em;
166 |   line-height: 0;
167 |   vertical-align: baseline;
168 | }
169 | 
170 | sub {
171 |   bottom: -0.25em;
172 | }
173 | 
174 | sup {
175 |   top: -0.5em;
176 | }
177 | 
178 | a {
179 |   color: #0d6efd;
180 |   text-decoration: underline;
181 | }
182 | a:hover {
183 |   color: #0a58ca;
184 | }
185 | 
186 | a:not([href]):not([class]), a:not([href]):not([class]):hover {
187 |   color: inherit;
188 |   text-decoration: none;
189 | }
190 | 
191 | pre,
192 | code,
193 | kbd,
194 | samp {
195 |   font-family: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
196 |   font-size: 1em;
197 |   direction: ltr /* rtl:ignore */;
198 |   unicode-bidi: bidi-override;
199 | }
200 | 
201 | pre {
202 |   display: block;
203 |   margin-top: 0;
204 |   margin-bottom: 1rem;
205 |   overflow: auto;
206 |   font-size: 0.875em;
207 | }
208 | pre code {
209 |   font-size: inherit;
210 |   color: inherit;
211 |   word-break: normal;
212 | }
213 | 
214 | code {
215 |   font-size: 0.875em;
216 |   color: #d63384;
217 |   word-wrap: break-word;
218 | }
219 | a > code {
220 |   color: inherit;
221 | }
222 | 
223 | kbd {
224 |   padding: 0.2rem 0.4rem;
225 |   font-size: 0.875em;
226 |   color: #fff;
227 |   background-color: #212529;
228 |   border-radius: 0.2rem;
229 | }
230 | kbd kbd {
231 |   padding: 0;
232 |   font-size: 1em;
233 |   font-weight: 700;
234 | }
235 | 
236 | figure {
237 |   margin: 0 0 1rem;
238 | }
239 | 
240 | img,
241 | svg {
242 |   vertical-align: middle;
243 | }
244 | 
245 | table {
246 |   caption-side: bottom;
247 |   border-collapse: collapse;
248 | }
249 | 
250 | caption {
251 |   padding-top: 0.5rem;
252 |   padding-bottom: 0.5rem;
253 |   color: #6c757d;
254 |   text-align: left;
255 | }
256 | 
257 | th {
258 |   text-align: inherit;
259 |   text-align: -webkit-match-parent;
260 | }
261 | 
262 | thead,
263 | tbody,
264 | tfoot,
265 | tr,
266 | td,
267 | th {
268 |   border-color: inherit;
269 |   border-style: solid;
270 |   border-width: 0;
271 | }
272 | 
273 | label {
274 |   display: inline-block;
275 | }
276 | 
277 | button {
278 |   border-radius: 0;
279 | }
280 | 
281 | button:focus:not(:focus-visible) {
282 |   outline: 0;
283 | }
284 | 
285 | input,
286 | button,
287 | select,
288 | optgroup,
289 | textarea {
290 |   margin: 0;
291 |   font-family: inherit;
292 |   font-size: inherit;
293 |   line-height: inherit;
294 | }
295 | 
296 | button,
297 | select {
298 |   text-transform: none;
299 | }
300 | 
301 | [role=button] {
302 |   cursor: pointer;
303 | }
304 | 
305 | select {
306 |   word-wrap: normal;
307 | }
308 | select:disabled {
309 |   opacity: 1;
310 | }
311 | 
312 | [list]::-webkit-calendar-picker-indicator {
313 |   display: none;
314 | }
315 | 
316 | button,
317 | [type=button],
318 | [type=reset],
319 | [type=submit] {
320 |   -webkit-appearance: button;
321 | }
322 | button:not(:disabled),
323 | [type=button]:not(:disabled),
324 | [type=reset]:not(:disabled),
325 | [type=submit]:not(:disabled) {
326 |   cursor: pointer;
327 | }
328 | 
329 | ::-moz-focus-inner {
330 |   padding: 0;
331 |   border-style: none;
332 | }
333 | 
334 | textarea {
335 |   resize: vertical;
336 | }
337 | 
338 | fieldset {
339 |   min-width: 0;
340 |   padding: 0;
341 |   margin: 0;
342 |   border: 0;
343 | }
344 | 
345 | legend {
346 |   float: left;
347 |   width: 100%;
348 |   padding: 0;
349 |   margin-bottom: 0.5rem;
350 |   font-size: calc(1.275rem + 0.3vw);
351 |   line-height: inherit;
352 | }
353 | @media (min-width: 1200px) {
354 |   legend {
355 |     font-size: 1.5rem;
356 |   }
357 | }
358 | legend + * {
359 |   clear: left;
360 | }
361 | 
362 | ::-webkit-datetime-edit-fields-wrapper,
363 | ::-webkit-datetime-edit-text,
364 | ::-webkit-datetime-edit-minute,
365 | ::-webkit-datetime-edit-hour-field,
366 | ::-webkit-datetime-edit-day-field,
367 | ::-webkit-datetime-edit-month-field,
368 | ::-webkit-datetime-edit-year-field {
369 |   padding: 0;
370 | }
371 | 
372 | ::-webkit-inner-spin-button {
373 |   height: auto;
374 | }
375 | 
376 | [type=search] {
377 |   outline-offset: -2px;
378 |   -webkit-appearance: textfield;
379 | }
380 | 
381 | /* rtl:raw:
382 | [type="tel"],
383 | [type="url"],
384 | [type="email"],
385 | [type="number"] {
386 |   direction: ltr;
387 | }
388 | */
389 | ::-webkit-search-decoration {
390 |   -webkit-appearance: none;
391 | }
392 | 
393 | ::-webkit-color-swatch-wrapper {
394 |   padding: 0;
395 | }
396 | 
397 | ::file-selector-button {
398 |   font: inherit;
399 | }
400 | 
401 | ::-webkit-file-upload-button {
402 |   font: inherit;
403 |   -webkit-appearance: button;
404 | }
405 | 
406 | output {
407 |   display: inline-block;
408 | }
409 | 
410 | iframe {
411 |   border: 0;
412 | }
413 | 
414 | summary {
415 |   display: list-item;
416 |   cursor: pointer;
417 | }
418 | 
419 | progress {
420 |   vertical-align: baseline;
421 | }
422 | 
423 | [hidden] {
424 |   display: none !important;
425 | }
426 | 
427 | /*# sourceMappingURL=bootstrap-reboot.css.map */


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.min.css:
--------------------------------------------------------------------------------
1 | /*!
2 |  * Bootstrap Reboot v5.1.0 (https://getbootstrap.com/)
3 |  * Copyright 2011-2021 The Bootstrap Authors
4 |  * Copyright 2011-2021 Twitter, Inc.
5 |  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
6 |  * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md)
7 |  */*,::after,::before{box-sizing:border-box}@media (prefers-reduced-motion:no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:var(--bs-body-font-family);font-size:var(--bs-body-font-size);font-weight:var(--bs-body-font-weight);line-height:var(--bs-body-line-height);color:var(--bs-body-color);text-align:var(--bs-body-text-align);background-color:var(--bs-body-bg);-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}hr{margin:1rem 0;color:inherit;background-color:currentColor;border:0;opacity:.25}hr:not([size]){height:1px}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem;font-weight:500;line-height:1.2}h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width:1200px){h1{font-size:2.5rem}}h2{font-size:calc(1.325rem + .9vw)}@media (min-width:1200px){h2{font-size:2rem}}h3{font-size:calc(1.3rem + .6vw)}@media (min-width:1200px){h3{font-size:1.75rem}}h4{font-size:calc(1.275rem + .3vw)}@media (min-width:1200px){h4{font-size:1.5rem}}h5{font-size:1.25rem}h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}abbr[data-bs-original-title],abbr[title]{-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-left:2rem}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}small{font-size:.875em}mark{padding:.2em;background-color:#fcf8e3}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#0d6efd;text-decoration:underline}a:hover{color:#0a58ca}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:1em;direction:ltr;unicode-bidi:bidi-override}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:#d63384;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:.875em;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:1em;font-weight:700}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:#6c757d;text-align:left}th{text-align:inherit;text-align:-webkit-match-parent}tbody,td,tfoot,th,thead,tr{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]::-webkit-calendar-picker-indicator{display:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}textarea{resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{float:left;width:100%;padding:0;margin-bottom:.5rem;font-size:calc(1.275rem + .3vw);line-height:inherit}@media (min-width:1200px){legend{font-size:1.5rem}}legend+*{clear:left}::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-text,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:textfield}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}iframe{border:0}summary{display:list-item;cursor:pointer}progress{vertical-align:baseline}[hidden]{display:none!important}
8 | /*# sourceMappingURL=bootstrap-reboot.min.css.map */


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.rtl.css:
--------------------------------------------------------------------------------
  1 | /*!
  2 |  * Bootstrap Reboot v5.1.0 (https://getbootstrap.com/)
  3 |  * Copyright 2011-2021 The Bootstrap Authors
  4 |  * Copyright 2011-2021 Twitter, Inc.
  5 |  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
  6 |  * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md)
  7 |  */
  8 | *,
  9 | *::before,
 10 | *::after {
 11 |   box-sizing: border-box;
 12 | }
 13 | 
 14 | @media (prefers-reduced-motion: no-preference) {
 15 |   :root {
 16 |     scroll-behavior: smooth;
 17 |   }
 18 | }
 19 | 
 20 | body {
 21 |   margin: 0;
 22 |   font-family: var(--bs-body-font-family);
 23 |   font-size: var(--bs-body-font-size);
 24 |   font-weight: var(--bs-body-font-weight);
 25 |   line-height: var(--bs-body-line-height);
 26 |   color: var(--bs-body-color);
 27 |   text-align: var(--bs-body-text-align);
 28 |   background-color: var(--bs-body-bg);
 29 |   -webkit-text-size-adjust: 100%;
 30 |   -webkit-tap-highlight-color: rgba(0, 0, 0, 0);
 31 | }
 32 | 
 33 | hr {
 34 |   margin: 1rem 0;
 35 |   color: inherit;
 36 |   background-color: currentColor;
 37 |   border: 0;
 38 |   opacity: 0.25;
 39 | }
 40 | 
 41 | hr:not([size]) {
 42 |   height: 1px;
 43 | }
 44 | 
 45 | h6, h5, h4, h3, h2, h1 {
 46 |   margin-top: 0;
 47 |   margin-bottom: 0.5rem;
 48 |   font-weight: 500;
 49 |   line-height: 1.2;
 50 | }
 51 | 
 52 | h1 {
 53 |   font-size: calc(1.375rem + 1.5vw);
 54 | }
 55 | @media (min-width: 1200px) {
 56 |   h1 {
 57 |     font-size: 2.5rem;
 58 |   }
 59 | }
 60 | 
 61 | h2 {
 62 |   font-size: calc(1.325rem + 0.9vw);
 63 | }
 64 | @media (min-width: 1200px) {
 65 |   h2 {
 66 |     font-size: 2rem;
 67 |   }
 68 | }
 69 | 
 70 | h3 {
 71 |   font-size: calc(1.3rem + 0.6vw);
 72 | }
 73 | @media (min-width: 1200px) {
 74 |   h3 {
 75 |     font-size: 1.75rem;
 76 |   }
 77 | }
 78 | 
 79 | h4 {
 80 |   font-size: calc(1.275rem + 0.3vw);
 81 | }
 82 | @media (min-width: 1200px) {
 83 |   h4 {
 84 |     font-size: 1.5rem;
 85 |   }
 86 | }
 87 | 
 88 | h5 {
 89 |   font-size: 1.25rem;
 90 | }
 91 | 
 92 | h6 {
 93 |   font-size: 1rem;
 94 | }
 95 | 
 96 | p {
 97 |   margin-top: 0;
 98 |   margin-bottom: 1rem;
 99 | }
100 | 
101 | abbr[title],
102 | abbr[data-bs-original-title] {
103 |   -webkit-text-decoration: underline dotted;
104 |   text-decoration: underline dotted;
105 |   cursor: help;
106 |   -webkit-text-decoration-skip-ink: none;
107 |   text-decoration-skip-ink: none;
108 | }
109 | 
110 | address {
111 |   margin-bottom: 1rem;
112 |   font-style: normal;
113 |   line-height: inherit;
114 | }
115 | 
116 | ol,
117 | ul {
118 |   padding-right: 2rem;
119 | }
120 | 
121 | ol,
122 | ul,
123 | dl {
124 |   margin-top: 0;
125 |   margin-bottom: 1rem;
126 | }
127 | 
128 | ol ol,
129 | ul ul,
130 | ol ul,
131 | ul ol {
132 |   margin-bottom: 0;
133 | }
134 | 
135 | dt {
136 |   font-weight: 700;
137 | }
138 | 
139 | dd {
140 |   margin-bottom: 0.5rem;
141 |   margin-right: 0;
142 | }
143 | 
144 | blockquote {
145 |   margin: 0 0 1rem;
146 | }
147 | 
148 | b,
149 | strong {
150 |   font-weight: bolder;
151 | }
152 | 
153 | small {
154 |   font-size: 0.875em;
155 | }
156 | 
157 | mark {
158 |   padding: 0.2em;
159 |   background-color: #fcf8e3;
160 | }
161 | 
162 | sub,
163 | sup {
164 |   position: relative;
165 |   font-size: 0.75em;
166 |   line-height: 0;
167 |   vertical-align: baseline;
168 | }
169 | 
170 | sub {
171 |   bottom: -0.25em;
172 | }
173 | 
174 | sup {
175 |   top: -0.5em;
176 | }
177 | 
178 | a {
179 |   color: #0d6efd;
180 |   text-decoration: underline;
181 | }
182 | a:hover {
183 |   color: #0a58ca;
184 | }
185 | 
186 | a:not([href]):not([class]), a:not([href]):not([class]):hover {
187 |   color: inherit;
188 |   text-decoration: none;
189 | }
190 | 
191 | pre,
192 | code,
193 | kbd,
194 | samp {
195 |   font-family: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
196 |   font-size: 1em;
197 |   direction: ltr ;
198 |   unicode-bidi: bidi-override;
199 | }
200 | 
201 | pre {
202 |   display: block;
203 |   margin-top: 0;
204 |   margin-bottom: 1rem;
205 |   overflow: auto;
206 |   font-size: 0.875em;
207 | }
208 | pre code {
209 |   font-size: inherit;
210 |   color: inherit;
211 |   word-break: normal;
212 | }
213 | 
214 | code {
215 |   font-size: 0.875em;
216 |   color: #d63384;
217 |   word-wrap: break-word;
218 | }
219 | a > code {
220 |   color: inherit;
221 | }
222 | 
223 | kbd {
224 |   padding: 0.2rem 0.4rem;
225 |   font-size: 0.875em;
226 |   color: #fff;
227 |   background-color: #212529;
228 |   border-radius: 0.2rem;
229 | }
230 | kbd kbd {
231 |   padding: 0;
232 |   font-size: 1em;
233 |   font-weight: 700;
234 | }
235 | 
236 | figure {
237 |   margin: 0 0 1rem;
238 | }
239 | 
240 | img,
241 | svg {
242 |   vertical-align: middle;
243 | }
244 | 
245 | table {
246 |   caption-side: bottom;
247 |   border-collapse: collapse;
248 | }
249 | 
250 | caption {
251 |   padding-top: 0.5rem;
252 |   padding-bottom: 0.5rem;
253 |   color: #6c757d;
254 |   text-align: right;
255 | }
256 | 
257 | th {
258 |   text-align: inherit;
259 |   text-align: -webkit-match-parent;
260 | }
261 | 
262 | thead,
263 | tbody,
264 | tfoot,
265 | tr,
266 | td,
267 | th {
268 |   border-color: inherit;
269 |   border-style: solid;
270 |   border-width: 0;
271 | }
272 | 
273 | label {
274 |   display: inline-block;
275 | }
276 | 
277 | button {
278 |   border-radius: 0;
279 | }
280 | 
281 | button:focus:not(:focus-visible) {
282 |   outline: 0;
283 | }
284 | 
285 | input,
286 | button,
287 | select,
288 | optgroup,
289 | textarea {
290 |   margin: 0;
291 |   font-family: inherit;
292 |   font-size: inherit;
293 |   line-height: inherit;
294 | }
295 | 
296 | button,
297 | select {
298 |   text-transform: none;
299 | }
300 | 
301 | [role=button] {
302 |   cursor: pointer;
303 | }
304 | 
305 | select {
306 |   word-wrap: normal;
307 | }
308 | select:disabled {
309 |   opacity: 1;
310 | }
311 | 
312 | [list]::-webkit-calendar-picker-indicator {
313 |   display: none;
314 | }
315 | 
316 | button,
317 | [type=button],
318 | [type=reset],
319 | [type=submit] {
320 |   -webkit-appearance: button;
321 | }
322 | button:not(:disabled),
323 | [type=button]:not(:disabled),
324 | [type=reset]:not(:disabled),
325 | [type=submit]:not(:disabled) {
326 |   cursor: pointer;
327 | }
328 | 
329 | ::-moz-focus-inner {
330 |   padding: 0;
331 |   border-style: none;
332 | }
333 | 
334 | textarea {
335 |   resize: vertical;
336 | }
337 | 
338 | fieldset {
339 |   min-width: 0;
340 |   padding: 0;
341 |   margin: 0;
342 |   border: 0;
343 | }
344 | 
345 | legend {
346 |   float: right;
347 |   width: 100%;
348 |   padding: 0;
349 |   margin-bottom: 0.5rem;
350 |   font-size: calc(1.275rem + 0.3vw);
351 |   line-height: inherit;
352 | }
353 | @media (min-width: 1200px) {
354 |   legend {
355 |     font-size: 1.5rem;
356 |   }
357 | }
358 | legend + * {
359 |   clear: right;
360 | }
361 | 
362 | ::-webkit-datetime-edit-fields-wrapper,
363 | ::-webkit-datetime-edit-text,
364 | ::-webkit-datetime-edit-minute,
365 | ::-webkit-datetime-edit-hour-field,
366 | ::-webkit-datetime-edit-day-field,
367 | ::-webkit-datetime-edit-month-field,
368 | ::-webkit-datetime-edit-year-field {
369 |   padding: 0;
370 | }
371 | 
372 | ::-webkit-inner-spin-button {
373 |   height: auto;
374 | }
375 | 
376 | [type=search] {
377 |   outline-offset: -2px;
378 |   -webkit-appearance: textfield;
379 | }
380 | 
381 | [type="tel"],
382 | [type="url"],
383 | [type="email"],
384 | [type="number"] {
385 |   direction: ltr;
386 | }
387 | ::-webkit-search-decoration {
388 |   -webkit-appearance: none;
389 | }
390 | 
391 | ::-webkit-color-swatch-wrapper {
392 |   padding: 0;
393 | }
394 | 
395 | ::file-selector-button {
396 |   font: inherit;
397 | }
398 | 
399 | ::-webkit-file-upload-button {
400 |   font: inherit;
401 |   -webkit-appearance: button;
402 | }
403 | 
404 | output {
405 |   display: inline-block;
406 | }
407 | 
408 | iframe {
409 |   border: 0;
410 | }
411 | 
412 | summary {
413 |   display: list-item;
414 |   cursor: pointer;
415 | }
416 | 
417 | progress {
418 |   vertical-align: baseline;
419 | }
420 | 
421 | [hidden] {
422 |   display: none !important;
423 | }
424 | /*# sourceMappingURL=bootstrap-reboot.rtl.css.map */


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.rtl.min.css:
--------------------------------------------------------------------------------
1 | /*!
2 |  * Bootstrap Reboot v5.1.0 (https://getbootstrap.com/)
3 |  * Copyright 2011-2021 The Bootstrap Authors
4 |  * Copyright 2011-2021 Twitter, Inc.
5 |  * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
6 |  * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md)
7 |  */*,::after,::before{box-sizing:border-box}@media (prefers-reduced-motion:no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:var(--bs-body-font-family);font-size:var(--bs-body-font-size);font-weight:var(--bs-body-font-weight);line-height:var(--bs-body-line-height);color:var(--bs-body-color);text-align:var(--bs-body-text-align);background-color:var(--bs-body-bg);-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:transparent}hr{margin:1rem 0;color:inherit;background-color:currentColor;border:0;opacity:.25}hr:not([size]){height:1px}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem;font-weight:500;line-height:1.2}h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width:1200px){h1{font-size:2.5rem}}h2{font-size:calc(1.325rem + .9vw)}@media (min-width:1200px){h2{font-size:2rem}}h3{font-size:calc(1.3rem + .6vw)}@media (min-width:1200px){h3{font-size:1.75rem}}h4{font-size:calc(1.275rem + .3vw)}@media (min-width:1200px){h4{font-size:1.5rem}}h5{font-size:1.25rem}h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}abbr[data-bs-original-title],abbr[title]{-webkit-text-decoration:underline dotted;text-decoration:underline dotted;cursor:help;-webkit-text-decoration-skip-ink:none;text-decoration-skip-ink:none}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-right:2rem}dl,ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-right:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}small{font-size:.875em}mark{padding:.2em;background-color:#fcf8e3}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#0d6efd;text-decoration:underline}a:hover{color:#0a58ca}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:1em;direction:ltr;unicode-bidi:bidi-override}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:#d63384;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:.875em;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:1em;font-weight:700}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:#6c757d;text-align:right}th{text-align:inherit;text-align:-webkit-match-parent}tbody,td,tfoot,th,thead,tr{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]::-webkit-calendar-picker-indicator{display:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}textarea{resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{float:right;width:100%;padding:0;margin-bottom:.5rem;font-size:calc(1.275rem + .3vw);line-height:inherit}@media (min-width:1200px){legend{font-size:1.5rem}}legend+*{clear:right}::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-text,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:textfield}[type=email],[type=number],[type=tel],[type=url]{direction:ltr}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}iframe{border:0}summary{display:list-item;cursor:pointer}progress{vertical-align:baseline}[hidden]{display:none!important}
8 | /*# sourceMappingURL=bootstrap-reboot.rtl.min.css.map */


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/jquery-validation-unobtrusive/LICENSE.txt:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) .NET Foundation and Contributors
 4 | 
 5 | All rights reserved.
 6 | 
 7 | Permission is hereby granted, free of charge, to any person obtaining a copy
 8 | of this software and associated documentation files (the "Software"), to deal
 9 | in the Software without restriction, including without limitation the rights
10 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 | copies of the Software, and to permit persons to whom the Software is
12 | furnished to do so, subject to the following conditions:
13 | 
14 | The above copyright notice and this permission notice shall be included in all
15 | copies or substantial portions of the Software.
16 | 
17 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 | SOFTWARE.
24 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js:
--------------------------------------------------------------------------------
  1 | /**
  2 |  * @license
  3 |  * Unobtrusive validation support library for jQuery and jQuery Validate
  4 |  * Copyright (c) .NET Foundation. All rights reserved.
  5 |  * Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
  6 |  * @version v4.0.0
  7 |  */
  8 | 
  9 | /*jslint white: true, browser: true, onevar: true, undef: true, nomen: true, eqeqeq: true, plusplus: true, bitwise: true, regexp: true, newcap: true, immed: true, strict: false */
 10 | /*global document: false, jQuery: false */
 11 | 
 12 | (function (factory) {
 13 |     if (typeof define === 'function' && define.amd) {
 14 |         // AMD. Register as an anonymous module.
 15 |         define("jquery.validate.unobtrusive", ['jquery-validation'], factory);
 16 |     } else if (typeof module === 'object' && module.exports) {
 17 |         // CommonJS-like environments that support module.exports     
 18 |         module.exports = factory(require('jquery-validation'));
 19 |     } else {
 20 |         // Browser global
 21 |         jQuery.validator.unobtrusive = factory(jQuery);
 22 |     }
 23 | }(function ($) {
 24 |     var $jQval = $.validator,
 25 |         adapters,
 26 |         data_validation = "unobtrusiveValidation";
 27 | 
 28 |     function setValidationValues(options, ruleName, value) {
 29 |         options.rules[ruleName] = value;
 30 |         if (options.message) {
 31 |             options.messages[ruleName] = options.message;
 32 |         }
 33 |     }
 34 | 
 35 |     function splitAndTrim(value) {
 36 |         return value.replace(/^\s+|\s+$/g, "").split(/\s*,\s*/g);
 37 |     }
 38 | 
 39 |     function escapeAttributeValue(value) {
 40 |         // As mentioned on http://api.jquery.com/category/selectors/
 41 |         return value.replace(/([!"#$%&'()*+,./:;<=>?@\[\\\]^`{|}~])/g, "\\$1");
 42 |     }
 43 | 
 44 |     function getModelPrefix(fieldName) {
 45 |         return fieldName.substr(0, fieldName.lastIndexOf(".") + 1);
 46 |     }
 47 | 
 48 |     function appendModelPrefix(value, prefix) {
 49 |         if (value.indexOf("*.") === 0) {
 50 |             value = value.replace("*.", prefix);
 51 |         }
 52 |         return value;
 53 |     }
 54 | 
 55 |     function onError(error, inputElement) {  // 'this' is the form element
 56 |         var container = $(this).find("[data-valmsg-for='" + escapeAttributeValue(inputElement[0].name) + "']"),
 57 |             replaceAttrValue = container.attr("data-valmsg-replace"),
 58 |             replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) !== false : null;
 59 | 
 60 |         container.removeClass("field-validation-valid").addClass("field-validation-error");
 61 |         error.data("unobtrusiveContainer", container);
 62 | 
 63 |         if (replace) {
 64 |             container.empty();
 65 |             error.removeClass("input-validation-error").appendTo(container);
 66 |         }
 67 |         else {
 68 |             error.hide();
 69 |         }
 70 |     }
 71 | 
 72 |     function onErrors(event, validator) {  // 'this' is the form element
 73 |         var container = $(this).find("[data-valmsg-summary=true]"),
 74 |             list = container.find("ul");
 75 | 
 76 |         if (list && list.length && validator.errorList.length) {
 77 |             list.empty();
 78 |             container.addClass("validation-summary-errors").removeClass("validation-summary-valid");
 79 | 
 80 |             $.each(validator.errorList, function () {
 81 |                 $("<li />").html(this.message).appendTo(list);
 82 |             });
 83 |         }
 84 |     }
 85 | 
 86 |     function onSuccess(error) {  // 'this' is the form element
 87 |         var container = error.data("unobtrusiveContainer");
 88 | 
 89 |         if (container) {
 90 |             var replaceAttrValue = container.attr("data-valmsg-replace"),
 91 |                 replace = replaceAttrValue ? $.parseJSON(replaceAttrValue) : null;
 92 | 
 93 |             container.addClass("field-validation-valid").removeClass("field-validation-error");
 94 |             error.removeData("unobtrusiveContainer");
 95 | 
 96 |             if (replace) {
 97 |                 container.empty();
 98 |             }
 99 |         }
100 |     }
101 | 
102 |     function onReset(event) {  // 'this' is the form element
103 |         var $form = $(this),
104 |             key = '__jquery_unobtrusive_validation_form_reset';
105 |         if ($form.data(key)) {
106 |             return;
107 |         }
108 |         // Set a flag that indicates we're currently resetting the form.
109 |         $form.data(key, true);
110 |         try {
111 |             $form.data("validator").resetForm();
112 |         } finally {
113 |             $form.removeData(key);
114 |         }
115 | 
116 |         $form.find(".validation-summary-errors")
117 |             .addClass("validation-summary-valid")
118 |             .removeClass("validation-summary-errors");
119 |         $form.find(".field-validation-error")
120 |             .addClass("field-validation-valid")
121 |             .removeClass("field-validation-error")
122 |             .removeData("unobtrusiveContainer")
123 |             .find(">*")  // If we were using valmsg-replace, get the underlying error
124 |             .removeData("unobtrusiveContainer");
125 |     }
126 | 
127 |     function validationInfo(form) {
128 |         var $form = $(form),
129 |             result = $form.data(data_validation),
130 |             onResetProxy = $.proxy(onReset, form),
131 |             defaultOptions = $jQval.unobtrusive.options || {},
132 |             execInContext = function (name, args) {
133 |                 var func = defaultOptions[name];
134 |                 func && $.isFunction(func) && func.apply(form, args);
135 |             };
136 | 
137 |         if (!result) {
138 |             result = {
139 |                 options: {  // options structure passed to jQuery Validate's validate() method
140 |                     errorClass: defaultOptions.errorClass || "input-validation-error",
141 |                     errorElement: defaultOptions.errorElement || "span",
142 |                     errorPlacement: function () {
143 |                         onError.apply(form, arguments);
144 |                         execInContext("errorPlacement", arguments);
145 |                     },
146 |                     invalidHandler: function () {
147 |                         onErrors.apply(form, arguments);
148 |                         execInContext("invalidHandler", arguments);
149 |                     },
150 |                     messages: {},
151 |                     rules: {},
152 |                     success: function () {
153 |                         onSuccess.apply(form, arguments);
154 |                         execInContext("success", arguments);
155 |                     }
156 |                 },
157 |                 attachValidation: function () {
158 |                     $form
159 |                         .off("reset." + data_validation, onResetProxy)
160 |                         .on("reset." + data_validation, onResetProxy)
161 |                         .validate(this.options);
162 |                 },
163 |                 validate: function () {  // a validation function that is called by unobtrusive Ajax
164 |                     $form.validate();
165 |                     return $form.valid();
166 |                 }
167 |             };
168 |             $form.data(data_validation, result);
169 |         }
170 | 
171 |         return result;
172 |     }
173 | 
174 |     $jQval.unobtrusive = {
175 |         adapters: [],
176 | 
177 |         parseElement: function (element, skipAttach) {
178 |             /// <summary>
179 |             /// Parses a single HTML element for unobtrusive validation attributes.
180 |             /// </summary>
181 |             /// <param name="element" domElement="true">The HTML element to be parsed.</param>
182 |             /// <param name="skipAttach" type="Boolean">[Optional] true to skip attaching the
183 |             /// validation to the form. If parsing just this single element, you should specify true.
184 |             /// If parsing several elements, you should specify false, and manually attach the validation
185 |             /// to the form when you are finished. The default is false.</param>
186 |             var $element = $(element),
187 |                 form = $element.parents("form")[0],
188 |                 valInfo, rules, messages;
189 | 
190 |             if (!form) {  // Cannot do client-side validation without a form
191 |                 return;
192 |             }
193 | 
194 |             valInfo = validationInfo(form);
195 |             valInfo.options.rules[element.name] = rules = {};
196 |             valInfo.options.messages[element.name] = messages = {};
197 | 
198 |             $.each(this.adapters, function () {
199 |                 var prefix = "data-val-" + this.name,
200 |                     message = $element.attr(prefix),
201 |                     paramValues = {};
202 | 
203 |                 if (message !== undefined) {  // Compare against undefined, because an empty message is legal (and falsy)
204 |                     prefix += "-";
205 | 
206 |                     $.each(this.params, function () {
207 |                         paramValues[this] = $element.attr(prefix + this);
208 |                     });
209 | 
210 |                     this.adapt({
211 |                         element: element,
212 |                         form: form,
213 |                         message: message,
214 |                         params: paramValues,
215 |                         rules: rules,
216 |                         messages: messages
217 |                     });
218 |                 }
219 |             });
220 | 
221 |             $.extend(rules, { "__dummy__": true });
222 | 
223 |             if (!skipAttach) {
224 |                 valInfo.attachValidation();
225 |             }
226 |         },
227 | 
228 |         parse: function (selector) {
229 |             /// <summary>
230 |             /// Parses all the HTML elements in the specified selector. It looks for input elements decorated
231 |             /// with the [data-val=true] attribute value and enables validation according to the data-val-*
232 |             /// attribute values.
233 |             /// </summary>
234 |             /// <param name="selector" type="String">Any valid jQuery selector.</param>
235 | 
236 |             // $forms includes all forms in selector's DOM hierarchy (parent, children and self) that have at least one
237 |             // element with data-val=true
238 |             var $selector = $(selector),
239 |                 $forms = $selector.parents()
240 |                     .addBack()
241 |                     .filter("form")
242 |                     .add($selector.find("form"))
243 |                     .has("[data-val=true]");
244 | 
245 |             $selector.find("[data-val=true]").each(function () {
246 |                 $jQval.unobtrusive.parseElement(this, true);
247 |             });
248 | 
249 |             $forms.each(function () {
250 |                 var info = validationInfo(this);
251 |                 if (info) {
252 |                     info.attachValidation();
253 |                 }
254 |             });
255 |         }
256 |     };
257 | 
258 |     adapters = $jQval.unobtrusive.adapters;
259 | 
260 |     adapters.add = function (adapterName, params, fn) {
261 |         /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation.</summary>
262 |         /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
263 |         /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
264 |         /// <param name="params" type="Array" optional="true">[Optional] An array of parameter names (strings) that will
265 |         /// be extracted from the data-val-nnnn-mmmm HTML attributes (where nnnn is the adapter name, and
266 |         /// mmmm is the parameter name).</param>
267 |         /// <param name="fn" type="Function">The function to call, which adapts the values from the HTML
268 |         /// attributes into jQuery Validate rules and/or messages.</param>
269 |         /// <returns type="jQuery.validator.unobtrusive.adapters" />
270 |         if (!fn) {  // Called with no params, just a function
271 |             fn = params;
272 |             params = [];
273 |         }
274 |         this.push({ name: adapterName, params: params, adapt: fn });
275 |         return this;
276 |     };
277 | 
278 |     adapters.addBool = function (adapterName, ruleName) {
279 |         /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
280 |         /// the jQuery Validate validation rule has no parameter values.</summary>
281 |         /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
282 |         /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
283 |         /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value
284 |         /// of adapterName will be used instead.</param>
285 |         /// <returns type="jQuery.validator.unobtrusive.adapters" />
286 |         return this.add(adapterName, function (options) {
287 |             setValidationValues(options, ruleName || adapterName, true);
288 |         });
289 |     };
290 | 
291 |     adapters.addMinMax = function (adapterName, minRuleName, maxRuleName, minMaxRuleName, minAttribute, maxAttribute) {
292 |         /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
293 |         /// the jQuery Validate validation has three potential rules (one for min-only, one for max-only, and
294 |         /// one for min-and-max). The HTML parameters are expected to be named -min and -max.</summary>
295 |         /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
296 |         /// in the data-val-nnnn HTML attribute (where nnnn is the adapter name).</param>
297 |         /// <param name="minRuleName" type="String">The name of the jQuery Validate rule to be used when you only
298 |         /// have a minimum value.</param>
299 |         /// <param name="maxRuleName" type="String">The name of the jQuery Validate rule to be used when you only
300 |         /// have a maximum value.</param>
301 |         /// <param name="minMaxRuleName" type="String">The name of the jQuery Validate rule to be used when you
302 |         /// have both a minimum and maximum value.</param>
303 |         /// <param name="minAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that
304 |         /// contains the minimum value. The default is "min".</param>
305 |         /// <param name="maxAttribute" type="String" optional="true">[Optional] The name of the HTML attribute that
306 |         /// contains the maximum value. The default is "max".</param>
307 |         /// <returns type="jQuery.validator.unobtrusive.adapters" />
308 |         return this.add(adapterName, [minAttribute || "min", maxAttribute || "max"], function (options) {
309 |             var min = options.params.min,
310 |                 max = options.params.max;
311 | 
312 |             if (min && max) {
313 |                 setValidationValues(options, minMaxRuleName, [min, max]);
314 |             }
315 |             else if (min) {
316 |                 setValidationValues(options, minRuleName, min);
317 |             }
318 |             else if (max) {
319 |                 setValidationValues(options, maxRuleName, max);
320 |             }
321 |         });
322 |     };
323 | 
324 |     adapters.addSingleVal = function (adapterName, attribute, ruleName) {
325 |         /// <summary>Adds a new adapter to convert unobtrusive HTML into a jQuery Validate validation, where
326 |         /// the jQuery Validate validation rule has a single value.</summary>
327 |         /// <param name="adapterName" type="String">The name of the adapter to be added. This matches the name used
328 |         /// in the data-val-nnnn HTML attribute(where nnnn is the adapter name).</param>
329 |         /// <param name="attribute" type="String">[Optional] The name of the HTML attribute that contains the value.
330 |         /// The default is "val".</param>
331 |         /// <param name="ruleName" type="String" optional="true">[Optional] The name of the jQuery Validate rule. If not provided, the value
332 |         /// of adapterName will be used instead.</param>
333 |         /// <returns type="jQuery.validator.unobtrusive.adapters" />
334 |         return this.add(adapterName, [attribute || "val"], function (options) {
335 |             setValidationValues(options, ruleName || adapterName, options.params[attribute]);
336 |         });
337 |     };
338 | 
339 |     $jQval.addMethod("__dummy__", function (value, element, params) {
340 |         return true;
341 |     });
342 | 
343 |     $jQval.addMethod("regex", function (value, element, params) {
344 |         var match;
345 |         if (this.optional(element)) {
346 |             return true;
347 |         }
348 | 
349 |         match = new RegExp(params).exec(value);
350 |         return (match && (match.index === 0) && (match[0].length === value.length));
351 |     });
352 | 
353 |     $jQval.addMethod("nonalphamin", function (value, element, nonalphamin) {
354 |         var match;
355 |         if (nonalphamin) {
356 |             match = value.match(/\W/g);
357 |             match = match && match.length >= nonalphamin;
358 |         }
359 |         return match;
360 |     });
361 | 
362 |     if ($jQval.methods.extension) {
363 |         adapters.addSingleVal("accept", "mimtype");
364 |         adapters.addSingleVal("extension", "extension");
365 |     } else {
366 |         // for backward compatibility, when the 'extension' validation method does not exist, such as with versions
367 |         // of JQuery Validation plugin prior to 1.10, we should use the 'accept' method for
368 |         // validating the extension, and ignore mime-type validations as they are not supported.
369 |         adapters.addSingleVal("extension", "extension", "accept");
370 |     }
371 | 
372 |     adapters.addSingleVal("regex", "pattern");
373 |     adapters.addBool("creditcard").addBool("date").addBool("digits").addBool("email").addBool("number").addBool("url");
374 |     adapters.addMinMax("length", "minlength", "maxlength", "rangelength").addMinMax("range", "min", "max", "range");
375 |     adapters.addMinMax("minlength", "minlength").addMinMax("maxlength", "minlength", "maxlength");
376 |     adapters.add("equalto", ["other"], function (options) {
377 |         var prefix = getModelPrefix(options.element.name),
378 |             other = options.params.other,
379 |             fullOtherName = appendModelPrefix(other, prefix),
380 |             element = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(fullOtherName) + "']")[0];
381 | 
382 |         setValidationValues(options, "equalTo", element);
383 |     });
384 |     adapters.add("required", function (options) {
385 |         // jQuery Validate equates "required" with "mandatory" for checkbox elements
386 |         if (options.element.tagName.toUpperCase() !== "INPUT" || options.element.type.toUpperCase() !== "CHECKBOX") {
387 |             setValidationValues(options, "required", true);
388 |         }
389 |     });
390 |     adapters.add("remote", ["url", "type", "additionalfields"], function (options) {
391 |         var value = {
392 |             url: options.params.url,
393 |             type: options.params.type || "GET",
394 |             data: {}
395 |         },
396 |             prefix = getModelPrefix(options.element.name);
397 | 
398 |         $.each(splitAndTrim(options.params.additionalfields || options.element.name), function (i, fieldName) {
399 |             var paramName = appendModelPrefix(fieldName, prefix);
400 |             value.data[paramName] = function () {
401 |                 var field = $(options.form).find(":input").filter("[name='" + escapeAttributeValue(paramName) + "']");
402 |                 // For checkboxes and radio buttons, only pick up values from checked fields.
403 |                 if (field.is(":checkbox")) {
404 |                     return field.filter(":checked").val() || field.filter(":hidden").val() || '';
405 |                 }
406 |                 else if (field.is(":radio")) {
407 |                     return field.filter(":checked").val() || '';
408 |                 }
409 |                 return field.val();
410 |             };
411 |         });
412 | 
413 |         setValidationValues(options, "remote", value);
414 |     });
415 |     adapters.add("password", ["min", "nonalphamin", "regex"], function (options) {
416 |         if (options.params.min) {
417 |             setValidationValues(options, "minlength", options.params.min);
418 |         }
419 |         if (options.params.nonalphamin) {
420 |             setValidationValues(options, "nonalphamin", options.params.nonalphamin);
421 |         }
422 |         if (options.params.regex) {
423 |             setValidationValues(options, "regex", options.params.regex);
424 |         }
425 |     });
426 |     adapters.add("fileextensions", ["extensions"], function (options) {
427 |         setValidationValues(options, "extension", options.params.extensions);
428 |     });
429 | 
430 |     $(function () {
431 |         $jQval.unobtrusive.parse(document);
432 |     });
433 | 
434 |     return $jQval.unobtrusive;
435 | }));
436 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js:
--------------------------------------------------------------------------------
1 | /**
2 |  * @license
3 |  * Unobtrusive validation support library for jQuery and jQuery Validate
4 |  * Copyright (c) .NET Foundation. All rights reserved.
5 |  * Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
6 |  * @version v4.0.0
7 |  */
8 | !function(a){"function"==typeof define&&define.amd?define("jquery.validate.unobtrusive",["jquery-validation"],a):"object"==typeof module&&module.exports?module.exports=a(require("jquery-validation")):jQuery.validator.unobtrusive=a(jQuery)}(function(s){var a,o=s.validator,d="unobtrusiveValidation";function l(a,e,n){a.rules[e]=n,a.message&&(a.messages[e]=a.message)}function u(a){return a.replace(/([!"#$%&'()*+,./:;<=>?@\[\\\]^`{|}~])/g,"\\$1")}function n(a){return a.substr(0,a.lastIndexOf(".")+1)}function m(a,e){return a=0===a.indexOf("*.")?a.replace("*.",e):a}function f(a){var e=s(this),n="__jquery_unobtrusive_validation_form_reset";if(!e.data(n)){e.data(n,!0);try{e.data("validator").resetForm()}finally{e.removeData(n)}e.find(".validation-summary-errors").addClass("validation-summary-valid").removeClass("validation-summary-errors"),e.find(".field-validation-error").addClass("field-validation-valid").removeClass("field-validation-error").removeData("unobtrusiveContainer").find(">*").removeData("unobtrusiveContainer")}}function p(n){function a(a,e){(a=r[a])&&s.isFunction(a)&&a.apply(n,e)}var e=s(n),t=e.data(d),i=s.proxy(f,n),r=o.unobtrusive.options||{};return t||(t={options:{errorClass:r.errorClass||"input-validation-error",errorElement:r.errorElement||"span",errorPlacement:function(){!function(a,e){var e=s(this).find("[data-valmsg-for='"+u(e[0].name)+"']"),n=(n=e.attr("data-valmsg-replace"))?!1!==s.parseJSON(n):null;e.removeClass("field-validation-valid").addClass("field-validation-error"),a.data("unobtrusiveContainer",e),n?(e.empty(),a.removeClass("input-validation-error").appendTo(e)):a.hide()}.apply(n,arguments),a("errorPlacement",arguments)},invalidHandler:function(){!function(a,e){var n=s(this).find("[data-valmsg-summary=true]"),t=n.find("ul");t&&t.length&&e.errorList.length&&(t.empty(),n.addClass("validation-summary-errors").removeClass("validation-summary-valid"),s.each(e.errorList,function(){s("<li />").html(this.message).appendTo(t)}))}.apply(n,arguments),a("invalidHandler",arguments)},messages:{},rules:{},success:function(){!function(a){var e,n=a.data("unobtrusiveContainer");n&&(e=(e=n.attr("data-valmsg-replace"))?s.parseJSON(e):null,n.addClass("field-validation-valid").removeClass("field-validation-error"),a.removeData("unobtrusiveContainer"),e&&n.empty())}.apply(n,arguments),a("success",arguments)}},attachValidation:function(){e.off("reset."+d,i).on("reset."+d,i).validate(this.options)},validate:function(){return e.validate(),e.valid()}},e.data(d,t)),t}return o.unobtrusive={adapters:[],parseElement:function(t,a){var e,i,r,o=s(t),d=o.parents("form")[0];d&&((e=p(d)).options.rules[t.name]=i={},e.options.messages[t.name]=r={},s.each(this.adapters,function(){var a="data-val-"+this.name,e=o.attr(a),n={};void 0!==e&&(a+="-",s.each(this.params,function(){n[this]=o.attr(a+this)}),this.adapt({element:t,form:d,message:e,params:n,rules:i,messages:r}))}),s.extend(i,{__dummy__:!0}),a||e.attachValidation())},parse:function(a){var a=s(a),e=a.parents().addBack().filter("form").add(a.find("form")).has("[data-val=true]");a.find("[data-val=true]").each(function(){o.unobtrusive.parseElement(this,!0)}),e.each(function(){var a=p(this);a&&a.attachValidation()})}},(a=o.unobtrusive.adapters).add=function(a,e,n){return n||(n=e,e=[]),this.push({name:a,params:e,adapt:n}),this},a.addBool=function(e,n){return this.add(e,function(a){l(a,n||e,!0)})},a.addMinMax=function(a,t,i,r,e,n){return this.add(a,[e||"min",n||"max"],function(a){var e=a.params.min,n=a.params.max;e&&n?l(a,r,[e,n]):e?l(a,t,e):n&&l(a,i,n)})},a.addSingleVal=function(e,n,t){return this.add(e,[n||"val"],function(a){l(a,t||e,a.params[n])})},o.addMethod("__dummy__",function(a,e,n){return!0}),o.addMethod("regex",function(a,e,n){return!!this.optional(e)||(e=new RegExp(n).exec(a))&&0===e.index&&e[0].length===a.length}),o.addMethod("nonalphamin",function(a,e,n){var t;return t=n?(t=a.match(/\W/g))&&t.length>=n:t}),o.methods.extension?(a.addSingleVal("accept","mimtype"),a.addSingleVal("extension","extension")):a.addSingleVal("extension","extension","accept"),a.addSingleVal("regex","pattern"),a.addBool("creditcard").addBool("date").addBool("digits").addBool("email").addBool("number").addBool("url"),a.addMinMax("length","minlength","maxlength","rangelength").addMinMax("range","min","max","range"),a.addMinMax("minlength","minlength").addMinMax("maxlength","minlength","maxlength"),a.add("equalto",["other"],function(a){var e=n(a.element.name),e=m(a.params.other,e);l(a,"equalTo",s(a.form).find(":input").filter("[name='"+u(e)+"']")[0])}),a.add("required",function(a){"INPUT"===a.element.tagName.toUpperCase()&&"CHECKBOX"===a.element.type.toUpperCase()||l(a,"required",!0)}),a.add("remote",["url","type","additionalfields"],function(t){var i={url:t.params.url,type:t.params.type||"GET",data:{}},r=n(t.element.name);s.each((t.params.additionalfields||t.element.name).replace(/^\s+|\s+$/g,"").split(/\s*,\s*/g),function(a,e){var n=m(e,r);i.data[n]=function(){var a=s(t.form).find(":input").filter("[name='"+u(n)+"']");return a.is(":checkbox")?a.filter(":checked").val()||a.filter(":hidden").val()||"":a.is(":radio")?a.filter(":checked").val()||"":a.val()}}),l(t,"remote",i)}),a.add("password",["min","nonalphamin","regex"],function(a){a.params.min&&l(a,"minlength",a.params.min),a.params.nonalphamin&&l(a,"nonalphamin",a.params.nonalphamin),a.params.regex&&l(a,"regex",a.params.regex)}),a.add("fileextensions",["extensions"],function(a){l(a,"extension",a.params.extensions)}),s(function(){o.unobtrusive.parse(document)}),o.unobtrusive});


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/jquery-validation/LICENSE.md:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | =====================
 3 | 
 4 | Copyright Jörn Zaefferer
 5 | 
 6 | Permission is hereby granted, free of charge, to any person obtaining a copy
 7 | of this software and associated documentation files (the "Software"), to deal
 8 | in the Software without restriction, including without limitation the rights
 9 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | copies of the Software, and to permit persons to whom the Software is
11 | furnished to do so, subject to the following conditions:
12 | 
13 | The above copyright notice and this permission notice shall be included in
14 | all copies or substantial portions of the Software.
15 | 
16 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 | THE SOFTWARE.
23 | 


--------------------------------------------------------------------------------
/samples/ExampleMvcRazorPagesApp/wwwroot/lib/jquery/LICENSE.txt:
--------------------------------------------------------------------------------
 1 | 
 2 | Copyright OpenJS Foundation and other contributors, https://openjsf.org/
 3 | 
 4 | Permission is hereby granted, free of charge, to any person obtaining
 5 | a copy of this software and associated documentation files (the
 6 | "Software"), to deal in the Software without restriction, including
 7 | without limitation the rights to use, copy, modify, merge, publish,
 8 | distribute, sublicense, and/or sell copies of the Software, and to
 9 | permit persons to whom the Software is furnished to do so, subject to
10 | the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be
13 | included in all copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 | NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
19 | LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
20 | OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
21 | WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


--------------------------------------------------------------------------------
/samples/SmartComponentsSamples.sln:
--------------------------------------------------------------------------------
 1 | 
 2 | Microsoft Visual Studio Solution File, Format Version 12.00
 3 | # Visual Studio Version 17
 4 | VisualStudioVersion = 17.0.31903.59
 5 | MinimumVisualStudioVersion = 10.0.40219.1
 6 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ExampleBlazorApp", "ExampleBlazorApp\ExampleBlazorApp.csproj", "{9D7BCB28-5916-4BAB-8B0F-368BF21D54B3}"
 7 | EndProject
 8 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ExampleMvcRazorPagesApp", "ExampleMvcRazorPagesApp\ExampleMvcRazorPagesApp.csproj", "{BDCE3A8F-CB8A-4762-81AF-4B0D530CFE0E}"
 9 | EndProject
10 | Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{8882D943-AEFA-4DF1-8F06-69E5AB12E8A4}"
11 | 	ProjectSection(SolutionItems) = preProject
12 | 		..\RepoSharedConfig.json = ..\RepoSharedConfig.json
13 | 	EndProjectSection
14 | EndProject
15 | Global
16 | 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
17 | 		Debug|Any CPU = Debug|Any CPU
18 | 		Release|Any CPU = Release|Any CPU
19 | 	EndGlobalSection
20 | 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
21 | 		{9D7BCB28-5916-4BAB-8B0F-368BF21D54B3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
22 | 		{9D7BCB28-5916-4BAB-8B0F-368BF21D54B3}.Debug|Any CPU.Build.0 = Debug|Any CPU
23 | 		{9D7BCB28-5916-4BAB-8B0F-368BF21D54B3}.Release|Any CPU.ActiveCfg = Release|Any CPU
24 | 		{9D7BCB28-5916-4BAB-8B0F-368BF21D54B3}.Release|Any CPU.Build.0 = Release|Any CPU
25 | 		{BDCE3A8F-CB8A-4762-81AF-4B0D530CFE0E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
26 | 		{BDCE3A8F-CB8A-4762-81AF-4B0D530CFE0E}.Debug|Any CPU.Build.0 = Debug|Any CPU
27 | 		{BDCE3A8F-CB8A-4762-81AF-4B0D530CFE0E}.Release|Any CPU.ActiveCfg = Release|Any CPU
28 | 		{BDCE3A8F-CB8A-4762-81AF-4B0D530CFE0E}.Release|Any CPU.Build.0 = Release|Any CPU
29 | 	EndGlobalSection
30 | 	GlobalSection(SolutionProperties) = preSolution
31 | 		HideSolutionNode = FALSE
32 | 	EndGlobalSection
33 | EndGlobal
34 | 


--------------------------------------------------------------------------------
/samples/shared/RepoSharedConfigUtil.cs:
--------------------------------------------------------------------------------
 1 | // Licensed to the .NET Foundation under one or more agreements.
 2 | // The .NET Foundation licenses this file to you under the MIT license.
 3 | 
 4 | using System.Reflection;
 5 | using SmartComponents.Inference.OpenAI;
 6 | 
 7 | public static class RepoSharedConfigUtil
 8 | {
 9 |     public static void AddRepoSharedConfig(this IConfigurationBuilder configuration)
10 |     {
11 |         // This is only used within this repo to simplify sharing config
12 |         // across multiple projects. For real usage, just add the required
13 |         // config values to your appsettings.json file.
14 | 
15 |         var envVarPath = Environment.GetEnvironmentVariable("SMARTCOMPONENTS_REPO_CONFIG_FILE_PATH");
16 |         if (!string.IsNullOrEmpty(envVarPath))
17 |         {
18 |             configuration.AddJsonFile(envVarPath);
19 |             return;
20 |         }
21 | 
22 |         var dir = Path.GetDirectoryName(Assembly.GetEntryAssembly()!.Location)!;
23 |         while (true)
24 |         {
25 |             var path = Path.Combine(dir, "RepoSharedConfig.json");
26 |             if (File.Exists(path))
27 |             {
28 |                 configuration.AddJsonFile(path);
29 |                 return;
30 |             }
31 | 
32 |             var parent = Directory.GetParent(dir);
33 |             if (parent == null)
34 |             {
35 |                 throw new FileNotFoundException("Could not find RepoSharedConfig.json");
36 |             }
37 | 
38 |             dir = parent.FullName;
39 |         }
40 |     }
41 | 
42 |     public static Exception? GetConfigError(IConfiguration config)
43 |     {
44 |         var apiConfigType = typeof(OpenAIInferenceBackend).Assembly
45 |             .GetType("SmartComponents.Inference.OpenAI.ApiConfig", true)!;
46 |         try
47 |         {
48 |             _ = Activator.CreateInstance(apiConfigType, config);
49 |         }
50 |         catch (TargetInvocationException ex) when (ex.InnerException is not null)
51 |         {
52 |             return ex.InnerException;
53 |         }
54 |         catch (Exception ex)
55 |         {
56 |             return ex;
57 |         }
58 | 
59 |         return null;
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/samples/shared/TailwindIntegration.targets:
--------------------------------------------------------------------------------
 1 | <Project>
 2 |     <PropertyGroup>
 3 |         <TailwindToolsVersion Condition="'$(TailwindToolsVersion)' == ''">3.4.1</TailwindToolsVersion>
 4 |     </PropertyGroup>
 5 | 
 6 |     <Target Name="TailwindBuild" BeforeTargets="CoreBuild" DependsOnTargets="GetTailwindInputs; AcquireTailwindTooling"
 7 |             Inputs="@(TailwindFileInputs)" Outputs="$(TailwindCssOutput)">
 8 |         <Exec Command="&quot;$(TailwindExePath)&quot; -i $(TailwindCssInput) -o $(TailwindCssOutput)" />
 9 |         <Touch Files="$(TailwindCssOutput)" />
10 |         <ItemGroup>
11 |             <FileWrites Include="$(TailwindCssOutput)" />
12 |         </ItemGroup>
13 |     </Target>
14 | 
15 |     <Target Name="AcquireTailwindTooling" DependsOnTargets="GetTailwindInputs" Condition="!Exists('$(TailwindExePath)')">
16 |         <DownloadFile SourceUrl="https://github.com/tailwindlabs/tailwindcss/releases/download/v$(TailwindToolsVersion)/$(TailwindExeName)" DestinationFolder="$(TailwindExeDir)" />
17 |         <Exec Condition="!$([MSBuild]::IsOSPlatform('Windows'))" Command="chmod +x '$(TailwindExePath)'" />
18 |     </Target>
19 |     
20 |     <Target Name="GetTailwindInputs">
21 |         <PropertyGroup>
22 |             <TailwindExeName Condition="$([MSBuild]::IsOSPlatform('Windows'))">tailwindcss-windows-x64.exe</TailwindExeName>
23 |             <TailwindExeName Condition="$([MSBuild]::IsOSPlatform('Linux'))">tailwindcss-linux-x64</TailwindExeName>
24 |             <TailwindExeName Condition="$([MSBuild]::IsOSPlatform('OSX'))">tailwindcss-macos-x64</TailwindExeName>
25 |             <TailwindExeDir>$([System.IO.Path]::Combine($(MSBuildThisFileDirectory), ".tailwind", $(TailwindToolsVersion)))</TailwindExeDir>
26 |             <TailwindExePath>$([System.IO.Path]::Combine($(TailwindExeDir), $(TailwindExeName)))</TailwindExePath>
27 |         </PropertyGroup>
28 |         <ItemGroup>
29 |             <TailwindFileInputs Include="**\*.css;**\*.razor;**\*.cshtml" />
30 |             <UpToDateCheckInput Include="@(TailwindFileInputs)" />
31 |         </ItemGroup>
32 |     </Target>
33 | </Project>
34 | 


--------------------------------------------------------------------------------