@massimo-cassandro/minimo 1.20.11 → 1.20.12

package/dev-tools/starter-kit/templates/package-tpl.json

@@ -27,7 +27,7 @@
     "launchChrome": "open -n -a 'Google Chrome' --args --profile-directory='Profile 3'",
     "python server": "python3 -m http.server 8000 # --directory __dirname__ # 8000 = default port",
     "php server": "php -S localhost:8000 # -t root_dir/",
-    "symfony server": "symfony serve -d --port=8100 --listen-ip=0.0.0.0 # symfony server:stop # http://192.168.1.135:8100",
+    "symfony server": "symfony serve --port=8100 --listen-ip=0.0.0.0 # symfony server:stop # http://192.168.1.135:8100 # -d (deamon): rimane aperto anche dopo la chiusra del terminale",
     "node server": "node serve # richiede ‘npm i serve’",
     "build tokens": "npx buildTokens --config ./path/to/tokens-config.mjs",
     "check unresolved props": "npx checkUnresolvedProps --config ./path/to/tokens-config.mjs"

package/dev-tools/starter-kit/webpack-modules/css-rules.mjs

@@ -174,6 +174,11 @@ function css_loaders({
           sassOptions: {
             quietDeps: true,
             silenceDeprecations: [ 'legacy-js-api', 'mixed-decls', 'color-functions', 'global-builtin', 'import' ],
+            // charset:false evita che sass anteponga @charset/BOM all'output di ogni
+            // singolo modulo quando la sorgente contiene caratteri non-ASCII (anche solo
+            // in un commento): con più moduli concatenati da MiniCssExtractPlugin, quel
+            // BOM finirebbe a metà del bundle finale invece che in testa al file.
+            charset: false,
           }
         }
       } ]

package/dev-tools/starter-kit/webpack.config.mjs

@@ -445,7 +445,7 @@ const config = {
       ]
     ),
 
-
+    // TODO author dinamico https://docs.npmjs.com/cli/v11/configuring-npm/package-json#people-fields-author-contributors
     // =>> plugins: BannerPlugin
     new webpack.BannerPlugin({
       banner: () => {
@@ -459,11 +459,8 @@ const config = {
           ,vers = packageJson.version.split('.').slice(0,-1).join('.')
         ;
 
-        return (
-          '/*!\n' +
-          ` * ${packageJson.name} v.${vers} - Massimo Cassandro ${year}\n` +
-          ' */\n'
-        );
+        return `/*! ${packageJson.name} v.${vers} - Massimo Cassandro ${year} */`;
+
       },
       raw: true,
       // niente banner nei critical css: vengono inlinati nei template html

package/index.js

@@ -20,7 +20,7 @@ export { ValidationError } from './src/utilities/validation-error-class.js';
 
 // domBuilder helpers
 export { buildPictureTag } from './src/utilities/dom-builder-helpers/picture-tag.js';
-export { buildInputTag, buildCheckboxTag, buildTextareaTag } from './src/utilities/dom-builder-helpers/form-tags.js';
+export { buildInput, buildCheckbox, buildTextarea, fakeField } from './src/utilities/dom-builder-helpers/form-tags.js';
 
 // components
 export { dismissAlerts } from './src/components/dismiss-alerts.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.20.11",
+  "version": "1.20.12",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./index.js",

package/src/components/sf-macro/readme.md

@@ -17,7 +17,7 @@ sf_macro({
 ## Twig macro
 
 ```twig
-<fieldset class="sf-macro-wrapper">
+<fieldset class="fset sf-macro-wrapper">
   <legend>XXXXX</legend>
 
   {%- macro makeRow(row) -%}

package/src/components/sf-macro/sf-macro.js

@@ -1,5 +1,5 @@
-/*! minimo - Symfony Macro */
-// import './sf-macro.css'; // import in the consuming project
+/*! minimo - Symfony Macro Manager */
+import './sf-macro.css';
 
 /**
  * Initialises Symfony macro collection fields (repeatable fieldsets).

package/src/utilities/dom-builder-helpers/form-tags.js

@@ -48,18 +48,20 @@ function buildFormGroup({
  * @param {string | number | null} args.value - input `value` attribute.
  * @param {string | null} [args.type='text'] - input `type` attribute.
  * @param {string | null} [args.wrapperClass=null] - optional class to be added to the `.form-group` wrapper.
+ * @param {string | null} [args.className=null] - optional class to be added to the `input`.
  * @param {boolean} [args.condition=true] - When false, the function returns `null` without building anything.
  * @param {string | HTMLElement | null} args.help - Optional help text.
  * @param {(function(HTMLElement): void) | null} args.callback - Optional callback function.
- * @param {object | null}  [args.attrs={}] - Optional attributes object.
+ * @param {Record<string, any> | null}  [args.attrs={}] - Optional attributes object.
  * @returns {DomBuilderItem|null} The `input` domBuilder item, or `null` when `condition` is false.
  */
-export function buildInputTag({
+export function buildInput({
   label,
   name,
   value = null,
   type = 'text',
   wrapperClass = null,
+  className = null,
   condition = true,
   help = null,
   attrs = {},
@@ -76,7 +78,7 @@ export function buildInputTag({
       `label.form-label[for:${id}] ${label}`,
       {
         tag: 'input',
-        className: 'form-control',
+        className: classnames('form-control', className, attrs?.class),
         id: id,
         attrs: {
           ...(attrs??{}),
@@ -104,10 +106,10 @@ export function buildInputTag({
  * @param {boolean} [args.condition=true] - When false, the function returns `null` without building anything.
  * @param {string | HTMLElement | null} args.help - Optional help text.
  * @param {(function(HTMLElement): void) | null} args.callback - Optional callback function.
- * @param {object | null}  [args.attrs={}] - Optional attributes object.
+ * @param {Record<string, any> | null}  [args.attrs={}] - Optional attributes object.
  * @returns {DomBuilderItem|null} The `.form-check` (or `.form-group`-wrapped) domBuilder item, or `null` when `condition` is false.
  */
-export function buildCheckboxTag({
+export function buildCheckbox({
   label,
   name,
   value = 1,
@@ -176,17 +178,19 @@ export function buildCheckboxTag({
  * @param {string | null} args.name - textarea `name` attribute.
  * @param {string | number | null} args.value - textarea content.
  * @param {string | null} [args.wrapperClass=null] - optional class to be added to the `.form-group` wrapper.
+ * @param {string | null} [args.className=null] - optional class to be added to the textarea element.
  * @param {boolean} [args.condition=true] - When false, the function returns `null` without building anything.
  * @param {string | HTMLElement | null} args.help - Optional help text.
  * @param {(function(HTMLElement): void) | null} args.callback - Optional callback function.
- * @param {object | null}  [args.attrs={}] - Optional attributes object.
+ * @param {Record<string, any> | null}  [args.attrs={}] - Optional attributes object.
  * @returns {DomBuilderItem|null} The `textarea` domBuilder item, or `null` when `condition` is false.
  */
-export function buildTextareaTag({
+export function buildTextarea({
   label,
   name,
   value = null,
   wrapperClass = null,
+  className = null,
   condition = true,
   help = null,
   callback = null,
@@ -203,7 +207,7 @@ export function buildTextareaTag({
       `label.form-label[for:${id}] ${label}`,
       {
         tag: 'textarea',
-        className: 'form-control',
+        className: classnames('form-control', className, attrs?.class),
         id: id,
         attrs: {
           ...(attrs??{}),
@@ -215,3 +219,48 @@ export function buildTextareaTag({
     ]
   });
 }
+
+/**
+ * Fake field (plain text showed as an input field)
+ *
+ * @param {Object} args
+ * @param {string} args.label - label.
+ * @param {string | number | null} args.value - text content.
+ * @param {string | null} [args.wrapperClass=null] - optional class to be added to the `.form-group` wrapper.
+ * @param {string | null} [args.className=null] - optional class to be added to the fake field.
+ * @param {boolean} [args.condition=true] - When false, the function returns `null` without building anything.
+ * @param {string | HTMLElement | null} args.help - Optional help text.
+ * @param {(function(HTMLElement): void) | null} args.callback - Optional callback function.
+ * @param {Record<string, any> | null}  [args.attrs={}] - Optional attributes object.
+ * @returns {DomBuilderItem|null} The fake field domBuilder item, or `null` when `condition` is false.
+ */
+export function fakeField({
+  label,
+  value = null,
+  wrapperClass = null,
+  className = null,
+  condition = true,
+  help = null,
+  callback = null,
+  attrs = {}
+}) {
+
+
+  return buildFormGroup({
+    condition,
+    wrapperClass,
+    help,
+    children: [
+      `span.form-label ${label}`,
+      {
+        className: classnames('form-control-static', className, attrs?.class),
+        attrs: {
+          ...(attrs??{}),
+          name: name,
+        },
+        content: value,
+        callback: callback
+      }
+    ]
+  });
+}