release(*): internal release candidate (2025-10-02)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,53 @@
+---
+name: Bug report
+about: Create a report to help us improve
+---
+
+<!-- Step 1 [READ THIS] -->
+<!--
+Are you in the right place?
+  * For issues or feature requests related to __the code in this repository__
+    file a Github issue.
+    * If this is a __feature request__ make sure the issue title starts with "FR:".
+  * For general technical questions, post a question on [StackOverflow](http://stackoverflow.com/)
+    with the firebase-authentication tag.
+  * For general Firebase discussion, use the [firebase-talk](https://groups.google.com/forum/#!forum/firebase-talk)
+    google group.
+  * For help troubleshooting your application that does not fall under one
+    of the above categories, reach out to the personalized
+    [Firebase support channel](https://firebase.google.com/support/).
+-->
+
+<!-- Step 2 -->
+
+### [REQUIRED] Describe your environment
+
+- Operating System version: **\_**
+- Browser version: **\_**
+- Firebase UI version: **\_**
+- Firebase SDK version: **\_**
+- Package name: **\_**
+
+<!-- Step 3 -->
+
+### [REQUIRED] Describe the problem
+
+#### Steps to reproduce
+
+<!--
+  What happened? How can we make the problem occur?
+  This could be a description, log/console output, etc.
+-->
+
+#### Relevant Code
+
+<!--
+  Reproduce the issue on StackBlitz and provide your forked URL
+  or give us some sample code below
+-->
+
+<https://stackblitz.com/fork/firebase-issue-sandbox>
+
+```javascript
+// TODO(you): code here to reproduce the problem
+```

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/lint.yaml

@@ -0,0 +1,35 @@
+name: Lint and Format Check
+
+on:
+  push:
+    branches:
+      - "@invertase/v7-development"
+  pull_request:
+
+jobs:
+  lint:
+    name: Lint and Format Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run ESLint check
+        run: pnpm run lint:check
+
+      - name: Run Prettier check
+        run: pnpm run format:check

.github/workflows/test.yaml

@@ -0,0 +1,51 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - "@invertase/v7-development"
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          check-latest: true
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build packages
+        run: pnpm run build
+
+      - name: Install Firebase CLI
+        run: npm i -g firebase-tools@14.15.2
+
+      - name: Enable webframeworks experiment
+        run: firebase experiments:enable webframeworks
+
+      - name: Start Firebase emulator
+        run: |
+          firebase emulators:start --only auth --project demo-test &
+          sleep 15
+          # Wait for emulator to be ready
+          until wget -q --spider http://localhost:9099 2>/dev/null; do
+            echo "Waiting for emulator to start..."
+            sleep 2
+          done
+          echo "Emulator is ready"
+
+      - name: Run tests
+        run: pnpm test

.gitignore

@@ -12,6 +12,19 @@ dist
 dist-ssr
 *.local
 
+# Angular
+.angular
+.firebase
+
+# Next.js
+.next
+
+# Coverage
+coverage
+
+# Firebase
+.firebase
+
 # Editor directories and files
 .vscode/*
 !.vscode/extensions.json

.opensource/project.json

@@ -1,19 +1,13 @@
 {
-    "name": "FirebaseUI for Web",
-
-    "platforms": [
-      "Web"
-    ],
-
-    "content": "README.md",
+  "name": "FirebaseUI for Web",
 
-    "pages" : {
-        "LANGUAGES.md": "Supported Languages"
-    },
-  
-    "related": [
-      "firebase/firebaseui-android",
-      "firebase/firebaseui-ios",
-      "firebase/firebaseui-web-react"
-    ]
+  "platforms": ["Web"],
+
+  "content": "README.md",
+
+  "pages": {
+    "LANGUAGES.md": "Supported Languages"
+  },
+
+  "related": ["firebase/firebaseui-android", "firebase/firebaseui-ios", "firebase/firebaseui-web-react"]
 }

.prettierignore

@@ -0,0 +1,23 @@
+# Dependencies
+node_modules/
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Build outputs
+dist/
+build/
+.angular/
+releases/
+
+# Generated files
+*.min.js
+*.min.css
+packages/styles/dist.css
+
+# Logs
+*.log
+
+# OS generated files
+.DS_Store
+Thumbs.db

packages/firebaseui-core/.prettierrc → .prettierrc

@@ -1,8 +1,9 @@
 {
   "semi": true,
   "trailingComma": "es5",
-  "singleQuote": true,
+  "singleQuote": false,
   "printWidth": 120,
   "tabWidth": 2,
-  "useTabs": false
+  "useTabs": false,
+  "endOfLine": "auto"
 }

CONTRIBUTING.md

@@ -1,6 +1,118 @@
 Want to contribute? Great! First, read this page (including the small print at
 the end).
 
+## Setup
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) (version 18 or higher recommended)
+- [pnpm](https://pnpm.io/) - This workspace uses pnpm for package management
+
+### Installation
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/firebase/firebaseui-web.git
+   cd firebaseui-web
+   ```
+
+2. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+### Development Workflow
+
+This is a monorepo managed with pnpm, containing both `packages` and `examples` sub-directories.
+
+#### Building
+
+Build all packages:
+```bash
+pnpm build
+```
+
+Build only the packages (excluding examples):
+```bash
+pnpm build:packages
+```
+
+#### Testing
+
+Run all tests:
+```bash
+pnpm test
+```
+
+Run tests in watch mode:
+```bash
+pnpm test:watch
+```
+
+Run tests for a specific package:
+```bash
+pnpm --filter=<package-name> run test
+```
+
+#### Linting and Formatting
+
+Check for linting errors:
+```bash
+pnpm lint:check
+```
+
+Fix linting errors automatically:
+```bash
+pnpm lint:fix
+```
+
+Check for formatting issues:
+```bash
+pnpm format:check
+```
+
+Format code automatically:
+```bash
+pnpm format:write
+```
+
+### Project Structure
+
+The project is organized as follows:
+
+- **`packages/`**: Framework-agnostic and framework-specific packages
+  - `core`: Framework-agnostic core package providing `initializeUI` and authentication functions
+  - `translations`: Translation utilities and locale mappings
+  - `styles`: CSS utility classes and compiled styles
+  - `react`: React components and hooks
+  - `angular`: Angular components and DI functionality
+  - `shadcn`: Shadcn UI components
+
+- **`examples/`**: Example applications demonstrating usage
+  - `react`: React example
+  - `nextjs`: Next.js example
+  - `nextjs-ssr`: Next.js SSR example
+  - `angular`: Angular example
+  - `shadcn`: Shadcn example
+
+The dependency graph:
+```
+core → translations
+react → core
+angular → core
+react → styles
+angular → styles
+shadcn → react
+```
+
+### Additional Notes
+
+- All packages extend the same base `tsconfig.json` file
+- Vitest is the preferred testing framework
+- The workspace uses pnpm catalogs to ensure dependency version alignment
+- Linting is controlled by ESLint via a root flatconfig `eslint.config.ts` file
+- Formatting is controlled by Prettier integrated with ESLint via the `.prettierrc` file
+
 ### Before you contribute
 
 Before we can use your code, you must sign the [Google Individual Contributor