@uniweb/kit 0.1.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,345 @@
+# @uniweb/kit
+
+Standard component library for Uniweb foundations.
+
+## Installation
+
+```bash
+npm install @uniweb/kit
+```
+
+## Quick Start
+
+```jsx
+import { Link, Image, Section, useWebsite } from '@uniweb/kit'
+
+function Hero() {
+  const { localize } = useWebsite()
+
+  return (
+    <Section width="xl" padding="lg">
+      <Image src="/hero.jpg" alt="Hero" className="rounded-xl" />
+      <h1>{localize({ en: 'Welcome', fr: 'Bienvenue' })}</h1>
+      <Link to="/about">Learn More</Link>
+    </Section>
+  )
+}
+```
+
+## Components
+
+### Primitives
+
+#### Link
+
+Smart link component with routing, downloads, and auto-generated accessible titles.
+
+```jsx
+import { Link } from '@uniweb/kit'
+
+<Link to="/about">About</Link>
+<Link href="https://github.com">GitHub</Link>
+<Link href="/files/report.pdf">Download Report</Link>
+<Link href="mailto:hello@example.com">Contact</Link>
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `to` / `href` | `string` | Destination URL |
+| `title` | `string` | Tooltip (auto-generated if not provided) |
+| `target` | `string` | Link target |
+| `download` | `boolean` | Force download behavior |
+
+#### Image
+
+Versatile image component with filters and profile integration.
+
+```jsx
+import { Image } from '@uniweb/kit'
+
+<Image src="/photo.jpg" alt="Photo" />
+<Image src="/photo.jpg" filter={{ grayscale: 100 }} />
+<Image profile={profile} type="avatar" size="lg" rounded />
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `src` / `url` | `string` | Image URL |
+| `alt` | `string` | Alt text |
+| `size` | `string` | Size preset: xs, sm, md, lg, xl, 2xl, full |
+| `rounded` | `boolean\|string` | Border radius |
+| `filter` | `object` | CSS filters: blur, brightness, contrast, grayscale, saturate, sepia |
+| `profile` | `object` | Profile for avatar/banner images |
+| `type` | `string` | Image type: avatar, banner |
+
+#### SafeHtml
+
+Safely render HTML with topic link resolution.
+
+```jsx
+import { SafeHtml } from '@uniweb/kit'
+
+<SafeHtml value="<p>Hello <strong>World</strong></p>" />
+<SafeHtml value='<a href="topic:about">About</a>' />
+```
+
+#### Icon
+
+SVG icon component with built-in icons and URL loading.
+
+```jsx
+import { Icon } from '@uniweb/kit'
+
+<Icon name="check" size="24" color="green" />
+<Icon url="/icons/custom.svg" />
+<Icon svg="<svg>...</svg>" />
+```
+
+Built-in icons: check, alert, user, heart, settings, star, close, menu, chevronDown, chevronRight, externalLink, download, play
+
+### Typography
+
+#### Text
+
+Smart typography component for rendering semantic parser output. Handles strings or arrays with automatic tag selection.
+
+```jsx
+import { Text, H1, H2, P, PlainText } from '@uniweb/kit'
+
+// Using semantic aliases (recommended)
+<H1 text="Main Title" />
+<H2 text={["Multi-line", "Subtitle"]} />
+<P text="A paragraph of content" />
+<P text={["First paragraph", "Second paragraph"]} />
+
+// Using Text directly
+<Text text="Hello" as="h1" />
+<Text text={["Line 1", "Line 2"]} as="h2" />
+
+// Plain text (HTML tags shown as text)
+<PlainText text="Show <strong>tags</strong> as text" />
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `text` | `string\|string[]` | Content to render |
+| `as` | `string` | Tag: 'h1'-'h6', 'p', 'div', 'span' |
+| `html` | `boolean` | Render as HTML (default: true) |
+| `lineAs` | `string` | Tag for array items |
+| `className` | `string` | CSS classes |
+
+**Semantic aliases**: `H1`, `H2`, `H3`, `H4`, `H5`, `H6`, `P`, `Span`, `Div`, `PlainText`
+
+**Key behaviors**:
+- Empty strings/arrays return `null` (no empty elements)
+- Headings with arrays: all lines wrapped in single heading tag
+- Paragraphs with arrays: each line gets its own `<p>` tag
+
+### Media
+
+#### Media
+
+Video player for YouTube, Vimeo, and local videos.
+
+```jsx
+import { Media } from '@uniweb/kit'
+
+<Media src="https://youtube.com/watch?v=abc123" />
+<Media src="/videos/intro.mp4" controls />
+<Media src="https://youtube.com/..." thumbnail="/poster.jpg" facade />
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `src` | `string` | Video URL |
+| `thumbnail` | `string` | Poster image URL |
+| `autoplay` | `boolean` | Auto-play video |
+| `muted` | `boolean` | Mute video |
+| `loop` | `boolean` | Loop video |
+| `controls` | `boolean` | Show controls |
+| `facade` | `boolean` | Show thumbnail with play button |
+
+#### FileLogo
+
+File type icons based on filename.
+
+```jsx
+import { FileLogo } from '@uniweb/kit'
+
+<FileLogo filename="report.pdf" size="32" />
+<FileLogo filename="data.xlsx" />
+```
+
+#### MediaIcon
+
+Social media platform icons.
+
+```jsx
+import { MediaIcon } from '@uniweb/kit'
+
+<MediaIcon type="twitter" size="24" />
+<MediaIcon type="linkedin" className="text-blue-600" />
+```
+
+Supported: facebook, twitter, x, linkedin, instagram, youtube, github, medium, pinterest, email, phone, orcid, researchgate
+
+### Content
+
+#### Section
+
+Rich content section with layout options.
+
+```jsx
+import { Section } from '@uniweb/kit'
+
+<Section content={blockContent} width="lg" padding="md" />
+
+<Section width="xl" columns="2" className="bg-gray-50">
+  <div>Column 1</div>
+  <div>Column 2</div>
+</Section>
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `content` | `object\|array` | Content to render |
+| `block` | `object` | Block object from runtime |
+| `width` | `string` | sm, md, lg, xl, 2xl, full |
+| `columns` | `string` | 1, 2, 3, 4 |
+| `padding` | `string` | none, sm, md, lg, xl |
+
+#### Render
+
+Content block renderer (used internally by Section).
+
+```jsx
+import { Render } from '@uniweb/kit'
+
+<Render content={proseMirrorContent} />
+```
+
+#### Content Renderers
+
+Individual content type renderers:
+
+```jsx
+import { Code, Alert, Table, Details, Divider } from '@uniweb/kit'
+
+<Code content="const x = 1" language="javascript" />
+<Alert type="warning" content="Be careful!" />
+<Table content={tableData} />
+<Details summary="Click to expand" content="Hidden content" />
+<Divider type="dots" />
+```
+
+### Utilities
+
+#### Asset
+
+File preview with download functionality.
+
+```jsx
+import { Asset } from '@uniweb/kit'
+
+<Asset value="document.pdf" profile={profile} />
+<Asset value={{ src: "/files/report.pdf", filename: "report.pdf" }} />
+```
+
+#### Disclaimer
+
+Modal disclaimer dialog.
+
+```jsx
+import { Disclaimer } from '@uniweb/kit'
+
+<Disclaimer
+  title="Terms of Service"
+  content="<p>Please read our terms...</p>"
+  triggerText="View Terms"
+/>
+```
+
+## Hooks
+
+### useWebsite
+
+Access website instance and utilities.
+
+```jsx
+import { useWebsite } from '@uniweb/kit'
+
+function MyComponent() {
+  const {
+    website,      // Website instance
+    localize,     // Localize multilingual values
+    makeHref,     // Transform hrefs
+    getLanguage,  // Current language
+    getLanguages  // Available languages
+  } = useWebsite()
+
+  return <div>{localize({ en: 'Hello', fr: 'Bonjour' })}</div>
+}
+```
+
+## Utility Functions
+
+```jsx
+import { cn, stripTags, isExternalUrl, isFileUrl, detectMediaType } from '@uniweb/kit'
+
+// Merge Tailwind classes
+cn('px-4 py-2', 'bg-blue-500', condition && 'opacity-50')
+
+// Strip HTML tags
+stripTags('<p>Hello</p>') // "Hello"
+
+// URL utilities
+isExternalUrl('https://google.com') // true
+isFileUrl('/files/doc.pdf')         // true
+detectMediaType('https://youtube.com/...') // 'youtube'
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Foundation (your code)                                     │
+│    ├── imports @uniweb/kit (bundled into foundation)        │
+│    └── @uniweb/core marked as external                      │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  @uniweb/runtime (browser)                                  │
+│    ├── Loads foundation dynamically                         │
+│    ├── Provides @uniweb/core singleton                      │
+│    └── Orchestrates React rendering                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## For Foundation Creators
+
+1. **Use kit components** for common UI patterns
+2. **Use hooks** like `useWebsite` for localization and routing
+3. **Don't access `globalThis.uniweb`** directly - use kit's abstractions
+4. **Bundle kit, externalize core** - kit gets tree-shaken into your foundation
+
+```js
+// vite.config.js
+export default {
+  build: {
+    rollupOptions: {
+      // Kit is bundled (tree-shaken), core is external (provided by runtime)
+      external: ['react', 'react-dom', 'react-router-dom', '@uniweb/core']
+    }
+  }
+}
+```
+
+This approach lets you:
+- Tree-shake unused kit components
+- Override or extend kit components
+- Bring your own alternative components
+
+## License
+
+Apache-2.0

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@uniweb/kit",
+  "version": "0.1.1",
+  "description": "Standard component library for Uniweb foundations",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js",
+    "./styles": "./src/styles/index.css"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "keywords": [
+    "uniweb",
+    "kit",
+    "components",
+    "react"
+  ],
+  "author": "Proximify",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uniweb/kit.git"
+  },
+  "homepage": "https://github.com/uniweb/kit#readme",
+  "bugs": {
+    "url": "https://github.com/uniweb/kit/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "dependencies": {
+    "tailwind-merge": "^2.6.0",
+    "@uniweb/core": "0.1.2"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "tailwindcss": "^3.4.0"
+  }
+}