@gouvfr/dsfr-roller/src/node/directive/doc/guidance/pin-leaf-directive.js

Le module `dsfr-roller` permet de publier le site de documentation du Système de Design de l’État - DSFR

import { Node } from '../../../node.js';

class PinLeafDirective extends Node {
  structure (data) {
    const required = data?.properties?.required;
    const add = data?.properties?.add;
    const titleChildren = data?.children[0];
    const requiredFragment = data.fragments?.anatomy?.required;
    const optionalFragment = data.fragments?.anatomy?.optional;
    let descriptionValue = ` — ${required === true ? requiredFragment : optionalFragment}`;
    if (add) descriptionValue = `, ${add}${descriptionValue}`;

    if (!titleChildren) {
      log.warn(`PinLeafDirective: missing label on pin`);
    }

    return {
      type: 'htmlContainer',
      tagName: 'li',
      classes: ['dsfr-doc-anatomy__pin', required === true ? 'dsfr-doc-anatomy__pin--required' : ''],
      children: [
        {
          type: 'htmlContainer',
          tagName: 'span',
          classes: ['dsfr-doc-anatomy__title'],
          children: [titleChildren]
        },
        {
          type: 'htmlContainer',
          tagName: 'span',
          classes: ['dsfr-doc-anatomy__description'],
          children: [
            {
              type: 'text',
              value: descriptionValue
            }
          ]
        }
      ]
    };
  }
}

PinLeafDirective.NAME = 'dsfr-doc-pin';

export { PinLeafDirective };