@m3e/core 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 matraic
+Contact: matraic@yahoo.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,8 @@
+# NOTICE
+
+This package includes code adapted from third-party sources under the MIT license:
+
+- Angular Material CDK  
+  Source: https://github.com/angular/components  
+  License: MIT  
+  Copyright (c) Google LLC

package/README.md

@@ -0,0 +1,59 @@
+# @m3e/core
+
+The `@m3e/core` package delivers the essential primitives, utilities, and behavioral mixins for building Material 3 web components. It serves as the foundation for accessibility, layout, platform detection, design tokens, keycodes, and more—enabling consistent, scalable, and maintainable development across the monorepo.
+
+> **Part of the [M3E](../../README.md) monorepo**  
+> This package is maintained within the unified M3E repository, which provides a suite of Material 3 web components.
+
+## ✨ Features
+
+- **Design Tokens**: Centralized design values for color, typography, shape, and elevation
+- **Primitives**: Reusable elements used to depict elevation, state layer, ripples, and more
+- **Controllers**: Focus, hover, long press, mutation, pressed, and resize behaviors
+- **Mixins**: Easily create new components using behavioral mixins
+- **Accessibility**: ARIA roles, keyboard navigation, and state management
+- **Utilities**: Platform detection, keycode mapping, and layout helpers
+
+## 📦 Installation
+
+```bash
+npm install @m3e/core
+```
+
+## 💻 Editor Integration
+
+This package includes a [Custom Elements Manifest](https://github.com/webcomponents/custom-elements-manifest) to support enhanced editor tooling and developer experience.
+
+### Visual Studio Code
+
+To enable autocomplete and hover documentation for `@m3e/core`, install the [Custom Elements Manifest Language Server](https://marketplace.visualstudio.com/items?itemName=pwrs.cem-language-server-vscode) extension. It will automatically detect the manifest bundled with this package and surface tag names, attributes, slots, and events in supported files.
+
+Alternately, you can explicitly reference the `html-custom-data.json` and `css-custom-data.json` in your workspace settings:
+
+```json
+{
+  "html.customData": ["./node_modules/@m3e/core/dist/html-custom-data.json"],
+  "css.customData": ["./node_modules/@m3e/core/dist/css-custom-data.json"]
+}
+```
+
+## 🚀 Usage
+
+### 🗂️ Entry Points
+
+The following entry points are available as defined in the package's `exports` field:
+
+- `@m3e/core` (default): Main entry point for core exports
+- `@m3e/core/a11y`: Accessibility utilities and primitives
+- `@m3e/core/anchoring`: Anchoring utilities and primitives
+- `@m3e/core/bidi`: Bidirectional text utilities
+- `@m3e/core/layout`: Layout utilities and primitives
+- `@m3e/core/platform`: Platform detection utilities
+
+## 🤝 Contributing
+
+See the root monorepo `CONTRIBUTING.md` for guidelines on contributing to this package.
+
+## 📄 License
+
+This package is licensed under the MIT License.

package/cem.config.mjs

@@ -0,0 +1,16 @@
+import { customElementVsCodePlugin } from "custom-element-vs-code-integration";
+
+export default {
+  globs: ["src/**/*.ts"],
+  exclude: ["src/**/*.spec.ts"],
+  packagejson: true,
+  outdir: "dist",
+  litelement: true,
+  plugins: [
+    customElementVsCodePlugin({
+      outdir: "dist",
+      htmlFileName: "html-custom-data.json",
+      cssFileName: "css-custom-data.json",
+    }),
+  ],
+};

package/demo/index.html

@@ -0,0 +1,58 @@
+<!doctype html>
+<html lang="en" style="overflow-y: auto">
+  <head>
+    <title>Core for M3E</title>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Core for M3E" />
+    <base href="./" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100..900;1,100..900&display=swap"
+      rel="stylesheet"
+    />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0..1,0"
+      rel="stylesheet"
+    />
+    <script type="importmap">
+      {
+        "imports": {
+          "lit": "https://cdn.jsdelivr.net/npm/lit@3.3.0/+esm",
+          "@m3e/core": "../../core/dist/index.min.js"
+        }
+      }
+    </script>
+    <script type="module" src="../../theme/dist/index.min.js"></script>
+    <script type="module" src="../dist/index.min.js"></script>
+    <style>
+      body {
+        font-family: "Roboto";
+      }
+      *:not(:defined) {
+        display: none;
+      }
+    </style>
+  </head>
+  <body>
+    <m3e-theme strong-focus>
+      <div
+        id="div"
+        style="
+          width: 300px;
+          height: 300px;
+          position: relative;
+          outline: none;
+          background-color: var(--md-sys-color-primary-container);
+        "
+        tabindex="0"
+      >
+        <m3e-focus-ring for="div"></m3e-focus-ring>
+        <m3e-elevation for="div" level="3"></m3e-elevation>
+        <m3e-state-layer for="div"></m3e-state-layer>
+        <m3e-ripple for="div"></m3e-ripple>
+      </div>
+    </m3e-theme>
+  </body>
+</html>