@inizioevoke/astro-core 2.3.2 → 3.0.0

package/docs/components/BottomISI.md

@@ -64,7 +64,7 @@ The ISI starts collapsed to zero height. The built-in button toggles it open and
 
 ```astro
 ---
-import { BottomISI } from '@inizioevoke/astro-core';
+import BottomISI from '@inizioevoke/astro-core/BottomISI';
 ---
 <footer>
   <BottomISI>
@@ -80,7 +80,7 @@ The partial excerpt is always visible. Clicking it expands the full ISI on top.
 
 ```astro
 ---
-import { BottomISI } from '@inizioevoke/astro-core';
+import BottomISI from '@inizioevoke/astro-core/BottomISI';
 ---
 <footer>
   <BottomISI>
@@ -101,7 +101,7 @@ Set a visible collapsed height so the ISI is always partially shown even before
 
 ```astro
 ---
-import { BottomISI } from '@inizioevoke/astro-core';
+import BottomISI from '@inizioevoke/astro-core/BottomISI';
 ---
 <style>
   footer evo-isi {
@@ -156,7 +156,7 @@ Replace the built-in toggle with your own markup using the named slots.
 </BottomISI>
 
 <script>
-  import type { IEvoIsiElement } from '@inizioevoke/astro-core';
+  import type { IEvoIsiElement } from '@inizioevoke/astro-core/lib/BottomISI';
 
   const isi = document.querySelector<IEvoIsiElement>('#page-isi');
 

package/docs/components/CssBackgroundImage.md

@@ -22,7 +22,7 @@ The image will be optimized by default. Optimization options include `format`, `
 ```html
 <!-- Astro Page -->
 ---
-import { CssBackgroundImage } from '@inizioevoke/astro-core';
+import CssBackgroundImage from '@inizioevoke/astro-core/CssBackgroundImage';
 import Layout from '../layouts/Layout.astro';
 import bgImg_m from '../assets/img/background-m.jpg';
 import bgImg_d from '../assets/img/background-d.jpg';

package/docs/components/CssVariables.md

@@ -22,7 +22,7 @@ The image will be optimized by default. Optimization options include `format`, `
 ```html
 <!-- Astro Page -->
 ---
-import { CssVariables } from '@inizioevoke/astro-core';
+import CssVariables from '@inizioevoke/astro-core/CssVariables';
 import Layout from '../layouts/Layout.astro';
 import bgImg_m from '../assets/img/background-m.jpg';
 import bgImg_d from '../assets/img/background-d.jpg';

package/docs/components/FlipCard.md

@@ -45,7 +45,7 @@ The underlying `<evo-flip-card>` custom element exposes the following API for pr
 
 ```astro
 ---
-import { FlipCard } from '@inizioevoke/astro-core';
+import FlipCard from '@inizioevoke/astro-core/FlipCard';
 ---
 <FlipCard width={400} height={300}>
   <div slot="front">

package/docs/components/Modal.md

@@ -89,7 +89,7 @@ Access the `<evo-modal>` element directly to call these methods:
 Importable from the package entry point for use in client scripts.
 
 ```ts
-import { showModal, hideModal, hideModals, showOverlay, hideOverlay, bindTriggers } from '@inizioevoke/astro-core';
+import { showModal, hideModal, hideModals, showOverlay, hideOverlay, bindTriggers } from '@inizioevoke/astro-core/lib/Modal';
 ```
 
 | Function | Signature | Description |
@@ -135,7 +135,7 @@ Any element with the class `evo-modal-action-hide` inside a modal will close it
 
 ```astro
 ---
-import { Modal, ModalTrigger } from '@inizioevoke/astro-core';
+import Modal, { ModalTrigger } from '@inizioevoke/astro-core/Modal';
 ---
 <ModalTrigger modal="info-modal">Open modal</ModalTrigger>
 
@@ -176,7 +176,7 @@ import { Modal, ModalTrigger } from '@inizioevoke/astro-core';
 
 ```astro
 <script>
-  import { showModal } from '@inizioevoke/astro-core';
+  import { showModal } from '@inizioevoke/astro-core/lib/Modal';
 
   document.querySelector('#open-btn').addEventListener('click', () => {
     showModal('info-modal', {
@@ -191,7 +191,7 @@ import { Modal, ModalTrigger } from '@inizioevoke/astro-core';
 ### Binding dynamically added triggers
 
 ```ts
-import { bindTriggers } from '@inizioevoke/astro-core';
+import { bindTriggers } from '@inizioevoke/astro-core/lib/Modal';
 
 // After inserting new trigger elements into the DOM:
 bindTriggers(myContainer);
@@ -201,7 +201,7 @@ bindTriggers(myContainer);
 
 ```astro
 ---
-import { Modal, ModalOverlay } from '@inizioevoke/astro-core';
+import Modal, { ModalOverlay } from '@inizioevoke/astro-core/Modal';
 ---
 <ModalOverlay class="my-overlay" />
 

package/docs/components/ScrollContainer.md

@@ -67,7 +67,7 @@ Access the `<evo-scroll-container>` element directly to use these members:
 Importable from the package entry point for use in client scripts.
 
 ```ts
-import { resize, refresh, getScroll, scroll, getScrollContainer } from '@inizioevoke/astro-core';
+import { resize, refresh, getScroll, scroll, getScrollContainer } from '@inizioevoke/astro-core/lib/ScrollContainer';
 ```
 
 | Function | Signature | Description |
@@ -86,7 +86,7 @@ import { resize, refresh, getScroll, scroll, getScrollContainer } from '@inizioe
 
 ```astro
 ---
-import { ScrollContainer } from '@inizioevoke/astro-core';
+import ScrollContainer from '@inizioevoke/astro-core/ScrollContainer';
 ---
 <ScrollContainer height={400}>
   <p>Line 1</p>
@@ -133,7 +133,7 @@ import { ScrollContainer } from '@inizioevoke/astro-core';
 ### Using utility functions
 
 ```ts
-import { scroll, refresh } from '@inizioevoke/astro-core';
+import { scroll, refresh } from '@inizioevoke/astro-core/lib/ScrollContainer';
 
 // Smooth-scroll to position
 scroll('#my-scroll', { top: 200, behavior: 'smooth' });

package/docs/components/Tabs.md

@@ -49,7 +49,7 @@ Defines a single tab. Rendered as a child of `Tabs`. The tab button label comes
 
 ```astro
 ---
-import { Tabs, TabItem } from '@inizioevoke/astro-core';
+import { Tabs, TabItem } from '@inizioevoke/astro-core/Tabs';
 ---
 <Tabs>
   <TabItem active>

package/docs/lib/utils.md

@@ -0,0 +1,66 @@
+# Astro Utilities
+
+## addCssClassToAttrs
+
+Merges one or more CSS class names into an Astro element's spread attributes object, preserving any existing `class` or `class:list` values.
+
+This is an internal utility used by components to inject required class names without overwriting consumer-supplied classes.
+
+### Usage
+
+```ts
+import { addCssClassToAttrs } from '../../lib/utils';
+
+const { ...attrs } = Astro.props;
+addCssClassToAttrs(attrs, 'my-component');
+// attrs now has class:list: ['my-component']
+```
+
+```ts
+// Multiple classes at once
+addCssClassToAttrs(attrs, ['base-class', 'modifier-class']);
+```
+
+### API
+
+#### `addCssClassToAttrs(attrs, cssClass)`
+
+Mutates `attrs` in place. After the call, `attrs['class:list']` is set and `attrs['class']` is removed (Astro resolves `class:list` to the final `class` attribute at render time).
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `attrs` | `HTMLAttributes<T>` | The spread attributes object from `Astro.props`. Mutated in place. |
+| `cssClass` | `string \| string[]` | One or more class names to add. |
+
+**Merge behavior**
+
+| Before call | Result |
+|-------------|--------|
+| No `class` or `class:list` on `attrs` | `class:list` is set to `cssClass`. |
+| `class` present | Existing value is moved into `class:list` alongside `cssClass`; `class` is deleted. |
+| `class:list` present | `cssClass` is appended to the existing `class:list` array. |
+
+### Example — component usage
+
+```astro
+---
+import type { HTMLAttributes } from 'astro/types';
+import { addCssClassToAttrs } from '../../lib/utils';
+
+interface Props extends HTMLAttributes<'div'> {}
+const { ...attrs } = Astro.props;
+
+addCssClassToAttrs(attrs, 'my-component');
+---
+
+<div {...attrs}>
+  <slot />
+</div>
+```
+
+A consumer can pass `class` or `class:list` freely and the component's own class is always included:
+
+```astro
+<MyComponent class="consumer-class">...</MyComponent>
+<!-- Renders: <div class="my-component consumer-class">...</div> -->
+```

package/package.json

@@ -1,22 +1,30 @@
 {
   "name": "@inizioevoke/astro-core",
-  "version": "2.3.2",
+  "version": "3.0.0",
   "description": "",
   "license": "ISC",
   "author": "",
   "type": "module",
   "main": "./index.ts",
-  "exports": {
-    ".": "./src/components/index.ts",
+  "exports": {    
     "./integrations": "./src/integrations/index.ts",
-    "./lib": "./src/lib/index.ts",
-    "./lib/FlipCard": "./src/components/FlipCard/index.ts",
-    "./lib/BottomISI": "./src/components/BottomISI/index.ts",
-    "./lib/Modal": "./src/components/Modal/index.ts",
-    "./lib/PdfViewer": "./src/components/PdfViewer/index.ts",
-    "./lib/ScrollContainer": "./src/components/ScrollContainer/index.ts",
-    "./lib/gestures": "./src/lib/gestures/index.ts",
-    "./server": "./src/server/index.ts"
+    "./utils": "./src/lib/utils.ts",
+
+    "./CssBackgroundImage": "./src/components/CssBackgroundImage/index.ts",
+    "./CssVariables": "./src/components/CssVariables/index.ts",
+    "./FlipCard": "./src/components/FlipCard/index.ts",
+    "./BottomISI": "./src/components/ISI/BottomISI/index.ts",
+    "./Modal": "./src/components/Modal/index.ts",
+    "./ScrollContainer": "./src/components/ScrollContainer/index.ts",
+    "./Tabs": "./src/components/Tabs/index.ts",
+
+    "./lib/FlipCard": "./src/components/FlipCard/FlipCard.ts",
+    "./lib/BottomISI": "./src/components/ISI/BottomISI/BottomISI.ts",
+    "./lib/Modal": "./src/components/Modal/Modal.ts",
+    "./lib/ScrollContainer": "./src/components/ScrollContainer/ScrollContainer.ts",
+
+    "./lib/gestures/pinch": "./src/lib/client/gestures/pinch.ts",
+    "./lib/gestures/swipe": "./src/lib/client/gestures/swipe.ts"
   },
   "scripts": {
     "postinstall": "node postinstall.mjs"

package/src/components/CssBackgroundImage/index.ts

@@ -0,0 +1,4 @@
+export {
+  default,
+  type Props as CssBackgroundImageProps,
+} from "./CssBackgroundImage.astro";

package/src/components/CssVariables/index.ts

@@ -0,0 +1,7 @@
+export { 
+  default,
+  type Props as CssVariablesProps,
+  type CssBreakpoint,
+  type CssVariable,
+  type CssImageVariable
+} from "./CssVariables.astro";

package/src/components/FlipCard/index.ts

@@ -1 +1,4 @@
-export * from './FlipCard';
+export {
+  default,
+  type Props as FlipCardProps,
+} from "./FlipCard.astro";

package/src/components/ISI/BottomISI/BottomISI.astro

@@ -1,6 +1,6 @@
 ---
-import type { HTMLAttributes, HTMLTag } from 'astro/types';
-import { addCssClassToAttrs } from '../../../server/index';
+import type { HTMLAttributes } from 'astro/types';
+import { addCssClassToAttrs } from '../../../lib/utils';
 import ScrollContainer, { type Props as ScrollContainerProps } from '../../ScrollContainer/ScrollContainer.astro';
 import './BottomISI.css';
 

package/src/components/ISI/BottomISI/index.ts

@@ -1 +1,4 @@
-export * from './BottomISI';
+export {
+  default,
+  type Props as BottomISIProps
+} from "./BottomISI.astro";

package/src/components/Modal/index.ts

@@ -1 +1,14 @@
-export * from './Modal';
+export {
+  default,
+  type Props as ModalProps,
+} from "./Modal.astro";
+
+export {
+  default as ModalOverlay,
+  type Props as ModalOverlayProps,
+} from "./ModalOverlay.astro";
+
+export {
+  default as ModalTrigger,
+  type Props as ModalTriggerProps,
+} from "./ModalTrigger.astro";

package/src/components/ScrollContainer/index.ts

@@ -1 +1,4 @@
-export * from './ScrollContainer';
+export {
+  default,
+  type Props as ScrollContainerProps,
+} from "./ScrollContainer.astro";

package/src/components/Tabs/index.ts

@@ -0,0 +1,9 @@
+export { 
+  default as Tabs, 
+  type Props as TabsProps 
+} from "./Tabs.astro";
+
+export {
+  default as TabItem,
+  type Props as TabItemProps,
+} from "./TabItem.astro";

package/src/lib/client/index.ts

@@ -0,0 +1 @@
+export * from './gestures';

package/src/components/ISI/RightISI/RightISI.md

@@ -1,22 +0,0 @@
-# RightISI
-
-```jsx
-<RightISI
-  scrollContainer={{  // optional
-    /* ScrollContainer props */
-  }}
-  headerButton={true} // optional
->
-  <!-- optional -->
-  <div slot="header">Header Content</div>
-  
-  <!-- optional -->
-  <Fragment slot="header-button"><button>My Button</button></Fragment>
-
-  <!-- ISI content -->
-  <h2>Important Safety Information</h2>
-  <p>Content</p>
-
-  <div slot="footer">Footer Content</div>
-</RightISI>
-```

package/src/components/index.ts

@@ -1,72 +0,0 @@
-export {
-  default as CssBackgroundImage,
-  type Props as CssBackgroundImageProps,
-} from "./CssBackgroundImage.astro";
-
-export { 
-  default as CssVariables,
-  type Props as CssVariablesProps,
-  type CssBreakpoint,
-  type CssVariable,
-  type CssImageVariable
-} from "./CssVariables.astro";
-
-export {
-  default as FlipCard,
-  type Props as FlipCardProps,
-} from "./FlipCard/FlipCard.astro";
-
-export {
-  default as BottomISI,
-  type Props as BottomISIProps
-} from "./ISI/BottomISI/BottomISI.astro";
-
-// export {
-//   default as BottomScrollableISI,
-//   type Props as BottomScrollableISIProps
-// } from "./ISI/Bottom/BottomScrollableISI.astro";
-
-export {
-  default as RightISI,
-  type Props as RightISIProps,
-} from "./ISI/RightISI/RightISI.astro";
-
-export {
-  default as Modal,
-  type Props as ModalProps,
-} from "./Modal/Modal.astro";
-
-export {
-  default as ModalOverlay,
-  type Props as ModalOverlayProps,
-} from "./Modal/ModalOverlay.astro";
-
-export {
-  default as ModalTrigger,
-  type Props as ModalTriggerProps,
-} from "./Modal/ModalTrigger.astro";
-
-export {
-  default as PdfViewer,
-  type Props as PdfViewerProps,
-} from "./PdfViewer/PdfViewer.astro";
-
-export {
-  default as ScrollContainer,
-  type Props as ScrollContainerProps,
-} from "./ScrollContainer/ScrollContainer.astro";
-
-export { 
-  default as Tabs, 
-  type Props as TabsProps 
-} from "./Tabs/Tabs.astro";
-
-export {
-  default as TabItem,
-  type Props as TabItemProps,
-} from "./Tabs/TabItem.astro";
-
-export { 
-  default as Zoom, 
-  type Props as ZoomProps 
-} from "./Zoom/Zoom.astro";

package/src/lib/index.ts

@@ -1,6 +0,0 @@
-export * as FlipCard from '../components/FlipCard/FlipCard';
-export * as ISI from '../components/ISI/index';
-export * as gestures from './gestures';
-export * as Modal from '../components/Modal/Modal';
-export * as PdfViewer from '../components/PdfViewer/PdfViewer';
-export * as ScrollContainer from '../components/ScrollContainer/ScrollContainer';