@undrr/undrr-mangrove 2.0.0-rc.2 → 2.0.0

package/js/__tests__/show-more.test.js

@@ -1,80 +0,0 @@
-import { mgShowMore } from '../show-more';
-
-afterEach(() => {
-  document.body.innerHTML = '';
-});
-
-function setupButton({ manual = false, targetSelector = null } = {}) {
-  document.body.innerHTML = `
-    <button
-      data-mg-show-more
-      ${manual ? 'data-mg-show-more-skip-auto-init' : ''}
-      ${targetSelector ? `data-mg-show-more-target="${targetSelector}"` : ''}
-    >Show more</button>
-    <div class="mg-show-more--container mg-show-more--collapsed"></div>
-  `;
-  return document.querySelector('[data-mg-show-more]');
-}
-
-describe('mgShowMore', () => {
-  describe('data-mg-show-more-skip-auto-init', () => {
-    it('skips elements with the attribute during auto-init (no scope)', () => {
-      const btn = setupButton({ manual: true });
-      mgShowMore(); // no scope = auto-init path
-      expect(btn.dataset.mgShowMoreInitialized).toBeUndefined();
-    });
-
-    it('processes elements with the attribute when scope is passed explicitly', () => {
-      const btn = setupButton({ manual: true });
-      mgShowMore([btn]);
-      expect(btn.dataset.mgShowMoreInitialized).toBe('true');
-    });
-  });
-
-  describe('idempotency', () => {
-    it('does not double-initialize when called twice', () => {
-      const btn = setupButton();
-      mgShowMore();
-      // After first call, flag is set and button has been clicked once (collapsed → expanded)
-      const target = document.querySelector('.mg-show-more--container');
-      const classAfterFirst = target.classList.contains(
-        'mg-show-more--collapsed'
-      );
-
-      mgShowMore();
-      // Second call should be a no-op — collapsed state must not change
-      expect(target.classList.contains('mg-show-more--collapsed')).toBe(
-        classAfterFirst
-      );
-      expect(btn.dataset.mgShowMoreInitialized).toBe('true');
-    });
-  });
-
-  describe('missing target guard', () => {
-    it('does not throw and warns when target element is missing', () => {
-      document.body.innerHTML = `
-        <button data-mg-show-more data-mg-show-more-target=".nonexistent">Show more</button>
-      `;
-      const warn = jest.spyOn(console, 'warn').mockImplementation(() => {});
-      expect(() => mgShowMore()).not.toThrow();
-      expect(warn).toHaveBeenCalledWith(
-        expect.stringContaining('.nonexistent')
-      );
-      warn.mockRestore();
-    });
-  });
-
-  describe('single-element scope', () => {
-    it('accepts a single HTMLElement without throwing', () => {
-      const btn = setupButton();
-      expect(() => mgShowMore(btn)).not.toThrow();
-      expect(btn.dataset.mgShowMoreInitialized).toBe('true');
-    });
-
-    it('does not apply skip-auto-init check when a single element is passed as scope', () => {
-      const btn = setupButton({ manual: true });
-      mgShowMore(btn); // single element, not an array
-      expect(btn.dataset.mgShowMoreInitialized).toBe('true');
-    });
-  });
-});

package/js/__tests__/table-of-contents.test.js

@@ -1,196 +0,0 @@
-import { mgTableOfContents, mgTableOfContentsInit } from '../table-of-contents';
-
-afterEach(() => {
-  document.body.innerHTML = '';
-});
-
-function setupPage({ contentSelector, title, showTitle, skipAutoInit } = {}) {
-  document.body.innerHTML = `
-    <article class="mg-content">
-      <section
-        data-mg-table-of-contents
-        ${contentSelector ? `data-mg-table-of-contents-content="${contentSelector}"` : ''}
-        ${title ? `data-mg-table-of-contents-title="${title}"` : ''}
-        ${showTitle === false ? 'data-mg-table-of-contents-show-title="false"' : ''}
-        ${skipAutoInit ? 'data-mg-table-of-contents-skip-auto-init' : ''}
-        class="mg-table-of-contents"
-      ></section>
-      <h2 id="section-a">Section A</h2>
-      <p>Content A</p>
-      <h2>Section B</h2>
-      <p>Content B</p>
-      <h2 class="mg-table-of-contents--exclude">Excluded</h2>
-      <p>Should not appear</p>
-      <h2 class="mg-u-sr-only">Screen reader only</h2>
-      <p>Should not appear</p>
-      <h2>Section C</h2>
-      <p>Content C</p>
-    </article>
-  `;
-  return {
-    toc: document.querySelector('[data-mg-table-of-contents]'),
-    content: document.querySelector('.mg-content'),
-  };
-}
-
-describe('mgTableOfContents', () => {
-  it('generates TOC links from h2 headings', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc);
-
-    const links = toc.querySelectorAll('li a');
-    expect(links).toHaveLength(3);
-    expect(links[0].textContent).toBe('Section A');
-    expect(links[1].textContent).toBe('Section B');
-    expect(links[2].textContent).toBe('Section C');
-  });
-
-  it('uses existing heading IDs', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc);
-
-    const links = toc.querySelectorAll('li a');
-    expect(links[0].getAttribute('href')).toBe('#section-a');
-  });
-
-  it('generates IDs for headings without them', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc);
-
-    // Index 2 because mgTableOfContents prepends an h2 title to the TOC
-    // element which is inside content: [0]=title, [1]=Section A, [2]=Section B
-    const sectionB = content.querySelectorAll('h2')[2];
-    expect(sectionB.id).toBe('section-b');
-
-    const links = toc.querySelectorAll('li a');
-    expect(links[1].getAttribute('href')).toBe('#section-b');
-  });
-
-  it('excludes headings with mg-table-of-contents--exclude', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc);
-
-    const linkTexts = Array.from(toc.querySelectorAll('li a')).map(
-      a => a.textContent
-    );
-    expect(linkTexts).not.toContain('Excluded');
-  });
-
-  it('excludes headings with mg-u-sr-only', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc);
-
-    const linkTexts = Array.from(toc.querySelectorAll('li a')).map(
-      a => a.textContent
-    );
-    expect(linkTexts).not.toContain('Screen reader only');
-  });
-
-  it('adds default title "On this page"', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc);
-
-    const header = toc.querySelector('h2#on-this-page');
-    expect(header).not.toBeNull();
-    expect(header.textContent).toBe('On this page');
-  });
-
-  it('uses custom title from data attribute', () => {
-    const { toc, content } = setupPage({ title: 'Contents' });
-    mgTableOfContents(content, toc);
-
-    const header = toc.querySelector('h2#on-this-page');
-    expect(header.textContent).toBe('Contents');
-  });
-
-  it('hides title when show-title is false', () => {
-    const { toc, content } = setupPage({ showTitle: false });
-    mgTableOfContents(content, toc);
-
-    const header = toc.querySelector('h2#on-this-page');
-    expect(header).toBeNull();
-  });
-
-  it('adds mg-u-sr-only class when title is "hidden"', () => {
-    const { toc, content } = setupPage({ title: 'hidden' });
-    mgTableOfContents(content, toc);
-
-    const header = toc.querySelector('h2#on-this-page');
-    expect(header.classList.contains('mg-u-sr-only')).toBe(true);
-  });
-
-  it('renders ordered list when showNumbers is true', () => {
-    const { toc, content } = setupPage();
-    mgTableOfContents(content, toc, true);
-
-    expect(toc.querySelector('ol')).not.toBeNull();
-    expect(toc.querySelector('ul')).toBeNull();
-  });
-
-  it('logs error when content element is missing', () => {
-    const error = jest.spyOn(console, 'error').mockImplementation(() => {});
-    const { toc } = setupPage();
-    mgTableOfContents(null, toc);
-    expect(error).toHaveBeenCalled();
-    error.mockRestore();
-  });
-});
-
-describe('mgTableOfContentsInit', () => {
-  it('auto-initializes elements with data-mg-table-of-contents', () => {
-    const { toc } = setupPage({ contentSelector: '.mg-content' });
-    mgTableOfContentsInit();
-
-    expect(toc.dataset.mgTableOfContentsInitialized).toBe('true');
-    expect(toc.querySelectorAll('li a').length).toBeGreaterThan(0);
-  });
-
-  it('skips elements with skip-auto-init during auto-init', () => {
-    const { toc } = setupPage({ skipAutoInit: true });
-    mgTableOfContentsInit(); // no scope = auto-init path
-    expect(toc.dataset.mgTableOfContentsInitialized).toBeUndefined();
-  });
-
-  it('processes skip-auto-init elements when scope is passed explicitly', () => {
-    const { toc } = setupPage({
-      skipAutoInit: true,
-      contentSelector: '.mg-content',
-    });
-    mgTableOfContentsInit([toc]);
-    expect(toc.dataset.mgTableOfContentsInitialized).toBe('true');
-  });
-
-  it('does not double-initialize', () => {
-    const { toc } = setupPage({ contentSelector: '.mg-content' });
-    mgTableOfContentsInit();
-    const linkCountFirst = toc.querySelectorAll('li a').length;
-
-    mgTableOfContentsInit();
-    const linkCountSecond = toc.querySelectorAll('li a').length;
-    expect(linkCountSecond).toBe(linkCountFirst);
-  });
-
-  it('accepts a single HTMLElement as scope', () => {
-    const { toc } = setupPage({ contentSelector: '.mg-content' });
-    expect(() => mgTableOfContentsInit(toc)).not.toThrow();
-    expect(toc.dataset.mgTableOfContentsInitialized).toBe('true');
-  });
-
-  it('defaults to document.body when no content selector is set', () => {
-    const { toc } = setupPage(); // no contentSelector
-    mgTableOfContentsInit();
-
-    // Should still find headings since they're children of document.body
-    expect(toc.querySelectorAll('li a').length).toBeGreaterThan(0);
-  });
-
-  it('warns when content selector points to nonexistent element', () => {
-    const { toc } = setupPage({ contentSelector: '.nonexistent' });
-    const warn = jest.spyOn(console, 'warn').mockImplementation(() => {});
-    mgTableOfContentsInit();
-    expect(warn).toHaveBeenCalledWith(expect.stringContaining('.nonexistent'));
-    // Should still mark as initialized (no retry without clearing flag)
-    expect(toc.dataset.mgTableOfContentsInitialized).toBe('true');
-    warn.mockRestore();
-  });
-});

package/scss/Components/SyndicationSearchWidget/SyndicationSearchWidget.scss

@@ -1,11 +0,0 @@
-/**
- * Syndication Search Widget
- *
- * Elasticsearch search interface with faceted filtering, multi-layout result cards, and live metrics.
- *
- * Full documentation:
- * https://github.com/unisdr/undrr-mangrove/blob/main/stories/Components/SyndicationSearchWidget/SyndicationSearchWidget.mdx
- */
-// SyndicationSearchWidget.scss: DEPRECATED, use syndication-search-widget.scss
-@import "./syndication-search-widget";
-@warn "SyndicationSearchWidget.scss is deprecated. Import syndication-search-widget.scss instead.";

package/scss/Components/TableOfContents/TableOfContents.scss

@@ -1,11 +0,0 @@
-/**
- * Table of Contents (Alias)
- *
- * CamelCase alias forwarding to table-of-contents.scss.
- *
- * Full documentation:
- * https://github.com/unisdr/undrr-mangrove/blob/main/stories/Components/TableOfContents/TableOfContents.mdx
- */
-// TableOfContents.scss — DEPRECATED, use table-of-contents.scss
-@import "./table-of-contents";
-@warn "TableOfContents.scss is deprecated. Import table-of-contents.scss instead.";

package/scss/Utilities/FullWidth/FullWidth.scss

@@ -1,11 +0,0 @@
-/**
- * Full Width (Alias)
- *
- * CamelCase alias forwarding to full-width.scss.
- *
- * Full documentation:
- * https://github.com/unisdr/undrr-mangrove/blob/main/stories/Utilities/FullWidth/FullWidth.mdx
- */
-// FullWidth.scss — DEPRECATED, use full-width.scss
-@import "./full-width";
-@warn "FullWidth.scss is deprecated. Import full-width.scss instead.";

package/scss/Utilities/ShowMore/ShowMore.scss

@@ -1,11 +0,0 @@
-/**
- * Show More (Alias)
- *
- * CamelCase alias forwarding to show-more.scss.
- *
- * Full documentation:
- * https://github.com/unisdr/undrr-mangrove/blob/main/stories/Utilities/ShowMore/ShowMore.mdx
- */
-// ShowMore.scss — DEPRECATED, use show-more.scss
-@import "./show-more";
-@warn "ShowMore.scss is deprecated. Import show-more.scss instead.";